✅ test: Add unit tests for validation, errors, and client

Author: DevaOnBreaches

test/client.test.ts

@@ -0,0 +1,36 @@
+import { describe, it, expect } from 'vitest';
+import { XposedOrNot } from '../src/client.js';
+import { ValidationError } from '../src/errors/index.js';
+
+describe('XposedOrNot client', () => {
+  it('creates client with default config', () => {
+    const client = new XposedOrNot();
+    expect(client).toBeInstanceOf(XposedOrNot);
+  });
+
+  it('creates client with custom config', () => {
+    const client = new XposedOrNot({
+      timeout: 5000,
+      retries: 5,
+    });
+    expect(client).toBeInstanceOf(XposedOrNot);
+  });
+
+  it('rejects non-HTTPS baseUrl', () => {
+    expect(() => new XposedOrNot({ baseUrl: 'http://api.example.com' })).toThrow(ValidationError);
+  });
+
+  it('rejects invalid baseUrl', () => {
+    expect(() => new XposedOrNot({ baseUrl: 'not-a-url' })).toThrow(ValidationError);
+  });
+
+  it('rejects timeout out of range', () => {
+    expect(() => new XposedOrNot({ timeout: 100 })).toThrow(ValidationError);
+    expect(() => new XposedOrNot({ timeout: 999999 })).toThrow(ValidationError);
+  });
+
+  it('rejects retries out of range', () => {
+    expect(() => new XposedOrNot({ retries: -1 })).toThrow(ValidationError);
+    expect(() => new XposedOrNot({ retries: 20 })).toThrow(ValidationError);
+  });
+});

test/errors.test.ts

@@ -0,0 +1,75 @@
+import { describe, it, expect } from 'vitest';
+import {
+  XposedOrNotError,
+  ValidationError,
+  RateLimitError,
+  NotFoundError,
+  NetworkError,
+  TimeoutError,
+  ApiError,
+} from '../src/errors/index.js';
+
+describe('XposedOrNotError', () => {
+  it('has correct properties', () => {
+    const error = new XposedOrNotError('Test error', 'TEST_CODE', 500);
+    expect(error.message).toBe('Test error');
+    expect(error.code).toBe('TEST_CODE');
+    expect(error.statusCode).toBe(500);
+    expect(error.name).toBe('XposedOrNotError');
+  });
+});
+
+describe('ValidationError', () => {
+  it('has correct properties', () => {
+    const error = new ValidationError('Invalid email', 'email');
+    expect(error.message).toBe('Invalid email');
+    expect(error.field).toBe('email');
+    expect(error.code).toBe('VALIDATION_ERROR');
+    expect(error.name).toBe('ValidationError');
+  });
+});
+
+describe('RateLimitError', () => {
+  it('has correct defaults', () => {
+    const error = new RateLimitError();
+    expect(error.statusCode).toBe(429);
+    expect(error.code).toBe('RATE_LIMIT_EXCEEDED');
+  });
+
+  it('includes retryAfter', () => {
+    const error = new RateLimitError('Too many requests', 60);
+    expect(error.retryAfter).toBe(60);
+  });
+});
+
+describe('NotFoundError', () => {
+  it('has correct defaults', () => {
+    const error = new NotFoundError();
+    expect(error.statusCode).toBe(404);
+    expect(error.code).toBe('NOT_FOUND');
+  });
+});
+
+describe('NetworkError', () => {
+  it('has correct properties', () => {
+    const cause = new Error('Connection refused');
+    const error = new NetworkError('Network failed', cause);
+    expect(error.code).toBe('NETWORK_ERROR');
+    expect(error.cause).toBe(cause);
+  });
+});
+
+describe('TimeoutError', () => {
+  it('has correct properties', () => {
+    const error = new TimeoutError();
+    expect(error.code).toBe('TIMEOUT');
+  });
+});
+
+describe('ApiError', () => {
+  it('has correct properties', () => {
+    const error = new ApiError('Server error', 500, { detail: 'Internal error' });
+    expect(error.statusCode).toBe(500);
+    expect(error.response).toEqual({ detail: 'Internal error' });
+  });
+});

test/validation.test.ts

@@ -0,0 +1,46 @@
+import { describe, it, expect } from 'vitest';
+import { validateEmail, validateDomain, normalizeEmail } from '../src/utils/validation.js';
+import { ValidationError } from '../src/errors/index.js';
+
+describe('validateEmail', () => {
+  it('accepts valid emails', () => {
+    expect(() => validateEmail('test@example.com')).not.toThrow();
+    expect(() => validateEmail('user.name@domain.org')).not.toThrow();
+    expect(() => validateEmail('user+tag@example.co.uk')).not.toThrow();
+  });
+
+  it('rejects non-string input', () => {
+    expect(() => validateEmail(null)).toThrow(ValidationError);
+    expect(() => validateEmail(undefined)).toThrow(ValidationError);
+    expect(() => validateEmail(123)).toThrow(ValidationError);
+  });
+
+  it('rejects empty string', () => {
+    expect(() => validateEmail('')).toThrow(ValidationError);
+    expect(() => validateEmail('   ')).toThrow(ValidationError);
+  });
+
+  it('rejects invalid email format', () => {
+    expect(() => validateEmail('notanemail')).toThrow(ValidationError);
+    expect(() => validateEmail('missing@domain')).toThrow(ValidationError);
+    expect(() => validateEmail('@nodomain.com')).toThrow(ValidationError);
+  });
+});
+
+describe('validateDomain', () => {
+  it('accepts valid domains', () => {
+    expect(() => validateDomain('example.com')).not.toThrow();
+    expect(() => validateDomain('sub.domain.org')).not.toThrow();
+  });
+
+  it('rejects invalid domains', () => {
+    expect(() => validateDomain('')).toThrow(ValidationError);
+    expect(() => validateDomain('invalid')).toThrow(ValidationError);
+  });
+});
+
+describe('normalizeEmail', () => {
+  it('trims whitespace and lowercases', () => {
+    expect(normalizeEmail('  Test@Example.COM  ')).toBe('test@example.com');
+  });
+});