@docker-harpoon/core 0.1.4 → 0.1.5

package/dist/services/ResourceTracker.js

@@ -0,0 +1,145 @@
+/**
+ * ResourceTracker Service
+ *
+ * Tracks all created resources (containers, networks, etc.) for lifecycle management.
+ * Uses Effect's Ref for thread-safe state management.
+ */
+import { Context, Effect, Layer, Ref, Option, Duration } from 'effect';
+import { HarpoonConfig } from './HarpoonConfig';
+import { cleanupRetrySchedule } from './DockerRateLimiter';
+/**
+ * ResourceTracker service tag for dependency injection.
+ */
+export class ResourceTracker extends Context.Tag('@harpoon/ResourceTracker')() {
+}
+/**
+ * Create a cleanup effect with retry and timeout for a single resource.
+ */
+const makeCleanupWithRetry = (resource, timeout) => resource.cleanup().pipe(
+// Add per-resource timeout
+Effect.timeoutFail({
+    duration: timeout,
+    onTimeout: () => new Error('Cleanup timed out'),
+}), 
+// Retry on transient failures
+Effect.retry({
+    schedule: cleanupRetrySchedule,
+}), 
+// Log success
+Effect.tap(() => Effect.logDebug('Resource destroyed').pipe(Effect.annotateLogs({
+    resourceId: resource.id,
+    resourceType: resource.type,
+}))), 
+// Catch all errors - log but don't fail the overall cleanup
+Effect.catchAll((error) => Effect.logWarning(`Failed to destroy resource: ${error}`).pipe(Effect.annotateLogs({
+    resourceId: resource.id,
+    resourceType: resource.type,
+    timeoutMs: Duration.toMillis(timeout),
+}))));
+/**
+ * Live implementation using Effect Ref for state management.
+ * Enhanced with retry schedules and per-resource timeouts.
+ */
+export const ResourceTrackerLive = Layer.scoped(ResourceTracker, Effect.gen(function* () {
+    const config = yield* HarpoonConfig;
+    // Thread-safe state using Ref
+    const resourcesRef = yield* Ref.make(new Map());
+    const service = {
+        _tag: 'ResourceTracker',
+        register: (resource) => Ref.update(resourcesRef, (map) => {
+            const newMap = new Map(map);
+            newMap.set(resource.id, resource);
+            return newMap;
+        }).pipe(Effect.tap(() => Effect.logDebug('Resource registered').pipe(Effect.annotateLogs({
+            resourceId: resource.id,
+            resourceType: resource.type,
+            resourceName: resource.name,
+        })))),
+        unregister: (id) => Ref.update(resourcesRef, (map) => {
+            const newMap = new Map(map);
+            newMap.delete(id);
+            return newMap;
+        }).pipe(Effect.tap(() => Effect.logDebug('Resource unregistered').pipe(Effect.annotateLogs({ resourceId: id })))),
+        get: (id) => Ref.get(resourcesRef).pipe(Effect.map((map) => Option.fromNullable(map.get(id)))),
+        getAll: () => Ref.get(resourcesRef).pipe(Effect.map((map) => [...map.values()])),
+        getByType: (type) => Ref.get(resourcesRef).pipe(Effect.map((map) => [...map.values()].filter((r) => r.type === type))),
+        count: () => Ref.get(resourcesRef).pipe(Effect.map((map) => map.size)),
+        destroyAll: (options) => Effect.gen(function* () {
+            const resources = yield* Ref.get(resourcesRef);
+            const resourceList = [...resources.values()];
+            if (resourceList.length === 0) {
+                yield* Effect.logDebug('No resources to destroy');
+                return;
+            }
+            yield* Effect.logInfo(`Destroying ${resourceList.length} resources`);
+            // Sort by priority (descending) - higher priority cleaned up first
+            const sorted = resourceList.sort((a, b) => b.priority - a.priority);
+            // Execute cleanups with concurrency control
+            const concurrency = options?.concurrency ?? 4;
+            // Use mode: 'either' to continue on failures
+            yield* Effect.all(sorted.map((resource) => makeCleanupWithRetry(resource, config.cleanupTimeout)), { concurrency, mode: 'either' });
+            // Clear all tracking
+            yield* Ref.set(resourcesRef, new Map());
+            yield* Effect.logInfo('All resources destroyed');
+        }),
+        destroyByType: (type, options) => Effect.gen(function* () {
+            const resources = yield* Ref.get(resourcesRef);
+            const typeResources = [...resources.values()].filter((r) => r.type === type);
+            if (typeResources.length === 0) {
+                yield* Effect.logDebug(`No ${type} resources to destroy`);
+                return;
+            }
+            yield* Effect.logInfo(`Destroying ${typeResources.length} ${type} resources`);
+            // Sort by priority
+            const sorted = typeResources.sort((a, b) => b.priority - a.priority);
+            const concurrency = options?.concurrency ?? 4;
+            // Use mode: 'either' to continue on failures
+            yield* Effect.all(sorted.map((resource) => makeCleanupWithRetry(resource, config.cleanupTimeout).pipe(Effect.tap(() => Ref.update(resourcesRef, (map) => {
+                const newMap = new Map(map);
+                newMap.delete(resource.id);
+                return newMap;
+            })))), { concurrency, mode: 'either' });
+            yield* Effect.logInfo(`All ${type} resources destroyed`);
+        }),
+        clear: () => Ref.set(resourcesRef, new Map()).pipe(Effect.tap(() => Effect.logWarning('Resource tracking cleared'))),
+    };
+    // Register cleanup on scope close
+    yield* Effect.addFinalizer(() => service
+        .destroyAll()
+        .pipe(Effect.catchAll((e) => Effect.logError(`Finalizer cleanup failed: ${e}`))));
+    return service;
+}));
+/**
+ * Test implementation that tracks resources in memory but doesn't actually clean up.
+ */
+export const ResourceTrackerTest = Layer.scoped(ResourceTracker, Effect.gen(function* () {
+    const resourcesRef = yield* Ref.make(new Map());
+    return {
+        _tag: 'ResourceTracker',
+        register: (resource) => Ref.update(resourcesRef, (map) => {
+            const newMap = new Map(map);
+            newMap.set(resource.id, resource);
+            return newMap;
+        }),
+        unregister: (id) => Ref.update(resourcesRef, (map) => {
+            const newMap = new Map(map);
+            newMap.delete(id);
+            return newMap;
+        }),
+        get: (id) => Ref.get(resourcesRef).pipe(Effect.map((map) => Option.fromNullable(map.get(id)))),
+        getAll: () => Ref.get(resourcesRef).pipe(Effect.map((map) => [...map.values()])),
+        getByType: (type) => Ref.get(resourcesRef).pipe(Effect.map((map) => [...map.values()].filter((r) => r.type === type))),
+        count: () => Ref.get(resourcesRef).pipe(Effect.map((map) => map.size)),
+        destroyAll: () => Ref.set(resourcesRef, new Map()).pipe(Effect.asVoid),
+        destroyByType: (type) => Ref.update(resourcesRef, (map) => {
+            const newMap = new Map(map);
+            for (const [id, resource] of map) {
+                if (resource.type === type) {
+                    newMap.delete(id);
+                }
+            }
+            return newMap;
+        }).pipe(Effect.asVoid),
+        clear: () => Ref.set(resourcesRef, new Map()),
+    };
+}));

package/dist/services/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Harpoon Services
+ *
+ * This module exports all Harpoon services and their Live/Test layers.
+ * Import from here for a unified API.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   HarpoonLive,
+ *   DockerClient,
+ *   ResourceTracker,
+ *   EventBus,
+ * } from '@docker-harpoon/core/services';
+ * ```
+ */
+export { HarpoonConfig, type HarpoonConfigService, HarpoonConfigLive, HarpoonConfigTest, makeHarpoonConfigTest, } from './HarpoonConfig';
+export { HarpoonLoggerLive, HarpoonLoggerJson, HarpoonLoggerTest, HarpoonLoggerMinWarn, HarpoonLoggerDebug, withSpan, withLogAnnotations, } from './HarpoonLogger';
+export { DockerClient, type DockerClientService, type CreateContainerOptions, type CreateNetworkOptions, type ListContainersOptions, type ListNetworksOptions, DockerClientLive, DockerClientTest, makeDockerClientTest, } from './DockerClient';
+export { DockerConnectionError, DockerApiError, DockerContainerError, DockerNetworkError, DockerImageError, DockerVolumeError, type DockerError, isDockerConnectionError, isDockerApiError, isDockerError, wrapAsDockerError, isTransientError, } from './DockerErrors';
+export { DockerRateLimiter, type DockerRateLimiterService, DockerRateLimiterLive, DockerRateLimiterTest, makeDockerRateLimiterTest, dockerRetrySchedule, cleanupRetrySchedule, healthCheckSchedule, } from './DockerRateLimiter';
+export { CircuitBreaker, type CircuitBreakerService, type CircuitBreakerConfig, type CircuitState, CircuitOpenError, CircuitBreakerLive, CircuitBreakerTest, makeCircuitBreaker, makeCircuitBreakerLayer, } from './CircuitBreaker';
+export { ResourceTracker, type ResourceTrackerService, type TrackedResource, type ResourceType, ResourceTrackerLive, ResourceTrackerTest, } from './ResourceTracker';
+export { EventBus, type EventBusService, type HarpoonEvent, type ContainerEvent, type ContainerEventType, type NetworkEvent, type NetworkEventType, type DatabaseEvent, containerEvent, networkEvent, databaseEvent, EventBusLive, EventBusTest, } from './EventBus';
+export { ReadinessCoordinator, type ReadinessCoordinatorService, type HealthCheck, type LogHealthCheck, type HttpHealthCheck, type TcpHealthCheck, type ExecHealthCheck, type CustomHealthCheck, type WaitOptions, ReadinessError, ReadinessCoordinatorLive, ReadinessCoordinatorTest, } from './ReadinessCoordinator';
+export { DockerBatcher, type DockerBatcherService, type GetContainerInfoRequest, type GetNetworkInfoRequest, type DockerBatchRequest, GetContainerInfo, GetNetworkInfo, DockerBatcherLive, DockerBatcherTest, } from './DockerBatcher';
+export { ContainerPool, type ContainerPoolService, type ContainerPoolConfig, type PooledContainer, makeContainerPool, ContainerPoolLive, ContainerPoolTest, } from './ContainerPool';
+export { CoreLive, InfrastructureLive, DockerLive, BatcherLive, ResourcesLive, EventsLive, ReadinessLive, ServicesLive, HarpoonLive, CoreTest, InfrastructureTest, DockerTest, BatcherTest, ResourcesTest, EventsTest, ReadinessTest, ServicesTest, HarpoonTest, type HarpoonServices, type HarpoonRequirements, } from './Harpoon';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,WAAW,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EAEzB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAElB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,cAAc,EACd,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAEL,QAAQ,EACR,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EAGX,QAAQ,EACR,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EAGX,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,47 @@
+/**
+ * Harpoon Services
+ *
+ * This module exports all Harpoon services and their Live/Test layers.
+ * Import from here for a unified API.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   HarpoonLive,
+ *   DockerClient,
+ *   ResourceTracker,
+ *   EventBus,
+ * } from '@docker-harpoon/core/services';
+ * ```
+ */
+// ============ Configuration ============
+export { HarpoonConfig, HarpoonConfigLive, HarpoonConfigTest, makeHarpoonConfigTest, } from './HarpoonConfig';
+export { HarpoonLoggerLive, HarpoonLoggerJson, HarpoonLoggerTest, HarpoonLoggerMinWarn, HarpoonLoggerDebug, withSpan, withLogAnnotations, } from './HarpoonLogger';
+// ============ Docker Client ============
+export { DockerClient, DockerClientLive, DockerClientTest, makeDockerClientTest, } from './DockerClient';
+// ============ Docker Errors ============
+export { DockerConnectionError, DockerApiError, DockerContainerError, DockerNetworkError, DockerImageError, DockerVolumeError, isDockerConnectionError, isDockerApiError, isDockerError, wrapAsDockerError, isTransientError, } from './DockerErrors';
+// ============ Rate Limiting ============
+export { DockerRateLimiter, DockerRateLimiterLive, DockerRateLimiterTest, makeDockerRateLimiterTest, 
+// Retry schedules
+dockerRetrySchedule, cleanupRetrySchedule, healthCheckSchedule, } from './DockerRateLimiter';
+// ============ Circuit Breaker ============
+export { CircuitBreaker, CircuitOpenError, CircuitBreakerLive, CircuitBreakerTest, makeCircuitBreaker, makeCircuitBreakerLayer, } from './CircuitBreaker';
+// ============ Resource Tracking ============
+export { ResourceTracker, ResourceTrackerLive, ResourceTrackerTest, } from './ResourceTracker';
+// ============ Event Bus ============
+export { EventBus, 
+// Event constructors
+containerEvent, networkEvent, databaseEvent, EventBusLive, EventBusTest, } from './EventBus';
+// ============ Readiness Coordination ============
+export { ReadinessCoordinator, ReadinessError, ReadinessCoordinatorLive, ReadinessCoordinatorTest, } from './ReadinessCoordinator';
+// ============ Request Batching ============
+export { DockerBatcher, GetContainerInfo, GetNetworkInfo, DockerBatcherLive, DockerBatcherTest, } from './DockerBatcher';
+// ============ Container Pool ============
+export { ContainerPool, makeContainerPool, ContainerPoolLive, ContainerPoolTest, } from './ContainerPool';
+// ============ Unified Layers ============
+export { 
+// Live layers
+CoreLive, InfrastructureLive, DockerLive, BatcherLive, ResourcesLive, EventsLive, ReadinessLive, ServicesLive, HarpoonLive, 
+// Test layers
+CoreTest, InfrastructureTest, DockerTest, BatcherTest, ResourcesTest, EventsTest, ReadinessTest, ServicesTest, HarpoonTest, } from './Harpoon';

package/dist/testing/helpers.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Test Helpers and Utilities
+ *
+ * Provides utility functions for testing Harpoon services with Effect.
+ */
+import { Effect, Layer, Exit, Scope, Duration, Stream } from 'effect';
+import { HarpoonConfig } from '../services/HarpoonConfig';
+import { DockerClient } from '../services/DockerClient';
+import { DockerRateLimiter } from '../services/DockerRateLimiter';
+import { CircuitBreaker } from '../services/CircuitBreaker';
+import { ResourceTracker } from '../services/ResourceTracker';
+import { EventBus } from '../services/EventBus';
+import { ReadinessCoordinator } from '../services/ReadinessCoordinator';
+/**
+ * Combined test layer with all mock services.
+ */
+export declare const TestServices: Layer.Layer<CircuitBreaker | DockerRateLimiter | EventBus | HarpoonConfig | ReadinessCoordinator | ResourceTracker, never, never>;
+/**
+ * Full test layer including DockerClient.
+ */
+export declare const FullTestLayer: Layer.Layer<CircuitBreaker | DockerClient | DockerRateLimiter | EventBus | HarpoonConfig | ReadinessCoordinator | ResourceTracker, never, never>;
+/**
+ * Run an effect with test services and return the result.
+ */
+export declare const runTest: <A, E>(effect: Effect.Effect<A, E, CircuitBreaker | DockerRateLimiter | EventBus | HarpoonConfig | ReadinessCoordinator | ResourceTracker>) => Promise<A>;
+/**
+ * Run an effect with full test services including DockerClient.
+ */
+export declare const runFullTest: <A, E>(effect: Effect.Effect<A, E, CircuitBreaker | DockerClient | DockerRateLimiter | EventBus | HarpoonConfig | ReadinessCoordinator | ResourceTracker>) => Promise<A>;
+/**
+ * Run an effect with a scope for cleanup.
+ */
+export declare const runScopedTest: <A, E>(effect: Effect.Effect<A, E, CircuitBreaker | DockerRateLimiter | EventBus | HarpoonConfig | ReadinessCoordinator | ResourceTracker | Scope.Scope>) => Promise<A>;
+/**
+ * Run an effect and expect it to fail.
+ */
+export declare const runTestExpectError: <A, E>(effect: Effect.Effect<A, E, CircuitBreaker | DockerRateLimiter | EventBus | HarpoonConfig | ReadinessCoordinator | ResourceTracker>) => Promise<E>;
+/**
+ * Assert that an effect succeeds with a specific value.
+ */
+export declare const assertSuccess: <A, E>(effect: Effect.Effect<A, E, never>, expected: A) => Effect.Effect<void, E, never>;
+/**
+ * Assert that an effect fails with a specific error tag.
+ */
+export declare const assertFailsWithTag: <A, E extends {
+    _tag: string;
+}>(effect: Effect.Effect<A, E, never>, expectedTag: E["_tag"]) => Effect.Effect<void, never, never>;
+/**
+ * Assert that an effect completes within a timeout.
+ */
+export declare const assertCompletesWithin: <A, E>(effect: Effect.Effect<A, E, never>, timeout: Duration.Duration) => Effect.Effect<A, E | Error, never>;
+/**
+ * Generate a unique test ID.
+ */
+export declare const uniqueId: (prefix?: string) => string;
+/**
+ * Generate mock container stats.
+ */
+export declare const mockContainerStats: (overrides?: Record<string, unknown>) => {
+    cpu: {
+        usage: number;
+        system: number;
+        percent: number;
+        cores: number;
+    };
+    memory: {
+        usage: number;
+        limit: number;
+        percent: number;
+        usageMB: number;
+        limitMB: number;
+    };
+    network: {
+        rxBytes: number;
+        txBytes: number;
+        rxPackets: number;
+        txPackets: number;
+    };
+    timestamp: string;
+    containerId: string;
+};
+/**
+ * Generate mock log lines.
+ */
+export declare const mockLogLines: (count: number, stream?: "stderr" | "stdout") => {
+    stream: "stderr" | "stdout";
+    message: string;
+    timestamp: string;
+}[];
+/**
+ * Create a test scope that auto-cleans.
+ */
+export declare const withTestScope: <A, E, R>(fn: (scope: Scope.Scope) => Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+/**
+ * Delay helper for testing async operations.
+ */
+export declare const testDelay: (ms: number) => Effect.Effect<void, never, never>;
+/**
+ * Collect all values from a stream for testing.
+ */
+export declare const collectStream: <A, E>(streamEffect: Effect.Effect<Stream.Stream<A, E, never>, never, never>, maxItems?: number) => Effect.Effect<readonly A[], E, never>;
+/**
+ * Check if an Exit is successful.
+ */
+export declare const isSuccess: <A, E>(exit: Exit.Exit<A, E>) => exit is Exit.Success<A, E>;
+/**
+ * Check if an Exit is a failure.
+ */
+export declare const isFailure: <A, E>(exit: Exit.Exit<A, E>) => exit is Exit.Failure<A, E>;
+/**
+ * Get the error from a failure Exit.
+ */
+export declare const getFailureError: <A, E>(exit: Exit.Exit<A, E>) => E | undefined;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/testing/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/testing/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAkB,KAAK,EAAE,QAAQ,EAAS,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE7F,OAAO,EAAE,aAAa,EAAqB,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAoB,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAyB,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,cAAc,EAAsB,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,eAAe,EAAuB,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAgB,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAA4B,MAAM,kCAAkC,CAAC;AAIlG;;GAEG;AACH,eAAO,MAAM,YAAY,mIAOxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,kJAAiD,CAAC;AAI5E;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,CAAC,oJAWiD,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,CAAC,mKAY8C,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,kKAY0D,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAAE,CAAC,oJAWmD,CAAC;AAI3F;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,mFAU/B,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAAE,CAAC;;mGAapC,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,CAAC,uGASvC,CAAC;AAIJ;;GAEG;AACH,eAAO,MAAM,QAAQ,6BACoD,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;CAuB7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;GAKpB,CAAC;AAIN;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,+EAGiD,CAAC;AAEvF;;GAEG;AACH,eAAO,MAAM,SAAS,mDAAyE,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,oIAS9B,CAAC;AAIL;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,sDACR,CAAC;AAEvB;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,sDACR,CAAC;AAEvB;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,CAAC,yCAQnC,CAAC"}

package/dist/testing/helpers.js

@@ -0,0 +1,140 @@
+/**
+ * Test Helpers and Utilities
+ *
+ * Provides utility functions for testing Harpoon services with Effect.
+ */
+import { Effect, Layer, Exit, Cause, Scope, Duration, Stream } from 'effect';
+import { HarpoonConfigTest } from '../services/HarpoonConfig';
+import { DockerClientTest } from '../services/DockerClient';
+import { DockerRateLimiterTest } from '../services/DockerRateLimiter';
+import { CircuitBreakerTest } from '../services/CircuitBreaker';
+import { ResourceTrackerTest } from '../services/ResourceTracker';
+import { EventBusTest } from '../services/EventBus';
+import { ReadinessCoordinatorTest } from '../services/ReadinessCoordinator';
+// ============ Test Layers ============
+/**
+ * Combined test layer with all mock services.
+ */
+export const TestServices = Layer.mergeAll(HarpoonConfigTest, DockerRateLimiterTest, CircuitBreakerTest, ResourceTrackerTest, EventBusTest, ReadinessCoordinatorTest);
+/**
+ * Full test layer including DockerClient.
+ */
+export const FullTestLayer = Layer.mergeAll(TestServices, DockerClientTest);
+// ============ Test Runners ============
+/**
+ * Run an effect with test services and return the result.
+ */
+export const runTest = (effect) => Effect.runPromise(effect.pipe(Effect.provide(TestServices)));
+/**
+ * Run an effect with full test services including DockerClient.
+ */
+export const runFullTest = (effect) => Effect.runPromise(effect.pipe(Effect.provide(FullTestLayer)));
+/**
+ * Run an effect with a scope for cleanup.
+ */
+export const runScopedTest = (effect) => Effect.runPromise(Effect.scoped(effect.pipe(Effect.provide(TestServices))));
+/**
+ * Run an effect and expect it to fail.
+ */
+export const runTestExpectError = (effect) => Effect.runPromise(effect.pipe(Effect.provide(TestServices), Effect.flip));
+// ============ Assertion Helpers ============
+/**
+ * Assert that an effect succeeds with a specific value.
+ */
+export const assertSuccess = (effect, expected) => effect.pipe(Effect.flatMap((result) => result === expected
+    ? Effect.void
+    : Effect.die(new Error(`Expected ${expected}, got ${result}`))));
+/**
+ * Assert that an effect fails with a specific error tag.
+ */
+export const assertFailsWithTag = (effect, expectedTag) => effect.pipe(Effect.matchEffect({
+    onFailure: (error) => error._tag === expectedTag
+        ? Effect.void
+        : Effect.die(new Error(`Expected error tag ${expectedTag}, got ${error._tag}`)),
+    onSuccess: () => Effect.die(new Error(`Expected failure with tag ${expectedTag}, but succeeded`)),
+}));
+/**
+ * Assert that an effect completes within a timeout.
+ */
+export const assertCompletesWithin = (effect, timeout) => effect.pipe(Effect.timeoutFail({
+    duration: timeout,
+    onTimeout: () => new Error(`Effect did not complete within ${Duration.toMillis(timeout)}ms`),
+}));
+// ============ Mock Data Generators ============
+/**
+ * Generate a unique test ID.
+ */
+export const uniqueId = (prefix = 'test') => `${prefix}-${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
+/**
+ * Generate mock container stats.
+ */
+export const mockContainerStats = (overrides = {}) => ({
+    cpu: {
+        usage: 1000000,
+        system: 100000000,
+        percent: 1.0,
+        cores: 4,
+    },
+    memory: {
+        usage: 104857600,
+        limit: 1073741824,
+        percent: 9.77,
+        usageMB: 100,
+        limitMB: 1024,
+    },
+    network: {
+        rxBytes: 1024,
+        txBytes: 2048,
+        rxPackets: 10,
+        txPackets: 20,
+    },
+    timestamp: new Date().toISOString(),
+    containerId: 'mock-container-id',
+    ...overrides,
+});
+/**
+ * Generate mock log lines.
+ */
+export const mockLogLines = (count, stream = 'stdout') => Array.from({ length: count }, (_, i) => ({
+    stream,
+    message: `Log line ${i + 1}`,
+    timestamp: new Date().toISOString(),
+}));
+// ============ Test Fixture Helpers ============
+/**
+ * Create a test scope that auto-cleans.
+ */
+export const withTestScope = (fn) => Effect.acquireUseRelease(Scope.make(), fn, (scope) => Scope.close(scope, Exit.void));
+/**
+ * Delay helper for testing async operations.
+ */
+export const testDelay = (ms) => Effect.sleep(Duration.millis(ms));
+/**
+ * Collect all values from a stream for testing.
+ */
+export const collectStream = (streamEffect, maxItems = 100) => Effect.gen(function* () {
+    const s = yield* streamEffect;
+    const items = yield* s.pipe(Stream.take(maxItems), Stream.runCollect);
+    return Array.from(items);
+});
+// ============ Effect Test Matchers ============
+/**
+ * Check if an Exit is successful.
+ */
+export const isSuccess = (exit) => Exit.isSuccess(exit);
+/**
+ * Check if an Exit is a failure.
+ */
+export const isFailure = (exit) => Exit.isFailure(exit);
+/**
+ * Get the error from a failure Exit.
+ */
+export const getFailureError = (exit) => {
+    if (Exit.isFailure(exit)) {
+        const cause = exit.cause;
+        if (Cause.isFailType(cause)) {
+            return cause.error;
+        }
+    }
+    return undefined;
+};

package/dist/testing/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Harpoon Testing Utilities
+ *
+ * Provides mock implementations, test helpers, and utilities for testing
+ * Harpoon-based applications with Effect.
+ *
+ * @example
+ * ```typescript
+ * import { runTest, createMockDockerClient, mockContainerStats } from '@docker-harpoon/core/testing';
+ *
+ * const test = Effect.gen(function* () {
+ *   const container = yield* Container("test", { image: "alpine" });
+ *   const stats = yield* container.stats();
+ *   expect(stats.cpu.percent).toBeGreaterThan(0);
+ * });
+ *
+ * await runTest(test);
+ * ```
+ */
+export { createMockContainer, createMockNetwork, type MockContainerConfig, createMockDockerClient, MockDockerRateLimiter, MockCircuitBreaker, MockResourceTracker, createMockResourceTracker, createMockEventBus, createMockReadinessCoordinator, createMockHarpoonConfig, MockHarpoonConfig, } from './mocks';
+export { TestServices, FullTestLayer, runTest, runFullTest, runScopedTest, runTestExpectError, assertSuccess, assertFailsWithTag, assertCompletesWithin, uniqueId, mockContainerStats, mockLogLines, withTestScope, testDelay, collectStream, isSuccess, isFailure, getFailureError, } from './helpers';
+export { HarpoonConfigTest, makeHarpoonConfigTest } from '../services/HarpoonConfig';
+export { DockerClientTest, makeDockerClientTest } from '../services/DockerClient';
+export { DockerRateLimiterTest, makeDockerRateLimiterTest } from '../services/DockerRateLimiter';
+export { CircuitBreakerTest, makeCircuitBreakerLayer } from '../services/CircuitBreaker';
+export { ResourceTrackerTest } from '../services/ResourceTracker';
+export { EventBusTest } from '../services/EventBus';
+export { ReadinessCoordinatorTest } from '../services/ReadinessCoordinator';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAEL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,mBAAmB,EAGxB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,8BAA8B,EAC9B,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAEL,YAAY,EACZ,aAAa,EAGb,OAAO,EACP,WAAW,EACX,aAAa,EACb,kBAAkB,EAGlB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EAGrB,QAAQ,EACR,kBAAkB,EAClB,YAAY,EAGZ,aAAa,EACb,SAAS,EACT,aAAa,EAGb,SAAS,EACT,SAAS,EACT,eAAe,GAChB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAErF,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAElF,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAEjG,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAEzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,47 @@
+/**
+ * Harpoon Testing Utilities
+ *
+ * Provides mock implementations, test helpers, and utilities for testing
+ * Harpoon-based applications with Effect.
+ *
+ * @example
+ * ```typescript
+ * import { runTest, createMockDockerClient, mockContainerStats } from '@docker-harpoon/core/testing';
+ *
+ * const test = Effect.gen(function* () {
+ *   const container = yield* Container("test", { image: "alpine" });
+ *   const stats = yield* container.stats();
+ *   expect(stats.cpu.percent).toBeGreaterThan(0);
+ * });
+ *
+ * await runTest(test);
+ * ```
+ */
+// Re-export all mocks
+export { 
+// Mock container/network creation
+createMockContainer, createMockNetwork, 
+// Mock service layers
+createMockDockerClient, MockDockerRateLimiter, MockCircuitBreaker, MockResourceTracker, createMockResourceTracker, createMockEventBus, createMockReadinessCoordinator, createMockHarpoonConfig, MockHarpoonConfig, } from './mocks';
+// Re-export all helpers
+export { 
+// Test layers
+TestServices, FullTestLayer, 
+// Test runners
+runTest, runFullTest, runScopedTest, runTestExpectError, 
+// Assertions
+assertSuccess, assertFailsWithTag, assertCompletesWithin, 
+// Mock data generators
+uniqueId, mockContainerStats, mockLogLines, 
+// Test fixtures
+withTestScope, testDelay, collectStream, 
+// Exit matchers
+isSuccess, isFailure, getFailureError, } from './helpers';
+// Re-export test layer implementations from services
+export { HarpoonConfigTest, makeHarpoonConfigTest } from '../services/HarpoonConfig';
+export { DockerClientTest, makeDockerClientTest } from '../services/DockerClient';
+export { DockerRateLimiterTest, makeDockerRateLimiterTest } from '../services/DockerRateLimiter';
+export { CircuitBreakerTest, makeCircuitBreakerLayer } from '../services/CircuitBreaker';
+export { ResourceTrackerTest } from '../services/ResourceTracker';
+export { EventBusTest } from '../services/EventBus';
+export { ReadinessCoordinatorTest } from '../services/ReadinessCoordinator';

package/dist/testing/mocks.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Mock Implementations for Testing
+ *
+ * Provides mock implementations of Harpoon services for unit testing.
+ */
+import { Effect, Layer } from 'effect';
+import Docker from 'dockerode';
+import { DockerClient, type DockerClientService } from '../services/DockerClient';
+import { DockerRateLimiter } from '../services/DockerRateLimiter';
+import { CircuitBreaker } from '../services/CircuitBreaker';
+import { ResourceTracker, type ResourceTrackerService } from '../services/ResourceTracker';
+import { type EventBusService, type HarpoonEvent } from '../services/EventBus';
+import { type ReadinessCoordinatorService } from '../services/ReadinessCoordinator';
+import { HarpoonConfig, type HarpoonConfigService } from '../services/HarpoonConfig';
+/**
+ * Configuration for mock container behavior.
+ */
+export interface MockContainerConfig {
+    id: string;
+    name: string;
+    running?: boolean;
+    logs?: string;
+    stats?: object;
+}
+/**
+ * Create a mock Docker container.
+ */
+export declare const createMockContainer: (config: MockContainerConfig) => Docker.Container;
+/**
+ * Create a mock Docker network.
+ */
+export declare const createMockNetwork: (id: string, name?: string) => Docker.Network;
+/**
+ * Create a mock DockerClient layer with customizable behavior.
+ */
+export declare const createMockDockerClient: (overrides?: Partial<DockerClientService>) => Layer.Layer<DockerClient, never, never>;
+/**
+ * Create a mock RateLimiter that doesn't limit.
+ */
+export declare const MockDockerRateLimiter: Layer.Layer<DockerRateLimiter>;
+/**
+ * Create a mock CircuitBreaker that never opens.
+ */
+export declare const MockCircuitBreaker: Layer.Layer<CircuitBreaker>;
+/**
+ * Create a mock ResourceTracker that tracks in memory.
+ */
+export declare const createMockResourceTracker: () => Effect.Effect<ResourceTrackerService, never, never>;
+export declare const MockResourceTracker: Layer.Layer<ResourceTracker>;
+/**
+ * Create a mock EventBus that collects events.
+ */
+export declare const createMockEventBus: () => Effect.Effect<{
+    service: EventBusService;
+    getEvents: () => Effect.Effect<readonly HarpoonEvent[], never, never>;
+}, never, never>;
+/**
+ * Create a mock ReadinessCoordinator.
+ */
+export declare const createMockReadinessCoordinator: (preReady?: string[]) => Effect.Effect<ReadinessCoordinatorService, never, never>;
+/**
+ * Create a test configuration with fast timeouts.
+ */
+export declare const createMockHarpoonConfig: (overrides?: Partial<Omit<HarpoonConfigService, "_tag">>) => Layer.Layer<HarpoonConfig, never, never>;
+export declare const MockHarpoonConfig: Layer.Layer<HarpoonConfig, never, never>;
+//# sourceMappingURL=mocks.d.ts.map

package/dist/testing/mocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocks.d.ts","sourceRoot":"","sources":["../../src/testing/mocks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAgD,MAAM,QAAQ,CAAC;AACrF,OAAO,MAAM,MAAM,WAAW,CAAC;AAE/B,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EAGzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAuC,MAAM,4BAA4B,CAAC;AACjG,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAG5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EAIlB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,2BAA2B,EAIjC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIrF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,mDAuCG,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,iBAAiB,+CAOG,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,sBAAsB,uFA8B/B,CAAC;AAIL;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAWhE,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc,CAOzD,CAAC;AAIH;;GAEG;AACH,eAAO,MAAM,yBAAyB,2DA8BlC,CAAC;AAEL,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,KAAK,CAAC,eAAe,CAG5D,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;gBAiD3B,CAAC;AAIL;;GAEG;AACH,eAAO,MAAM,8BAA8B,mFAkDvC,CAAC;AAIL;;GAEG;AACH,eAAO,MAAM,uBAAuB,uGAchC,CAAC;AAEL,eAAO,MAAM,iBAAiB,0CAA4B,CAAC"}