@docker-harpoon/core 0.1.3 → 0.1.5

package/dist/testing/mocks.js

@@ -0,0 +1,224 @@
+/**
+ * Mock Implementations for Testing
+ *
+ * Provides mock implementations of Harpoon services for unit testing.
+ */
+import { Effect, Layer, Ref, PubSub, Stream, Duration, Option } from 'effect';
+import { DockerClient, } from '../services/DockerClient';
+import { DockerRateLimiter } from '../services/DockerRateLimiter';
+import { CircuitBreaker } from '../services/CircuitBreaker';
+import { ResourceTracker, } from '../services/ResourceTracker';
+import '../services/ReadinessCoordinator';
+import { HarpoonConfig } from '../services/HarpoonConfig';
+/**
+ * Create a mock Docker container.
+ */
+export const createMockContainer = (config) => ({
+    id: config.id,
+    start: () => Promise.resolve(),
+    stop: () => Promise.resolve(),
+    kill: () => Promise.resolve(),
+    remove: () => Promise.resolve(),
+    inspect: () => Promise.resolve({
+        Id: config.id,
+        Name: `/${config.name}`,
+        State: { Running: config.running ?? true },
+        NetworkSettings: { Networks: {} },
+    }),
+    logs: () => Promise.resolve(Buffer.from(config.logs ?? '')),
+    stats: () => Promise.resolve(config.stats ?? {
+        cpu_stats: {
+            cpu_usage: { total_usage: 1000000 },
+            system_cpu_usage: 100000000,
+            online_cpus: 4,
+        },
+        precpu_stats: {
+            cpu_usage: { total_usage: 900000 },
+            system_cpu_usage: 99000000,
+        },
+        memory_stats: {
+            usage: 1024 * 1024 * 100,
+            limit: 1024 * 1024 * 1024,
+        },
+        networks: {},
+    }),
+    exec: () => Promise.resolve({
+        start: () => Promise.resolve({}),
+        inspect: () => Promise.resolve({ ExitCode: 0 }),
+    }),
+});
+/**
+ * Create a mock Docker network.
+ */
+export const createMockNetwork = (id, name = 'mock-network') => ({
+    id,
+    inspect: () => Promise.resolve({ Id: id, Name: name }),
+    remove: () => Promise.resolve(),
+    connect: () => Promise.resolve(),
+    disconnect: () => Promise.resolve(),
+});
+/**
+ * Create a mock DockerClient layer with customizable behavior.
+ */
+export const createMockDockerClient = (overrides = {}) => Layer.succeed(DockerClient, {
+    _tag: 'DockerClient',
+    client: {},
+    ping: () => Effect.void,
+    version: () => Effect.succeed({
+        Version: '24.0.0',
+        ApiVersion: '1.43',
+        Os: 'linux',
+        Arch: 'amd64',
+    }),
+    listContainers: () => Effect.succeed([]),
+    getContainer: (id) => createMockContainer({ id, name: id }),
+    createContainer: (options) => Effect.succeed(createMockContainer({ id: `mock-${options.name}`, name: options.name })),
+    listNetworks: () => Effect.succeed([]),
+    getNetwork: (id) => createMockNetwork(id),
+    createNetwork: (options) => Effect.succeed(createMockNetwork(`mock-${options.Name}`, options.Name)),
+    getImage: (name) => ({
+        inspect: () => Promise.resolve({ Id: name }),
+        remove: () => Promise.resolve(),
+    }),
+    listImages: () => Effect.succeed([]),
+    pullImage: () => Effect.void,
+    ...overrides,
+});
+// ============ Mock RateLimiter ============
+/**
+ * Create a mock RateLimiter that doesn't limit.
+ */
+export const MockDockerRateLimiter = Layer.succeed(DockerRateLimiter, {
+    _tag: 'DockerRateLimiter',
+    withPermit: (effect) => effect,
+    withPermits: () => (effect) => effect,
+    available: () => Effect.succeed(Infinity),
+});
+// ============ Mock CircuitBreaker ============
+/**
+ * Create a mock CircuitBreaker that never opens.
+ */
+export const MockCircuitBreaker = Layer.succeed(CircuitBreaker, {
+    _tag: 'CircuitBreaker',
+    protect: (effect) => effect,
+    getState: () => Effect.succeed('Closed'),
+    reset: () => Effect.void,
+    getFailures: () => Effect.succeed(0),
+});
+// ============ Mock ResourceTracker ============
+/**
+ * Create a mock ResourceTracker that tracks in memory.
+ */
+export const createMockResourceTracker = () => Effect.gen(function* () {
+    const resources = yield* Ref.make(new Map());
+    return {
+        _tag: 'ResourceTracker',
+        register: (resource) => Ref.update(resources, (map) => {
+            const newMap = new Map(map);
+            newMap.set(resource.id, resource);
+            return newMap;
+        }),
+        unregister: (id) => Ref.update(resources, (map) => {
+            const newMap = new Map(map);
+            newMap.delete(id);
+            return newMap;
+        }),
+        get: (id) => Ref.get(resources).pipe(Effect.map((map) => Option.fromNullable(map.get(id)))),
+        getAll: () => Ref.get(resources).pipe(Effect.map((map) => [...map.values()])),
+        getByType: (type) => Ref.get(resources).pipe(Effect.map((map) => [...map.values()].filter((r) => r.type === type))),
+        count: () => Ref.get(resources).pipe(Effect.map((map) => map.size)),
+        destroyAll: () => Ref.set(resources, new Map()).pipe(Effect.asVoid),
+        destroyByType: (_type) => Effect.void,
+        clear: () => Ref.set(resources, new Map()),
+    };
+});
+export const MockResourceTracker = Layer.effect(ResourceTracker, createMockResourceTracker());
+// ============ Mock EventBus ============
+/**
+ * Create a mock EventBus that collects events.
+ */
+export const createMockEventBus = () => Effect.gen(function* () {
+    const events = yield* Ref.make([]);
+    const pubsub = yield* PubSub.unbounded();
+    const service = {
+        _tag: 'EventBus',
+        publish: (event) => Effect.all([
+            Ref.update(events, (arr) => [...arr, event]),
+            PubSub.publish(pubsub, event),
+        ]).pipe(Effect.map(() => true)),
+        subscribe: () => Effect.gen(function* () {
+            const queue = yield* PubSub.subscribe(pubsub);
+            return Stream.fromQueue(queue);
+        }),
+        subscribeContainers: () => Effect.gen(function* () {
+            const queue = yield* PubSub.subscribe(pubsub);
+            return Stream.fromQueue(queue).pipe(Stream.filter((e) => e._tag === 'ContainerEvent'));
+        }),
+        subscribeNetworks: () => Effect.gen(function* () {
+            const queue = yield* PubSub.subscribe(pubsub);
+            return Stream.fromQueue(queue).pipe(Stream.filter((e) => e._tag === 'NetworkEvent'));
+        }),
+        subscribeDatabases: () => Effect.gen(function* () {
+            const queue = yield* PubSub.subscribe(pubsub);
+            return Stream.fromQueue(queue).pipe(Stream.filter((e) => e._tag === 'DatabaseEvent'));
+        }),
+        subscriberCount: () => Effect.succeed(0),
+    };
+    return {
+        service,
+        getEvents: () => Ref.get(events),
+    };
+});
+// ============ Mock ReadinessCoordinator ============
+/**
+ * Create a mock ReadinessCoordinator.
+ */
+export const createMockReadinessCoordinator = (preReady = []) => Effect.gen(function* () {
+    const state = yield* Ref.make(new Map(preReady.map((id) => [id, true])));
+    return {
+        _tag: 'ReadinessCoordinator',
+        waitForReady: (containerId, _healthCheck, _checkFn, _options) => Ref.update(state, (map) => {
+            const newMap = new Map(map);
+            newMap.set(containerId, true);
+            return newMap;
+        }).pipe(Effect.asVoid),
+        isReady: (containerId) => Ref.get(state).pipe(Effect.map((map) => map.get(containerId) ?? false)),
+        markReady: (containerId) => Ref.update(state, (map) => {
+            const newMap = new Map(map);
+            newMap.set(containerId, true);
+            return newMap;
+        }),
+        markNotReady: (containerId) => Ref.update(state, (map) => {
+            const newMap = new Map(map);
+            newMap.set(containerId, false);
+            return newMap;
+        }),
+        untrack: (containerId) => Ref.update(state, (map) => {
+            const newMap = new Map(map);
+            newMap.delete(containerId);
+            return newMap;
+        }),
+        getAll: () => Ref.get(state).pipe(Effect.map((map) => [...map.entries()].map(([containerId, ready]) => ({
+            containerId,
+            ready,
+            timestamp: new Date(),
+        })))),
+    };
+});
+// ============ Mock HarpoonConfig ============
+/**
+ * Create a test configuration with fast timeouts.
+ */
+export const createMockHarpoonConfig = (overrides = {}) => Layer.succeed(HarpoonConfig, {
+    _tag: 'HarpoonConfig',
+    dockerSocket: undefined,
+    defaultTimeout: Duration.millis(5000),
+    cleanupTimeout: Duration.millis(1000),
+    logLevel: 'debug',
+    parallelLimit: 2,
+    retryAttempts: 1,
+    retryDelay: Duration.millis(100),
+    dockerStartupTimeout: Duration.millis(5000),
+    ...overrides,
+});
+export const MockHarpoonConfig = createMockHarpoonConfig();

package/dist/utils/process.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Cross-Runtime Process Utilities
+ *
+ * Provides process execution utilities that work with Node.js, Bun, and Deno.
+ * Uses Node.js child_process module which is compatible across all major runtimes.
+ */
+export interface SpawnResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Convert a readable stream to a string.
+ */
+export declare function streamToString(stream: NodeJS.ReadableStream): Promise<string>;
+/**
+ * Execute a command and capture output.
+ * Works with Node.js, Bun, and Deno (via Node compat).
+ */
+export declare function execCommand(command: string, args: string[], options?: {
+    captureStdout?: boolean;
+    captureStderr?: boolean;
+}): Promise<SpawnResult>;
+//# sourceMappingURL=process.d.ts.map

package/dist/utils/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAO7E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IACP,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACpB,GACL,OAAO,CAAC,WAAW,CAAC,CA6BtB"}

package/dist/utils/process.js

@@ -0,0 +1,49 @@
+/**
+ * Cross-Runtime Process Utilities
+ *
+ * Provides process execution utilities that work with Node.js, Bun, and Deno.
+ * Uses Node.js child_process module which is compatible across all major runtimes.
+ */
+import { spawn } from 'child_process';
+/**
+ * Convert a readable stream to a string.
+ */
+export function streamToString(stream) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        stream.on('data', (chunk) => chunks.push(Buffer.from(chunk)));
+        stream.on('error', reject);
+        stream.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+    });
+}
+/**
+ * Execute a command and capture output.
+ * Works with Node.js, Bun, and Deno (via Node compat).
+ */
+export function execCommand(command, args, options = {}) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn(command, args, {
+            stdio: [
+                'ignore',
+                options.captureStdout ? 'pipe' : 'ignore',
+                options.captureStderr ? 'pipe' : 'ignore',
+            ],
+        });
+        let stdout = '';
+        let stderr = '';
+        if (proc.stdout) {
+            proc.stdout.on('data', (data) => {
+                stdout += data.toString();
+            });
+        }
+        if (proc.stderr) {
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+        }
+        proc.on('error', reject);
+        proc.on('close', (exitCode) => {
+            resolve({ exitCode: exitCode ?? 1, stdout, stderr });
+        });
+    });
+}

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@docker-harpoon/core",
-  "version": "0.1.3",
-  "license": "MIT",
+  "version": "0.1.5",
   "description": "Core Docker resource primitives and binding interface",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -10,11 +13,12 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
     }
   },
-  "files": [
-    "dist"
-  ],
   "scripts": {
     "build": "tsgo",
     "typecheck": "tsgo --noEmit",
@@ -23,9 +27,9 @@
   "dependencies": {
     "dockerode": "^4.0.9",
     "effect": "^3.19.14",
-    "zod": "^4.3.5"
+    "zod": "^3.23.8"
   },
-  "peerDependencies": {
-    "bun": ">=1.0.0"
+  "devDependencies": {
+    "@effect/vitest": "^0.10.0"
   }
 }