@overkill-dev/resources 0.0.2 → 0.0.4

package/package.json

@@ -21,13 +21,17 @@
     ],
     "license": "MIT",
     "name": "@overkill-dev/resources",
+    "peerDependencies": {
+        "@overkill-dev/simulation": "0.0.3"
+    },
     "repository": {
         "type": "git",
         "url": "git+https://github.com/enormora/overkill.git"
     },
     "sideEffects": [
-        "./packages/resources/resources.entry-point.js"
+        "./packages/resources/resources.entry-point.js",
+        "./resources/local-service-resource.js"
     ],
     "type": "module",
-    "version": "0.0.2"
+    "version": "0.0.4"
 }

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

@@ -1,16 +1,24 @@
 import { type ResourcesModule } from '../../resources/resources.ts';
+export { defineLocalServiceResource } from '../../resources/local-service-resource.ts';
+export { createLocalHttpServiceResource } from '../../resources/local-http-service-resource.ts';
+export { createLocalProcessServiceResource } from '../../resources/local-process-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, LocalServiceAddressRequest, LocalServiceCreationContext, LocalServiceDisposalContext, LocalServiceHostAddressRequest, LocalServiceLoopbackAddressRequest, LocalServiceResourceDefinitionInput, LocalOnlyLocalServiceResourceDefinitionInput, ProjectedLocalServiceResourceDefinitionInput } from '../../resources/local-service-resource.ts';
+export type { LocalHttpServiceHandle, LocalHttpServiceResourceInput } from '../../resources/local-http-service-resource.ts';
+export type { LocalProcessCommand, LocalProcessOutput, LocalProcessOutputBuffer, LocalProcessOwner, LocalProcessServiceResourceInput, LocalProcessShutdown, LocalProcessSignal } from '../../resources/local-process-service-resource.ts';
+export type { SimulatedHttpServerResource, SimulatedHttpServerResourceHandle, 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';

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

@@ -1 +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"}
+{"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,EACH,0BAA0B,EAC7B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACH,8BAA8B,EACjC,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACH,iCAAiC,EACpC,MAAM,mDAAmD,CAAC;AAY3D,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,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,kCAAkC,EAClC,mCAAmC,EACnC,4CAA4C,EAC5C,4CAA4C,EAC/C,MAAM,2CAA2C,CAAC;AACnD,YAAY,EACR,sBAAsB,EACtB,6BAA6B,EAChC,MAAM,gDAAgD,CAAC;AACxD,YAAY,EACR,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,gCAAgC,EAChC,oBAAoB,EACpB,kBAAkB,EACrB,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EACR,2BAA2B,EAC3B,iCAAiC,EACjC,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

@@ -2,6 +2,9 @@ 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";
+export { createLocalHttpServiceResource } from "../../resources/local-http-service-resource.js";
+export { createLocalProcessServiceResource } from "../../resources/local-process-service-resource.js";
 const resourcesModule = createResourcesModule({
     temporaryDirectoryPathPrefix: join(tmpdir(), 'overkill-temporary-directory-'),
     async createTemporaryDirectory(pathPrefix) {
@@ -17,6 +20,7 @@ export const createTemporaryDirectoryResource = resourcesModule.createTemporaryD
 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";

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

@@ -1 +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"}
+{"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,EACH,0BAA0B,EAC7B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACH,8BAA8B,EACjC,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACH,iCAAiC,EACpC,MAAM,mDAAmD,CAAC;AAE3D,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

@@ -11,6 +11,7 @@ callback.
 import {
     composeRuntimeContext,
     composeRuntimes,
+    createLocalHttpServiceResource,
     createTemporaryDirectoryResource,
     defineResource,
     defineRuntime,
@@ -48,6 +49,23 @@ const server = defineResource({
     }
 });
 
+const app = createLocalHttpServiceResource({
+    name: 'app',
+    scope: 'per-case',
+    requirements: [],
+    dependencies: { database },
+    address: { kind: 'loopback', port: 0 },
+    createServer(context) {
+        return createAppServer({ database: context.dependencies.database });
+    },
+    handle(service) {
+        return { baseUrl: service.baseUrl };
+    },
+    dispose() {
+        return undefined;
+    }
+});
+
 const scratch = createTemporaryDirectoryResource('scratch');
 const sharedDatabase = defineResource({
     name: 'shared-database',
@@ -71,7 +89,7 @@ const sharedDatabase = defineResource({
 const runtime = defineRuntime({
     name: 'api',
     dimensions: {},
-    resources: { database, server, scratch },
+    resources: { app, database, server, scratch },
     requirements: [ { kind: 'startup-budget-milliseconds', minimumMilliseconds: 1000 } ]
 });
 
@@ -104,6 +122,28 @@ Omitting `dependencies` is accepted for compatibility and produces
 whose handle is `{ readonly path: string }`. Each acquisition creates a unique
 directory with an Overkill prefix. Disposal removes that directory recursively.
 
+`defineLocalServiceResource(...)` models owned local services with explicit
+`start`, `ready`, and `dispose` phases. Callers declare scope, requirements,
+dependencies, and an explicit address request such as
+`{ kind: 'loopback', port: 0 }`. `start` owns the service internals, `ready`
+returns the object handle exposed to tests, and `dispose` receives only the
+owner state. If readiness fails, the owner is disposed before acquisition
+fails. Projected scopes use the same serialize and deserialize rules as
+ordinary resources.
+
+`createLocalHttpServiceResource(...)` owns HTTP `listen` and `close`, exposes
+the actual loopback endpoint and `baseUrl`, and lets callers map that into a
+typed object handle. `createLocalProcessServiceResource(...)` starts a child
+process, drains bounded stdout/stderr lifecycle buffers, waits for explicit
+readiness, and terminates then force-kills during disposal according to the
+declared shutdown contract. Output buffers are lifecycle diagnostics, not
+artifacts.
+
+`createSimulatedHttpServerResource({ simulation, address })` 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.

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

@@ -0,0 +1,49 @@
+import type { Awaitable, ExecutionRequirement, ResourceDefinition, ResourceDependencies, ResourceProjectionPayload, ResourceScope } from './resources.ts';
+import { type LocalServiceAddressRequest, type LocalServiceConsumerHandle, type LocalServiceCreationContext, type LocalServiceDisposalContext, type LocalServiceHandleProjection, type LocalServiceAddress, type ProjectedLocalServiceScope } from './local-service-resource.ts';
+export type LocalHttpServiceHandle = {
+    readonly baseUrl: string;
+    readonly endpoint: LocalServiceAddress;
+};
+type LocalHttpServerAddress = {
+    readonly port: number;
+};
+export type LocalHttpServer = {
+    readonly address: () => LocalHttpServerAddress | string | null;
+    readonly close: (callback: (error?: Error) => void) => unknown;
+    readonly listen: (port: number, host: string) => unknown;
+    readonly listening: boolean;
+    readonly off: {
+        (event: 'error', listener: (error: Error) => void): unknown;
+        (event: 'listening', listener: () => void): unknown;
+    };
+    readonly once: {
+        (event: 'error', listener: (error: Error) => void): unknown;
+        (event: 'listening', listener: () => void): unknown;
+    };
+};
+export type LocalHttpServiceResourceInput<Name extends string, ConsumerHandle extends LocalServiceConsumerHandle, Scope extends ResourceScope, Dependencies extends ResourceDependencies> = {
+    readonly address: LocalServiceAddressRequest;
+    readonly createServer: (context: LocalServiceCreationContext<Dependencies>) => LocalHttpServer;
+    readonly dependencies: Dependencies;
+    readonly dispose: (server: LocalHttpServer, context: LocalServiceDisposalContext<Dependencies>) => Awaitable<void>;
+    readonly handle: (service: LocalHttpServiceHandle, server: LocalHttpServer, context: LocalServiceCreationContext<Dependencies>) => ConsumerHandle;
+    readonly name: Name;
+    readonly requirements: readonly ExecutionRequirement[];
+    readonly scope: Scope;
+};
+type ProjectedHttpServiceInput<Name extends string, ConsumerHandle extends LocalServiceConsumerHandle, Projection extends ResourceProjectionPayload, ProjectedConsumerHandle, Dependencies extends ResourceDependencies> = {
+    readonly address: LocalServiceAddressRequest;
+    readonly createServer: LocalHttpServiceResourceInput<Name, ConsumerHandle, ProjectedLocalServiceScope, Dependencies>['createServer'];
+    readonly dependencies: Dependencies;
+    readonly deserializeHandle: LocalServiceHandleProjection<ConsumerHandle, Projection, ProjectedConsumerHandle, Dependencies>['deserializeHandle'];
+    readonly dispose: LocalHttpServiceResourceInput<Name, ConsumerHandle, ProjectedLocalServiceScope, Dependencies>['dispose'];
+    readonly handle: LocalHttpServiceResourceInput<Name, ConsumerHandle, ProjectedLocalServiceScope, Dependencies>['handle'];
+    readonly name: Name;
+    readonly requirements: readonly ExecutionRequirement[];
+    readonly scope: ProjectedLocalServiceScope;
+    readonly serializeHandle: LocalServiceHandleProjection<ConsumerHandle, Projection, ProjectedConsumerHandle, Dependencies>['serializeHandle'];
+};
+export declare function createLocalHttpServiceResource<const Name extends string, ConsumerHandle extends LocalServiceConsumerHandle, Scope extends Exclude<ResourceScope, 'per-run'>, const Dependencies extends ResourceDependencies>(input: LocalHttpServiceResourceInput<Name, ConsumerHandle, Scope, Dependencies>): ResourceDefinition<Name, ConsumerHandle, Dependencies>;
+export declare function createLocalHttpServiceResource<const Name extends string, ConsumerHandle extends LocalServiceConsumerHandle, Projection extends ResourceProjectionPayload, ProjectedConsumerHandle, const Dependencies extends ResourceDependencies>(input: ProjectedHttpServiceInput<Name, ConsumerHandle, Projection, ProjectedConsumerHandle, Dependencies>): ResourceDefinition<Name, ConsumerHandle, Dependencies, ProjectedConsumerHandle>;
+export {};
+//# sourceMappingURL=local-http-service-resource.d.ts.map

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

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

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

@@ -0,0 +1,92 @@
+import { defineLocalServiceResource, isProjectedLocalServiceScope } from "./local-service-resource.js";
+function serverEndpoint(server, host) {
+    const address = server.address();
+    if (typeof address !== 'object' || address === null) {
+        throw new TypeError('Local HTTP service did not expose a TCP address.');
+    }
+    return Object.freeze({
+        host,
+        port: address.port
+    });
+}
+async function listen(server, address) {
+    await new Promise(function startListening(resolve, reject) {
+        const listener = {
+            reject(error) {
+                server.off('listening', listener.resolve);
+                reject(error);
+            },
+            resolve() {
+                server.off('error', listener.reject);
+                resolve();
+            }
+        };
+        server.once('error', listener.reject);
+        server.once('listening', listener.resolve);
+        server.listen(address.port, address.host);
+    });
+}
+async function closeServer(server) {
+    if (!server.listening) {
+        return;
+    }
+    await new Promise(function close(resolve, reject) {
+        server.close(function finish(error) {
+            if (error === undefined) {
+                resolve();
+            }
+            else {
+                reject(error);
+            }
+        });
+    });
+}
+function localHttpServiceHandle(endpoint) {
+    return Object.freeze({
+        endpoint,
+        baseUrl: `http://${endpoint.host}:${endpoint.port}`
+    });
+}
+function localHttpDefinition(input) {
+    return {
+        name: input.name,
+        scope: input.scope,
+        requirements: input.requirements,
+        dependencies: input.dependencies,
+        address: input.address,
+        start(context) {
+            return input.createServer(context);
+        },
+        async ready(server, context) {
+            await listen(server, context.address);
+            return input.handle(localHttpServiceHandle(serverEndpoint(server, context.address.host)), server, context);
+        },
+        async dispose(server, context) {
+            await closeServer(server);
+            await input.dispose(server, context);
+        }
+    };
+}
+function projectedHttpDefinition(input) {
+    return {
+        ...localHttpDefinition(input),
+        serializeHandle: input.serializeHandle,
+        deserializeHandle: input.deserializeHandle
+    };
+}
+function assertProjectedHttpService(input) {
+    if (input.serializeHandle === undefined || input.deserializeHandle === undefined) {
+        throw new TypeError('Projected local HTTP services require handle projection callbacks.');
+    }
+}
+export function createLocalHttpServiceResource(input) {
+    if (isProjectedLocalServiceScope(input.scope)) {
+        assertProjectedHttpService(input);
+        return defineLocalServiceResource(projectedHttpDefinition(input));
+    }
+    return defineLocalServiceResource({
+        ...localHttpDefinition(input),
+        scope: input.scope
+    });
+}
+//# sourceMappingURL=local-http-service-resource.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-http-service-resource.js","sourceRoot":"","sources":["../../../../source/resources/local-http-service-resource.ts"],"names":[],"mappings":"AAQA,OAAO,EACH,0BAA0B,EAC1B,4BAA4B,EAS/B,MAAM,6BAA6B,CAAC;AAuJrC,SAAS,cAAc,CAAC,MAAwC,EAAE,IAAY;IAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IAEjC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,IAAI;QACJ,IAAI,EAAE,OAAO,CAAC,IAAI;KACrB,CAAC,CAAC;AACP,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,MAAuB,EAAE,OAA4B;IACvE,MAAM,IAAI,OAAO,CAAO,SAAS,cAAc,CAAC,OAAO,EAAE,MAAM;QAC3D,MAAM,QAAQ,GAAG;YACb,MAAM,CAAC,KAAY;gBACf,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC1C,MAAM,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YACD,OAAO;gBACH,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACrC,OAAO,EAAE,CAAC;YACd,CAAC;SACJ,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACP,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,MAAuB;IAC9C,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO;IACX,CAAC;IAED,MAAM,IAAI,OAAO,CAAO,SAAS,KAAK,CAAC,OAAO,EAAE,MAAM;QAClD,MAAM,CAAC,KAAK,CAAC,SAAS,MAAM,CAAC,KAAK;YAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACtB,OAAO,EAAE,CAAC;YACd,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,sBAAsB,CAAC,QAA6B;IACzD,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,QAAQ;QACR,OAAO,EAAE,UAAU,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE;KACtD,CAAC,CAAC;AACP,CAAC;AAED,SAAS,mBAAmB,CAMxB,KAA+E;IAE/E,OAAO;QACH,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,CAAC,OAAkD;YACpD,OAAO,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,MAAuB,EAAE,OAAkD;YACnF,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAEtC,OAAO,KAAK,CAAC,MAAM,CACf,sBAAsB,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EACpE,MAAM,EACN,OAAO,CACV,CAAC;QACN,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,MAAuB,EAAE,OAAkD;YACrF,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;YAC1B,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;KACJ,CAAC;AACN,CAAC;AAED,SAAS,uBAAuB,CAO5B,KAMC;IAUD,OAAO;QACH,GAAG,mBAAmB,CAAC,KAAK,CAAC;QAC7B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;KAC7C,CAAC;AACN,CAAC;AAED,SAAS,0BAA0B,CAM/B,KAMC;IAQD,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC/E,MAAM,IAAI,SAAS,CAAC,oEAAoE,CAAC,CAAC;IAC9F,CAAC;AACL,CAAC;AAyBD,MAAM,UAAU,8BAA8B,CAO1C,KAMC;IAED,IAAI,4BAA4B,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,0BAA0B,CAAC,KAAK,CAAC,CAAC;QAElC,OAAO,0BAA0B,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,0BAA0B,CAAC;QAC9B,GAAG,mBAAmB,CAAC,KAAK,CAAC;QAC7B,KAAK,EAAE,KAAK,CAAC,KAAK;KACrB,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,60 @@
+import type { Awaitable, ExecutionRequirement, ResourceDefinition, ResourceDependencies, ResourceProjectionPayload, ResourceScope } from './resources.ts';
+import { type LocalServiceAddressRequest, type LocalServiceConsumerHandle, type LocalServiceCreationContext, type LocalServiceHandleProjection, type ProjectedLocalServiceScope } from './local-service-resource.ts';
+export type LocalProcessOutputBuffer = {
+    readonly bytes: () => Uint8Array;
+    readonly text: () => string;
+};
+export type LocalProcessOutput = {
+    readonly stderr: LocalProcessOutputBuffer;
+    readonly stdout: LocalProcessOutputBuffer;
+};
+export type LocalProcessCommand = {
+    readonly arguments: readonly string[];
+    readonly command: string;
+    readonly environment: Readonly<Record<string, string>>;
+    readonly workingDirectory: string | null;
+};
+export type LocalProcessSignal = 'SIGHUP' | 'SIGINT' | 'SIGKILL' | 'SIGTERM' | 'SIGUSR1' | 'SIGUSR2';
+export type LocalProcessShutdown = {
+    readonly forceSignal: LocalProcessSignal;
+    readonly graceMilliseconds: number;
+    readonly gracefulSignal: LocalProcessSignal;
+};
+type LocalProcessChild = {
+    readonly exitCode: number | null;
+    readonly kill: (signal: LocalProcessSignal) => boolean;
+    readonly once: (event: 'error' | 'exit', listener: ((code: number | null, signal: string | null) => void) | ((error: Error) => void)) => unknown;
+    readonly signalCode: string | null;
+};
+export type LocalProcessOwner = {
+    readonly child: LocalProcessChild;
+    readonly output: LocalProcessOutput;
+};
+export type LocalProcessServiceResourceInput<Name extends string, ConsumerHandle extends LocalServiceConsumerHandle, Scope extends ResourceScope, Dependencies extends ResourceDependencies> = {
+    readonly address: LocalServiceAddressRequest;
+    readonly command: (context: LocalServiceCreationContext<Dependencies>) => Awaitable<LocalProcessCommand>;
+    readonly dependencies: Dependencies;
+    readonly name: Name;
+    readonly outputBufferBytes: number;
+    readonly ready: (owner: LocalProcessOwner, context: LocalServiceCreationContext<Dependencies>) => Awaitable<ConsumerHandle>;
+    readonly requirements: readonly ExecutionRequirement[];
+    readonly scope: Scope;
+    readonly shutdown: LocalProcessShutdown;
+};
+type ProjectedProcessServiceInput<Name extends string, ConsumerHandle extends LocalServiceConsumerHandle, Projection extends ResourceProjectionPayload, ProjectedConsumerHandle, Dependencies extends ResourceDependencies> = {
+    readonly address: LocalServiceAddressRequest;
+    readonly command: LocalProcessServiceResourceInput<Name, ConsumerHandle, ProjectedLocalServiceScope, Dependencies>['command'];
+    readonly dependencies: Dependencies;
+    readonly deserializeHandle: LocalServiceHandleProjection<ConsumerHandle, Projection, ProjectedConsumerHandle, Dependencies>['deserializeHandle'];
+    readonly name: Name;
+    readonly outputBufferBytes: number;
+    readonly ready: LocalProcessServiceResourceInput<Name, ConsumerHandle, ProjectedLocalServiceScope, Dependencies>['ready'];
+    readonly requirements: readonly ExecutionRequirement[];
+    readonly scope: ProjectedLocalServiceScope;
+    readonly serializeHandle: LocalServiceHandleProjection<ConsumerHandle, Projection, ProjectedConsumerHandle, Dependencies>['serializeHandle'];
+    readonly shutdown: LocalProcessShutdown;
+};
+export declare function createLocalProcessServiceResource<const Name extends string, ConsumerHandle extends LocalServiceConsumerHandle, Scope extends Exclude<ResourceScope, 'per-run'>, const Dependencies extends ResourceDependencies>(input: LocalProcessServiceResourceInput<Name, ConsumerHandle, Scope, Dependencies>): ResourceDefinition<Name, ConsumerHandle, Dependencies>;
+export declare function createLocalProcessServiceResource<const Name extends string, ConsumerHandle extends LocalServiceConsumerHandle, Projection extends ResourceProjectionPayload, ProjectedConsumerHandle, const Dependencies extends ResourceDependencies>(input: ProjectedProcessServiceInput<Name, ConsumerHandle, Projection, ProjectedConsumerHandle, Dependencies>): ResourceDefinition<Name, ConsumerHandle, Dependencies, ProjectedConsumerHandle>;
+export {};
+//# sourceMappingURL=local-process-service-resource.d.ts.map

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

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

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

@@ -0,0 +1,146 @@
+import { spawn } from 'node:child_process';
+import { setTimeout as wait } from 'node:timers/promises';
+import { defineLocalServiceResource, isProjectedLocalServiceScope } from "./local-service-resource.js";
+function createBoundedOutputBuffer(maxBytes) {
+    let value = Buffer.alloc(0);
+    return {
+        append(chunk) {
+            value = Buffer.concat([value, chunk]);
+            if (value.byteLength > maxBytes) {
+                value = value.subarray(value.byteLength - maxBytes);
+            }
+        },
+        buffer: Object.freeze({
+            bytes() {
+                return new Uint8Array(value);
+            },
+            text() {
+                return value.toString('utf8');
+            }
+        })
+    };
+}
+function localProcessOutput(maxBytes) {
+    const stdout = createBoundedOutputBuffer(maxBytes);
+    const stderr = createBoundedOutputBuffer(maxBytes);
+    return {
+        appendStderr: stderr.append,
+        appendStdout: stdout.append,
+        output: Object.freeze({
+            stderr: stderr.buffer,
+            stdout: stdout.buffer
+        })
+    };
+}
+function attachOutputDrains(child, output) {
+    if (child.stdout === null || child.stderr === null) {
+        throw new TypeError('Local process service requires piped stdout and stderr.');
+    }
+    child.stdout.on('data', output.appendStdout);
+    child.stderr.on('data', output.appendStderr);
+}
+function spawnLocalProcess(command, output) {
+    const child = spawn(command.command, command.arguments, {
+        cwd: command.workingDirectory ?? process.cwd(),
+        env: command.environment,
+        stdio: ['ignore', 'pipe', 'pipe']
+    });
+    attachOutputDrains(child, output);
+    return child;
+}
+async function processExitFailure(owner) {
+    return await new Promise(function rejectOnProcessExit(_resolve, reject) {
+        owner.child.once('error', reject);
+        owner.child.once('exit', function rejectEarlyExit(code, signal) {
+            reject(new Error([
+                `Local process service exited before readiness: code ${String(code)}, signal ${String(signal)}.`,
+                owner.output.stderr.text()
+            ]
+                .filter(Boolean)
+                .join('\n')));
+        });
+    });
+}
+async function readyLocalProcess(owner, context, input) {
+    return await Promise.race([
+        input.ready(owner, context),
+        processExitFailure(owner)
+    ]);
+}
+async function waitForProcessExit(child) {
+    if (child.exitCode !== null || child.signalCode !== null) {
+        return;
+    }
+    await new Promise(function resolveOnExit(resolve) {
+        child.once('exit', function resolveExit() {
+            resolve();
+        });
+    });
+}
+async function disposeLocalProcess(owner, shutdown) {
+    if (owner.child.exitCode !== null || owner.child.signalCode !== null) {
+        return;
+    }
+    owner.child.kill(shutdown.gracefulSignal);
+    const exited = waitForProcessExit(owner.child);
+    const result = await Promise.race([exited, wait(shutdown.graceMilliseconds, 'delay')]);
+    if (result === 'delay') {
+        owner.child.kill(shutdown.forceSignal);
+        await waitForProcessExit(owner.child);
+    }
+}
+function assertProcessInput(input) {
+    if (!Number.isSafeInteger(input.outputBufferBytes) || input.outputBufferBytes < 0) {
+        throw new TypeError('Local process service outputBufferBytes must be a non-negative integer.');
+    }
+    if (!Number.isSafeInteger(input.shutdown.graceMilliseconds) || input.shutdown.graceMilliseconds < 0) {
+        throw new TypeError('Local process service shutdown.graceMilliseconds must be a non-negative integer.');
+    }
+}
+function localProcessDefinition(input) {
+    return {
+        name: input.name,
+        scope: input.scope,
+        requirements: input.requirements,
+        dependencies: input.dependencies,
+        address: input.address,
+        async start(context) {
+            const command = await input.command(context);
+            const output = localProcessOutput(input.outputBufferBytes);
+            return Object.freeze({
+                child: spawnLocalProcess(command, output),
+                output: output.output
+            });
+        },
+        async ready(owner, context) {
+            return await readyLocalProcess(owner, context, input);
+        },
+        async dispose(owner) {
+            await disposeLocalProcess(owner, input.shutdown);
+        }
+    };
+}
+function projectedProcessDefinition(input) {
+    return {
+        ...localProcessDefinition(input),
+        serializeHandle: input.serializeHandle,
+        deserializeHandle: input.deserializeHandle
+    };
+}
+function assertProjectedProcessService(input) {
+    if (input.serializeHandle === undefined || input.deserializeHandle === undefined) {
+        throw new TypeError('Projected local process services require handle projection callbacks.');
+    }
+}
+export function createLocalProcessServiceResource(input) {
+    assertProcessInput(input);
+    if (isProjectedLocalServiceScope(input.scope)) {
+        assertProjectedProcessService(input);
+        return defineLocalServiceResource(projectedProcessDefinition(input));
+    }
+    return defineLocalServiceResource({
+        ...localProcessDefinition(input),
+        scope: input.scope
+    });
+}
+//# sourceMappingURL=local-process-service-resource.js.map

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

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

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

@@ -0,0 +1,66 @@
+import { type Awaitable, type EmptyResourceDependencies, type ExecutionRequirement, type ResourceContext, type ResourceDefinition, type ResourceDependencies, type ResourceProjectionContext, type ResourceProjectionPayload, type ResourceScope } from './resources.ts';
+import type { ValueOf } from './resource-definition-shape.ts';
+export type LocalServiceLoopbackAddressRequest = {
+    readonly kind: 'loopback';
+    readonly port: number;
+};
+export type LocalServiceHostAddressRequest = {
+    readonly host: string;
+    readonly kind: 'host';
+    readonly port: number;
+};
+export type LocalServiceAddressRequest = LocalServiceHostAddressRequest | LocalServiceLoopbackAddressRequest;
+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;
+};
+export type LocalServiceDisposalContext<Dependencies extends ResourceDependencies = EmptyResourceDependencies> = {
+    readonly address: LocalServiceAddress;
+    readonly dependencies: ResourceContext<Dependencies>;
+    readonly signal: AbortSignal;
+};
+export type LocalServiceConsumerHandle = Readonly<Partial<Record<PropertyKey, unknown>>>;
+export type ProjectedLocalServiceScope = 'per-file' | 'per-run' | 'per-suite';
+export type LocalServiceHandleProjection<ConsumerHandle extends LocalServiceConsumerHandle, Projection extends ResourceProjectionPayload, ProjectedConsumerHandle, Dependencies extends ResourceDependencies> = {
+    readonly deserializeHandle: (payload: Projection, context: ResourceProjectionContext<Dependencies>) => ProjectedConsumerHandle;
+    readonly serializeHandle: (handle: ConsumerHandle, context: ResourceProjectionContext<Dependencies>) => Projection;
+};
+type LocalServiceDefinitionDisposal<OwnerHandle, Dependencies extends ResourceDependencies> = {
+    readonly dispose: (owner: OwnerHandle, context: LocalServiceDisposalContext<Dependencies>) => Awaitable<void>;
+};
+type LocalServiceResourceDefinitionBaseInput<Name extends string, OwnerHandle, ConsumerHandle extends LocalServiceConsumerHandle, Scope extends ResourceScope, Dependencies extends ResourceDependencies> = LocalServiceDefinitionDisposal<OwnerHandle, Dependencies> & {
+    readonly address: LocalServiceAddressRequest;
+    readonly dependencies: Dependencies;
+    readonly name: Name;
+    readonly ready: (owner: OwnerHandle, context: LocalServiceCreationContext<Dependencies>) => Awaitable<ConsumerHandle>;
+    readonly requirements: readonly ExecutionRequirement[];
+    readonly scope: Scope;
+    readonly start: (context: LocalServiceCreationContext<Dependencies>) => Awaitable<OwnerHandle>;
+};
+export type LocalOnlyLocalServiceResourceDefinitionInput<Name extends string, OwnerHandle, ConsumerHandle extends LocalServiceConsumerHandle, Scope extends Exclude<ResourceScope, 'per-run'>, Dependencies extends ResourceDependencies = EmptyResourceDependencies> = LocalServiceResourceDefinitionBaseInput<Name, OwnerHandle, ConsumerHandle, Scope, Dependencies>;
+export type ProjectedLocalServiceResourceDefinitionInput<Name extends string, OwnerHandle, ConsumerHandle extends LocalServiceConsumerHandle, Projection extends ResourceProjectionPayload, ProjectedConsumerHandle, Scope extends ProjectedLocalServiceScope, Dependencies extends ResourceDependencies = EmptyResourceDependencies> = {
+    readonly address: LocalServiceAddressRequest;
+    readonly dependencies: Dependencies;
+    readonly deserializeHandle: LocalServiceHandleProjection<ConsumerHandle, Projection, ProjectedConsumerHandle, Dependencies>['deserializeHandle'];
+    readonly dispose: LocalServiceDefinitionDisposal<OwnerHandle, Dependencies>['dispose'];
+    readonly name: Name;
+    readonly ready: (owner: OwnerHandle, context: LocalServiceCreationContext<Dependencies>) => Awaitable<ConsumerHandle>;
+    readonly requirements: readonly ExecutionRequirement[];
+    readonly scope: Scope;
+    readonly serializeHandle: LocalServiceHandleProjection<ConsumerHandle, Projection, ProjectedConsumerHandle, Dependencies>['serializeHandle'];
+    readonly start: (context: LocalServiceCreationContext<Dependencies>) => Awaitable<OwnerHandle>;
+};
+export type LocalServiceResourceDefinitionInput<Name extends string, OwnerHandle, ConsumerHandle extends LocalServiceConsumerHandle, Dependencies extends ResourceDependencies = EmptyResourceDependencies, Projection extends ResourceProjectionPayload = ResourceProjectionPayload, ProjectedConsumerHandle = ConsumerHandle> = ValueOf<{
+    readonly local: LocalOnlyLocalServiceResourceDefinitionInput<Name, OwnerHandle, ConsumerHandle, Exclude<ResourceScope, 'per-run'>, Dependencies>;
+    readonly projected: ProjectedLocalServiceResourceDefinitionInput<Name, OwnerHandle, ConsumerHandle, Projection, ProjectedConsumerHandle, ProjectedLocalServiceScope, Dependencies>;
+}>;
+export declare function isProjectedLocalServiceScope(scope: ResourceScope): scope is ProjectedLocalServiceScope;
+export declare function defineLocalServiceResource<const Name extends string, OwnerHandle, ConsumerHandle extends LocalServiceConsumerHandle, Scope extends Exclude<ResourceScope, 'per-run'>, const Dependencies extends ResourceDependencies>(definition: LocalOnlyLocalServiceResourceDefinitionInput<Name, OwnerHandle, ConsumerHandle, Scope, Dependencies>): ResourceDefinition<Name, ConsumerHandle, Dependencies>;
+export declare function defineLocalServiceResource<const Name extends string, OwnerHandle, ConsumerHandle extends LocalServiceConsumerHandle, Projection extends ResourceProjectionPayload, ProjectedConsumerHandle, Scope extends ProjectedLocalServiceScope, const Dependencies extends ResourceDependencies>(definition: ProjectedLocalServiceResourceDefinitionInput<Name, OwnerHandle, ConsumerHandle, Projection, ProjectedConsumerHandle, Scope, Dependencies>): ResourceDefinition<Name, ConsumerHandle, Dependencies, ProjectedConsumerHandle>;
+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,122 @@
+import { defineResource } from "./resources.js";
+const localServiceAcquireFailures = new WeakMap();
+function localServiceAcquireFailureError(failure) {
+    const error = new Error('Local service acquisition failed.', { cause: failure.cause });
+    localServiceAcquireFailures.set(error, failure);
+    return error;
+}
+function localServiceAddress(request) {
+    return Object.freeze({
+        host: request.kind === 'loopback' ? '127.0.0.1' : request.host,
+        port: request.port
+    });
+}
+export function isProjectedLocalServiceScope(scope) {
+    return ['per-file', 'per-run', 'per-suite'].includes(scope);
+}
+function internalCleanupSignal() {
+    const controller = new AbortController();
+    return controller.signal;
+}
+function resourceAcquireFailure(cause, cleanupError) {
+    return { cause, cleanupError };
+}
+function lifecycleError(failure) {
+    return failure.cleanupError === null
+        ? failure.cause
+        : new AggregateError([failure.cause, failure.cleanupError], 'Local service acquisition cleanup failed.');
+}
+async function cleanupStartedService(owner, definition, context) {
+    try {
+        await definition.dispose(owner, {
+            address: context.address,
+            dependencies: context.dependencies,
+            signal: internalCleanupSignal()
+        });
+        return null;
+    }
+    catch (error) {
+        return error;
+    }
+}
+function serviceContext(context, address) {
+    return Object.freeze({
+        ...context,
+        address
+    });
+}
+async function acquireReadyHandle(definition, context) {
+    context.signal.throwIfAborted();
+    const owner = await definition.start(context);
+    try {
+        context.signal.throwIfAborted();
+        const consumer = await definition.ready(owner, context);
+        context.signal.throwIfAborted();
+        return [owner, consumer];
+    }
+    catch (error) {
+        throw localServiceAcquireFailureError(resourceAcquireFailure(error, await cleanupStartedService(owner, definition, context)));
+    }
+}
+function localServiceAcquire(definition, address, owners) {
+    return async function startLocalService(context) {
+        try {
+            const [owner, consumer] = await acquireReadyHandle(definition, serviceContext(context, address));
+            owners.set(consumer, owner);
+            return consumer;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                const failure = localServiceAcquireFailures.get(error);
+                if (failure !== undefined) {
+                    throw lifecycleError(failure);
+                }
+            }
+            throw error;
+        }
+    };
+}
+function localServiceDispose(definition, address, owners) {
+    return async function disposeLocalService(handle, context) {
+        const owner = owners.get(handle);
+        if (owner === undefined) {
+            return;
+        }
+        owners.delete(handle);
+        await definition.dispose(owner, {
+            address,
+            dependencies: context.dependencies,
+            signal: context.signal
+        });
+    };
+}
+function isProjectedLocalService(definition) {
+    return Object.hasOwn(definition, 'serializeHandle') && Object.hasOwn(definition, 'deserializeHandle');
+}
+export function defineLocalServiceResource(definition) {
+    const address = localServiceAddress(definition.address);
+    const owners = new WeakMap();
+    const acquire = localServiceAcquire(definition, address, owners);
+    const dispose = localServiceDispose(definition, address, owners);
+    if (isProjectedLocalService(definition)) {
+        return defineResource({
+            name: definition.name,
+            scope: definition.scope,
+            requirements: definition.requirements,
+            dependencies: definition.dependencies,
+            acquire,
+            dispose,
+            serializeHandle: definition.serializeHandle,
+            deserializeHandle: definition.deserializeHandle
+        });
+    }
+    return defineResource({
+        name: definition.name,
+        scope: definition.scope,
+        requirements: definition.requirements,
+        dependencies: definition.dependencies,
+        acquire,
+        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":"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"}

package/resources/simulated-http-server-resource.d.ts

@@ -0,0 +1,21 @@
+import type { SimulatedHttpServerDefinition, SimulationScenarioCatalog } from '@overkill-dev/simulation';
+import type { EmptyResourceDependencies, ResourceDefinition } from './resources.ts';
+import { type LocalHttpServiceHandle } from './local-http-service-resource.ts';
+import type { LocalServiceAddressRequest } from './local-service-resource.ts';
+export type SimulatedHttpServerResourceOptions<Name extends string, Scenarios extends SimulationScenarioCatalog> = {
+    readonly address: LocalServiceAddressRequest;
+    readonly simulation: SimulatedHttpServerDefinition<Name, Scenarios>;
+};
+export type SimulatedHttpServerResourceHandle<Simulation extends {
+    readonly scenarios: SimulationScenarioCatalog;
+}> = {
+    readonly baseUrl: string;
+    readonly endpoint: LocalHttpServiceHandle['endpoint'];
+    readonly scenarioUrl: (scenario: string & keyof Simulation['scenarios'], path: string) => string;
+};
+export type SimulatedHttpServerResource<Simulation extends {
+    readonly name: string;
+    readonly scenarios: SimulationScenarioCatalog;
+}> = ResourceDefinition<Simulation['name'], SimulatedHttpServerResourceHandle<Simulation>, EmptyResourceDependencies>;
+export declare function createSimulatedHttpServerResource<const Name extends string, const Scenarios extends SimulationScenarioCatalog>(options: SimulatedHttpServerResourceOptions<Name, Scenarios>): SimulatedHttpServerResource<SimulatedHttpServerDefinition<Name, Scenarios>>;
+//# sourceMappingURL=simulated-http-server-resource.d.ts.map

package/resources/simulated-http-server-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulated-http-server-resource.d.ts","sourceRoot":"","sources":["../../../../source/resources/simulated-http-server-resource.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,6BAA6B,EAC7B,yBAAyB,EAC5B,MAAM,0BAA6B,CAAC;AACrC,OAAO,KAAK,EACR,yBAAyB,EACzB,kBAAkB,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAGH,KAAK,sBAAsB,EAC9B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACR,0BAA0B,EAC7B,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,kCAAkC,CAC1C,IAAI,SAAS,MAAM,EACnB,SAAS,SAAS,yBAAyB,IAC3C;IACA,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;CACvE,CAAC;AAEF,MAAM,MAAM,iCAAiC,CACzC,UAAU,SAAS;IACf,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CACjD,IACD;IACA,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACpG,CAAC;AAEF,MAAM,MAAM,2BAA2B,CACnC,UAAU,SAAS;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CACjD,IACD,kBAAkB,CAClB,UAAU,CAAC,MAAM,CAAC,EAClB,iCAAiC,CAAC,UAAU,CAAC,EAC7C,yBAAyB,CAC5B,CAAC;AA4BF,wBAAgB,iCAAiC,CAC7C,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,SAAS,SAAS,yBAAyB,EAEjD,OAAO,EAAE,kCAAkC,CAAC,IAAI,EAAE,SAAS,CAAC,GAC7D,2BAA2B,CAAC,6BAA6B,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAyB7E"}

package/resources/simulated-http-server-resource.js

@@ -0,0 +1,38 @@
+import { assertNoSimulatedHttpHandlerErrors, createSimulatedHttpListeningServer } from "@overkill-dev/simulation/http";
+import { createLocalHttpServiceResource } from "./local-http-service-resource.js";
+const scenarioQueryParameterName = '__overkill_scenario';
+function scenarioUrl(baseUrl, scenario, path) {
+    const url = new URL(path, baseUrl);
+    url.searchParams.set(scenarioQueryParameterName, scenario);
+    return url.href;
+}
+function simulatedHttpServerResourceHandle(service) {
+    return Object.freeze({
+        baseUrl: service.baseUrl,
+        endpoint: service.endpoint,
+        scenarioUrl(scenario, path) {
+            return scenarioUrl(service.baseUrl, scenario, path);
+        }
+    });
+}
+export function createSimulatedHttpServerResource(options) {
+    const handlerErrors = new WeakMap();
+    return createLocalHttpServiceResource({
+        name: options.simulation.name,
+        scope: 'per-case',
+        requirements: [],
+        dependencies: {},
+        address: options.address,
+        createServer(context) {
+            context.signal.throwIfAborted();
+            const listeningServer = createSimulatedHttpListeningServer(options.simulation, context.address.host);
+            handlerErrors.set(listeningServer.server, listeningServer.errors);
+            return listeningServer.server;
+        },
+        handle: (simulatedHttpServerResourceHandle),
+        dispose(server) {
+            assertNoSimulatedHttpHandlerErrors(handlerErrors.get(server) ?? []);
+        }
+    });
+}
+//# sourceMappingURL=simulated-http-server-resource.js.map

package/resources/simulated-http-server-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulated-http-server-resource.js","sourceRoot":"","sources":["../../../../source/resources/simulated-http-server-resource.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,kCAAkC,EAClC,kCAAkC,EACrC,MAAM,+BAAwC,CAAC;AAShD,OAAO,EACH,8BAA8B,EAGjC,MAAM,kCAAkC,CAAC;AAkC1C,MAAM,0BAA0B,GAAG,qBAAqB,CAAC;AAEzD,SAAS,WAAW,CAAC,OAAe,EAAE,QAAgB,EAAE,IAAY;IAChE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEnC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,0BAA0B,EAAE,QAAQ,CAAC,CAAC;IAE3D,OAAO,GAAG,CAAC,IAAI,CAAC;AACpB,CAAC;AAED,SAAS,iCAAiC,CAKtC,OAA+B;IAE/B,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,CAAC,QAAgD,EAAE,IAAY;YACtE,OAAO,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACxD,CAAC;KACJ,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,iCAAiC,CAI7C,OAA4D;IAE5D,MAAM,aAAa,GAAG,IAAI,OAAO,EAAuC,CAAC;IAEzE,OAAO,8BAA8B,CAAC;QAClC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI;QAC7B,KAAK,EAAE,UAAU;QACjB,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,YAAY,CAAC,OAAO;YAChB,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAChC,MAAM,eAAe,GAAG,kCAAkC,CACtD,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,OAAO,CAAC,IAAI,CACvB,CAAC;YAEF,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;YAElE,OAAO,eAAe,CAAC,MAAM,CAAC;QAClC,CAAC;QACD,MAAM,EAAE,CAAA,iCAAiF,CAAA;QACzF,OAAO,CAAC,MAAM;YACV,kCAAkC,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;KACJ,CAAC,CAAC;AACP,CAAC"}

package/sbom.cdx.json

@@ -16,15 +16,35 @@
         "component": {
             "type": "library",
             "name": "@overkill-dev/resources",
-            "version": "0.0.2",
-            "bom-ref": "pkg:npm/@overkill-dev/resources@0.0.2",
-            "purl": "pkg:npm/@overkill-dev/resources@0.0.2"
+            "version": "0.0.4",
+            "bom-ref": "pkg:npm/@overkill-dev/resources@0.0.4",
+            "purl": "pkg:npm/@overkill-dev/resources@0.0.4"
         }
     },
-    "components": [],
+    "components": [
+        {
+            "type": "library",
+            "name": "@overkill-dev/simulation",
+            "version": "0.0.3",
+            "bom-ref": "pkg:npm/@overkill-dev/simulation@0.0.3",
+            "scope": "optional",
+            "licenses": [
+                {
+                    "expression": "MIT"
+                }
+            ],
+            "purl": "pkg:npm/@overkill-dev/simulation@0.0.3"
+        }
+    ],
     "dependencies": [
         {
-            "ref": "pkg:npm/@overkill-dev/resources@0.0.2"
+            "ref": "pkg:npm/@overkill-dev/resources@0.0.4",
+            "dependsOn": [
+                "pkg:npm/@overkill-dev/simulation@0.0.3"
+            ]
+        },
+        {
+            "ref": "pkg:npm/@overkill-dev/simulation@0.0.3"
         }
     ]
 }