@figulus/schema 0.4.0-alpha-dev

package/tests/schemas.test.ts

@@ -0,0 +1,187 @@
+/**
+ * Zod Schema Validation Tests
+ *
+ * Tests that Zod schemas correctly validate and reject data.
+ * Focuses on the most commonly used request schemas: RunRequest,
+ * CreateSessionRequest, and SyncFileRequest.
+ */
+
+import { describe, it, expect } from 'vitest';
+import {
+  RunRequestSchema,
+  JobStatusSchema,
+  CreateSessionRequestSchema,
+  SyncFileRequestSchema,
+} from '../src/index.js';
+
+describe('Zod Schema Validation', () => {
+  describe('RunRequest Schema', () => {
+    it('should validate a minimal valid request', () => {
+      const valid = { job_id: 'job-001', image: 'node:20-alpine' };
+      expect(() => RunRequestSchema.parse(valid)).not.toThrow();
+    });
+
+    it('should validate a fully populated request', () => {
+      const valid = {
+        job_id: 'job-002',
+        image: 'node:20-alpine',
+        command: ['node', 'index.js'],
+        environment: { NODE_ENV: 'test' },
+        volumes: [{ host_path: '/tmp/src', container_path: '/app', read_only: false }],
+        named_volumes: [{ volume_name: 'cache', container_path: '/root/.npm', read_only: false }],
+        resources: { memory_limit: '512M', cpu_limit: '1' },
+        timeout: 300,
+        working_dir: '/app',
+        network_mode: 'bridge',
+        ports: [{ container: 3000, host: 8080 }],
+      };
+      expect(() => RunRequestSchema.parse(valid)).not.toThrow();
+    });
+
+    it('should reject missing job_id', () => {
+      const invalid = { image: 'node:20-alpine' };
+      expect(() => RunRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject missing image', () => {
+      const invalid = { job_id: 'job-001' };
+      expect(() => RunRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject empty job_id', () => {
+      const invalid = { job_id: '', image: 'node:20-alpine' };
+      expect(() => RunRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject negative timeout', () => {
+      const invalid = { job_id: 'job-001', image: 'node:20', timeout: -1 };
+      expect(() => RunRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject timeout exceeding max', () => {
+      const invalid = { job_id: 'job-001', image: 'node:20', timeout: 99999 };
+      expect(() => RunRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject non-integer timeout', () => {
+      const invalid = { job_id: 'job-001', image: 'node:20', timeout: 30.5 };
+      expect(() => RunRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject invalid port number', () => {
+      const invalid = {
+        job_id: 'job-001',
+        image: 'node:20',
+        ports: [{ container: 99999 }],
+      };
+      expect(() => RunRequestSchema.parse(invalid)).toThrow();
+    });
+  });
+
+  describe('JobStatus Schema', () => {
+    it('should accept all valid status values', () => {
+      const validValues = ['pending', 'running', 'completed', 'failed', 'timeout', 'awaiting_cleanup'];
+      for (const val of validValues) {
+        expect(() => JobStatusSchema.parse(val)).not.toThrow();
+      }
+    });
+
+    it('should reject invalid status values', () => {
+      expect(() => JobStatusSchema.parse('cancelled')).toThrow();
+      expect(() => JobStatusSchema.parse('done')).toThrow();
+      expect(() => JobStatusSchema.parse('')).toThrow();
+    });
+  });
+
+  describe('CreateSessionRequest Schema', () => {
+    it('should validate a minimal valid request', () => {
+      const valid = { image_tag: 'localhost:5000/figulus:sha256-abc123' };
+      expect(() => CreateSessionRequestSchema.parse(valid)).not.toThrow();
+    });
+
+    it('should validate a request with config', () => {
+      const valid = {
+        image_tag: 'localhost:5000/figulus:sha256-abc123',
+        ttl: 600,
+        config: {
+          working_dir: '/app',
+          environment: { NODE_ENV: 'development' },
+          init_cmd: ['npm', 'install'],
+          ports: [{ container: 3000 }],
+        },
+      };
+      expect(() => CreateSessionRequestSchema.parse(valid)).not.toThrow();
+    });
+
+    it('should reject missing image_tag', () => {
+      const invalid = { ttl: 600 };
+      expect(() => CreateSessionRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject empty image_tag', () => {
+      const invalid = { image_tag: '' };
+      expect(() => CreateSessionRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject negative ttl', () => {
+      const invalid = { image_tag: 'some-image:latest', ttl: -1 };
+      expect(() => CreateSessionRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject non-integer ttl', () => {
+      const invalid = { image_tag: 'some-image:latest', ttl: 60.5 };
+      expect(() => CreateSessionRequestSchema.parse(invalid)).toThrow();
+    });
+  });
+
+  describe('SyncFileRequest Schema', () => {
+    it('should validate a valid base64 request', () => {
+      const valid = {
+        targetPath: '/app/src/index.ts',
+        content: 'Y29uc29sZS5sb2coImhlbGxvIik=',
+        encoding: 'base64',
+      };
+      expect(() => SyncFileRequestSchema.parse(valid)).not.toThrow();
+    });
+
+    it('should validate a valid utf8 request', () => {
+      const valid = {
+        targetPath: '/app/src/index.ts',
+        content: 'console.log("hello")',
+        encoding: 'utf8',
+      };
+      expect(() => SyncFileRequestSchema.parse(valid)).not.toThrow();
+    });
+
+    it('should default encoding to base64 when omitted', () => {
+      const input = { targetPath: '/app/src/index.ts', content: 'abc' };
+      const result = SyncFileRequestSchema.parse(input);
+      expect(result.encoding).toBe('base64');
+    });
+
+    it('should reject missing targetPath', () => {
+      const invalid = { content: 'abc', encoding: 'base64' };
+      expect(() => SyncFileRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject empty targetPath', () => {
+      const invalid = { targetPath: '', content: 'abc', encoding: 'base64' };
+      expect(() => SyncFileRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject missing content', () => {
+      const invalid = { targetPath: '/app/file.ts', encoding: 'base64' };
+      expect(() => SyncFileRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject empty content', () => {
+      const invalid = { targetPath: '/app/file.ts', content: '', encoding: 'base64' };
+      expect(() => SyncFileRequestSchema.parse(invalid)).toThrow();
+    });
+
+    it('should reject invalid encoding value', () => {
+      const invalid = { targetPath: '/app/file.ts', content: 'abc', encoding: 'hex' };
+      expect(() => SyncFileRequestSchema.parse(invalid)).toThrow();
+    });
+  });
+});

package/tsconfig.build.json

@@ -0,0 +1,11 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "outDir": "./dist",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "exclude": ["tests/**/*", "node_modules"]
+}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*.ts", "tests/**/*.ts"]
+}