@docker-harpoon/core 0.1.4 → 0.2.0

package/dist/__tests__/database.test.js

@@ -1,78 +0,0 @@
-/**
- * Database Helper Integration Tests
- *
- * Dogfoods the database helper to verify:
- * - Connection string generation
- * - Port mapping
- * - Database-specific defaults
- */
-import { describe, test, expect, afterEach, setDefaultTimeout } from 'bun:test';
-import { Network, database, destroyAll } from '../index';
-setDefaultTimeout(60_000);
-describe('database', () => {
-    afterEach(async () => {
-        await destroyAll();
-    });
-    test('creates a postgres database with connection string', async () => {
-        const db = await database('test-postgres', {
-            image: 'postgres:16-alpine',
-            env: {
-                POSTGRES_PASSWORD: 'testpass',
-                POSTGRES_DB: 'testdb',
-            },
-            hostPort: 15432,
-        });
-        expect(db.id).toBeDefined();
-        expect(db.name).toBe('test-postgres');
-        expect(db.port).toBe(5432);
-        expect(db.hostPort).toBe(15432);
-        expect(db.connectionString).toBe('postgresql://postgres:testpass@localhost:15432/testdb');
-        await db.destroy();
-    });
-    test('creates a redis database with connection string', async () => {
-        const db = await database('test-redis', {
-            image: 'redis:7-alpine',
-            hostPort: 16379,
-        });
-        expect(db.port).toBe(6379);
-        expect(db.hostPort).toBe(16379);
-        expect(db.connectionString).toBe('redis://localhost:16379');
-        await db.destroy();
-    });
-    test('creates a redis database with password', async () => {
-        const db = await database('test-redis-auth', {
-            image: 'redis:7-alpine',
-            hostPort: 16380,
-            env: {
-                REDIS_PASSWORD: 'secret',
-            },
-        });
-        expect(db.connectionString).toBe('redis://:secret@localhost:16380');
-        await db.destroy();
-    });
-    test('attaches database to network', async () => {
-        const network = await Network('test-db-net');
-        const db = await database('test-db-networked', {
-            image: 'redis:7-alpine',
-            networks: [network],
-            hostPort: 16381,
-        });
-        const ip = await db.getIp('test-db-net');
-        expect(ip).toBeDefined();
-        expect(ip).not.toBe('');
-        await db.destroy();
-        await network.destroy();
-    });
-    test('database inherits container methods', async () => {
-        const db = await database('test-db-methods', {
-            image: 'redis:7-alpine',
-            hostPort: 16382,
-        });
-        await db.waitForLog('Ready to accept connections', 10000);
-        const result = await db.exec(['redis-cli', 'PING']);
-        expect(result.stdout.trim()).toBe('PONG');
-        const stats = await db.stats();
-        expect(stats.cpu).toBeDefined();
-        await db.destroy();
-    });
-});

package/dist/__tests__/docker-infra.template.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=docker-infra.template.d.ts.map

package/dist/__tests__/docker-infra.template.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docker-infra.template.d.ts","sourceRoot":"","sources":["../../src/__tests__/docker-infra.template.ts"],"names":[],"mappings":""}

package/dist/__tests__/docker-infra.template.js

@@ -1,174 +0,0 @@
-/**
- * Docker Infrastructure Test Template
- *
- * Copy and customize this file to test your project's Dockerfile and entrypoint.
- * Replace {{PROJECT_NAME}} and {{PROJECT_IMAGE}} with your values.
- *
- * This template demonstrates Harpoon's complete API for testing Docker infrastructure:
- * - Image building with buildArgs
- * - Container creation with volumes, capabilities, and user overrides
- * - Log waiting and streaming
- * - Command execution inside containers
- * - Network isolation testing
- *
- * @example
- * ```bash
- * # Copy and customize for your project
- * cp docker-infra.template.ts my-project.test.ts
- * # Edit PROJECT config and tests
- * bun test my-project.test.ts
- * ```
- */
-import { describe, test, expect, beforeAll, afterEach, setDefaultTimeout } from 'bun:test';
-import { Image, Container, Network, destroyAll } from '@docker-harpoon/core';
-// ============ PROJECT CONFIGURATION ============
-// Customize these values for your project
-const PROJECT = {
-    name: '{{PROJECT_NAME}}',
-    image: '{{PROJECT_IMAGE}}:latest',
-    context: './',
-    dockerfile: 'Dockerfile',
-    port: 3000,
-    healthPath: '/api/status',
-};
-// Set a generous timeout for Docker operations
-setDefaultTimeout(120_000);
-describe(`${PROJECT.name} Docker Infrastructure`, () => {
-    beforeAll(async () => {
-        // Build the project image
-        await Image(PROJECT.image, {
-            context: PROJECT.context,
-            dockerfile: PROJECT.dockerfile,
-            buildArgs: { SEED_DATABASE: 'true' },
-        });
-    });
-    afterEach(async () => {
-        await destroyAll();
-    });
-    // ============ HEALTH CHECK TEST ============
-    test('health check responds 200', async () => {
-        const container = await Container('test-health', {
-            image: PROJECT.image,
-            env: { PORT: String(PROJECT.port) },
-            ports: [{ internal: PROJECT.port, external: 13000 }],
-        });
-        await container.waitForLog(/listening|started|ready/i, 30000);
-        const res = await fetch(`http://localhost:13000${PROJECT.healthPath}`);
-        expect(res.status).toBe(200);
-    });
-    // ============ VOLUME MOUNT TEST ============
-    test('db snapshot copy-on-boot pattern', async () => {
-        const container = await Container('test-snapshot', {
-            image: PROJECT.image,
-            env: {
-                DB_SOURCE: '/data/snapshot/app.db',
-                DB_PATH: '/app/data/test.db',
-            },
-            volumes: [
-                { hostPath: '/tmp/test-snapshot.db', containerPath: '/data/snapshot/app.db', readonly: true },
-            ],
-        });
-        await container.waitForLog(/snapshot copied|database ready/i, 30000);
-    });
-    // ============ FILE SYSTEM TEST ============
-    test('file upload directory setup', async () => {
-        const container = await Container('test-uploads', {
-            image: PROJECT.image,
-            env: { FILE_UPLOAD_PATH: '/app/custom-uploads' },
-        });
-        await container.waitForLog(/upload directory|ensuring/i, 10000);
-        const result = await container.exec(['ls', '-la', '/app/custom-uploads']);
-        expect(result.exitCode).toBe(0);
-        expect(result.stdout).toContain('drwx'); // Directory exists with permissions
-    });
-    // ============ NETWORK ISOLATION TEST ============
-    test('network isolation with iptables', async () => {
-        const network = await Network('isolated-net');
-        const container = await Container('test-isolation', {
-            image: PROJECT.image,
-            networks: [network],
-            env: { ENABLE_NETWORK_ISOLATION: 'true' },
-            capAdd: ['NET_ADMIN'],
-        });
-        await container.waitForLog(/network isolation configured|iptables/i, 15000);
-    });
-    // ============ PRIVILEGE DROPPING TEST ============
-    test('privilege dropping', async () => {
-        const container = await Container('test-privileges', {
-            image: PROJECT.image,
-        });
-        await container.waitForLog(/dropping privileges|started/i, 15000);
-        const result = await container.exec(['whoami']);
-        expect(result.exitCode).toBe(0);
-        expect(result.stdout.trim()).not.toBe('root');
-    });
-    // ============ ENVIRONMENT VARIABLE TEST ============
-    test('environment variable propagation', async () => {
-        const container = await Container('test-env', {
-            image: PROJECT.image,
-            env: {
-                PORT: '8080',
-                LOG_LEVEL: 'debug',
-                CUSTOM_VAR: 'test-value',
-            },
-            ports: [{ internal: 8080, external: 18080 }],
-        });
-        await container.waitForLog(/listening|started/i, 30000);
-        // Verify env vars are set
-        const envResult = await container.exec(['printenv']);
-        expect(envResult.stdout).toContain('PORT=8080');
-        expect(envResult.stdout).toContain('LOG_LEVEL=debug');
-        expect(envResult.stdout).toContain('CUSTOM_VAR=test-value');
-    });
-    // ============ USER OVERRIDE TEST ============
-    test('user override', async () => {
-        const container = await Container('test-user', {
-            image: PROJECT.image,
-            user: '1000:1000',
-        });
-        await container.waitForLog(/started|ready/i, 15000);
-        const result = await container.exec(['id']);
-        expect(result.exitCode).toBe(0);
-        expect(result.stdout).toContain('uid=1000');
-        expect(result.stdout).toContain('gid=1000');
-    });
-    // ============ CAPABILITIES TEST ============
-    test('dropped capabilities', async () => {
-        const container = await Container('test-caps', {
-            image: PROJECT.image,
-            capDrop: ['ALL'],
-            capAdd: ['NET_BIND_SERVICE'],
-        });
-        await container.waitForLog(/started|ready/i, 15000);
-        // Container should be running with minimal capabilities
-        const result = await container.exec(['cat', '/proc/1/status']);
-        expect(result.exitCode).toBe(0);
-        // CapEff should show limited capabilities
-        expect(result.stdout).toContain('CapEff');
-    });
-    // ============ GRACEFUL SHUTDOWN TEST ============
-    test('graceful shutdown', async () => {
-        const container = await Container('test-shutdown', {
-            image: PROJECT.image,
-            env: { PORT: String(PROJECT.port) },
-        });
-        await container.waitForLog(/listening|started|ready/i, 30000);
-        const metadata = await container.stop('SIGTERM', 10000);
-        expect(metadata.graceful).toBe(true);
-        expect(metadata.signal).toBe('SIGTERM');
-    });
-    // ============ RESOURCE STATS TEST ============
-    test('container stats', async () => {
-        const container = await Container('test-stats', {
-            image: PROJECT.image,
-            env: { PORT: String(PROJECT.port) },
-        });
-        await container.waitForLog(/listening|started|ready/i, 30000);
-        const stats = await container.stats();
-        expect(stats.cpu).toBeDefined();
-        expect(stats.cpu.percent).toBeGreaterThanOrEqual(0);
-        expect(stats.memory).toBeDefined();
-        expect(stats.memory.usage).toBeGreaterThan(0);
-        expect(stats.network).toBeDefined();
-    });
-});

package/dist/__tests__/network.test.d.ts

@@ -1,10 +0,0 @@
-/**
- * Network Resource Integration Tests
- *
- * Dogfoods the Network resource to verify:
- * - Creation and destruction
- * - Property access (id, name)
- * - Duplicate network handling
- */
-export {};
-//# sourceMappingURL=network.test.d.ts.map

package/dist/__tests__/network.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"network.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/network.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/network.test.js

@@ -1,44 +0,0 @@
-/**
- * Network Resource Integration Tests
- *
- * Dogfoods the Network resource to verify:
- * - Creation and destruction
- * - Property access (id, name)
- * - Duplicate network handling
- */
-import { describe, test, expect, afterEach, setDefaultTimeout } from 'bun:test';
-import { Network, destroyAll } from '../index';
-setDefaultTimeout(30_000);
-describe('Network', () => {
-    afterEach(async () => {
-        await destroyAll();
-    });
-    test('creates a network and returns resource with id and name', async () => {
-        const network = await Network('test-network-basic');
-        expect(network.id).toBeDefined();
-        expect(network.id.length).toBeGreaterThan(0);
-        expect(network.name).toBe('test-network-basic');
-        await network.destroy();
-    });
-    test('allows custom driver configuration', async () => {
-        const network = await Network('test-network-custom', {
-            driver: 'bridge',
-        });
-        expect(network.name).toBe('test-network-custom');
-        expect(network.id).toBeDefined();
-        await network.destroy();
-    });
-    test('handles creating network with same name (replaces existing)', async () => {
-        const network1 = await Network('test-network-duplicate');
-        const id1 = network1.id;
-        const network2 = await Network('test-network-duplicate');
-        const id2 = network2.id;
-        expect(id2).not.toBe(id1);
-        await network2.destroy();
-    });
-    test('destroy is idempotent', async () => {
-        const network = await Network('test-network-idempotent');
-        await network.destroy();
-        expect(network.destroy()).resolves.toBeUndefined();
-    });
-});

package/dist/__tests__/test-setup.d.ts

@@ -1,9 +0,0 @@
-/**
- * Shared test setup for integration tests.
- *
- * Builds a minimal test image that can be used across all tests,
- * ensuring tests are self-contained and don't rely on external images.
- */
-export declare const TEST_IMAGE = "harpoon-test:latest";
-export declare function buildTestImage(): Promise<void>;
-//# sourceMappingURL=test-setup.d.ts.map

package/dist/__tests__/test-setup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../../src/__tests__/test-setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,UAAU,wBAAwB,CAAC;AAIhD,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAWpD"}

package/dist/__tests__/test-setup.js

@@ -1,20 +0,0 @@
-/**
- * Shared test setup for integration tests.
- *
- * Builds a minimal test image that can be used across all tests,
- * ensuring tests are self-contained and don't rely on external images.
- */
-import { Image } from '../index';
-import { join } from 'path';
-export const TEST_IMAGE = 'harpoon-test:latest';
-let imageBuilt = false;
-export async function buildTestImage() {
-    if (imageBuilt) {
-        return;
-    }
-    await Image(TEST_IMAGE, {
-        context: join(__dirname, 'fixtures'),
-        dockerfile: 'Dockerfile',
-    });
-    imageBuilt = true;
-}