@jmruthers/pace-core 0.5.74 → 0.5.76

package/src/components/DataTable/utils/__tests__/rowUtils.test.ts

@@ -0,0 +1,265 @@
+/**
+ * @file Unit Tests for rowUtils
+ * @package @jmruthers/pace-core
+ * @module Components/DataTable/Utils/__tests__
+ */
+
+import { describe, it, expect } from 'vitest';
+import { getRowIdSafe, hasValidRowId } from '../rowUtils';
+import type { GetRowId, DataRecord } from '../../types';
+
+describe('[unit] getRowIdSafe', () => {
+  it('uses custom getRowId when provided', () => {
+    const customGetRowId: GetRowId<DataRecord> = (row: DataRecord) => `custom-${(row as any).id}`;
+    const row = { id: 'test-123' };
+
+    const result = getRowIdSafe(row, 0, customGetRowId);
+
+    expect(result).toBe('custom-test-123');
+  });
+
+  it('falls back to row.id when custom getRowId not provided', () => {
+    const row = { id: 'test-123' };
+
+    const result = getRowIdSafe(row, 0);
+
+    expect(result).toBe('test-123');
+  });
+
+  it('uses index when row.id is undefined', () => {
+    const row = { name: 'Test' };
+
+    const result = getRowIdSafe(row, 0);
+    const result2 = getRowIdSafe(row, 42);
+
+    expect(result).toBe('0');
+    expect(result2).toBe('42');
+  });
+
+  it('uses index when row.id is null', () => {
+    const row = { id: null };
+
+    const result = getRowIdSafe(row, 5);
+
+    expect(result).toBe('5');
+  });
+
+  it('converts numeric IDs to strings', () => {
+    const row = { id: 123 };
+
+    const result = getRowIdSafe(row, 0);
+
+    expect(result).toBe('123');
+  });
+
+  it('converts zero to string', () => {
+    const row = { id: 0 };
+
+    const result = getRowIdSafe(row, 0);
+
+    expect(result).toBe('0');
+  });
+
+  it('handles empty string ID', () => {
+    const row = { id: '' };
+
+    const result = getRowIdSafe(row, 5);
+
+    expect(result).toBe(''); // Empty string is valid
+  });
+
+    it('handles custom getRowId that returns non-string', () => {
+      const customGetRowId = () => 123 as any;
+      const row = { id: 'test' };
+
+      const result = getRowIdSafe(row, 0, customGetRowId);
+
+      // getRowIdSafe always returns a string
+      expect(result).toBe('123');
+    });
+
+  it('preserves string IDs exactly', () => {
+    const row = { id: 'special-id_123' };
+
+    const result = getRowIdSafe(row, 0);
+
+    expect(result).toBe('special-id_123');
+  });
+
+  it('handles large indices', () => {
+    const row = { name: 'Test' };
+
+    const result = getRowIdSafe(row, 999999);
+
+    expect(result).toBe('999999');
+  });
+});
+
+describe('[unit] hasValidRowId', () => {
+  it('returns true for valid string ID', () => {
+    const row = { id: 'valid-id-123' };
+
+    const result = hasValidRowId(row);
+
+    expect(result).toBe(true);
+  });
+
+  it('returns false for index fallback (numeric "0")', () => {
+    const row = { name: 'Test' };
+
+    const result = hasValidRowId(row);
+
+    expect(result).toBe(false);
+  });
+
+  it('returns false for empty string ID', () => {
+    const row = { id: '' };
+
+    const result = hasValidRowId(row);
+
+    expect(result).toBe(false);
+  });
+
+  it('returns false for "undefined" string', () => {
+    const row = { id: 'undefined' };
+
+    const result = hasValidRowId(row);
+
+    expect(result).toBe(false);
+  });
+
+  it('returns false for "null" string', () => {
+    const row = { id: 'null' };
+
+    const result = hasValidRowId(row);
+
+    expect(result).toBe(false);
+  });
+
+  it('returns true for valid numeric ID as string', () => {
+    const row = { id: '123' };
+
+    const result = hasValidRowId(row);
+
+    expect(result).toBe(true);
+  });
+
+  it('returns true for UUID format ID', () => {
+    const row = { id: '550e8400-e29b-41d4-a716-446655440000' };
+
+    const result = hasValidRowId(row);
+
+    expect(result).toBe(true);
+  });
+
+  it('uses custom getRowId when provided', () => {
+    const customGetRowId: GetRowId<DataRecord> = () => 'custom-valid-id';
+    const row = { id: '' };
+
+    const result = hasValidRowId(row, customGetRowId);
+
+    expect(result).toBe(true);
+  });
+
+  it('returns false when custom getRowId returns invalid ID', () => {
+    const customGetRowId: GetRowId<DataRecord> = () => '0';
+    const row = { id: 'valid' };
+
+    const result = hasValidRowId(row, customGetRowId);
+
+    expect(result).toBe(false);
+  });
+
+  it('handles getRowId errors gracefully', () => {
+    const errorGetRowId = () => {
+      throw new Error('GetRowId failed');
+    };
+
+    const row = { id: 'test' };
+
+    const result = hasValidRowId(row, errorGetRowId as any);
+
+    expect(result).toBe(false);
+  });
+
+  it('returns true for complex valid IDs', () => {
+    const row = { id: 'user-123-item-456-action_789' };
+
+    const result = hasValidRowId(row);
+
+    expect(result).toBe(true);
+  });
+
+  it('returns false for edge case invalid IDs', () => {
+    const invalidIds = ['0', '', 'undefined', 'null'];
+    
+    invalidIds.forEach(invalidId => {
+      const row = { id: invalidId };
+      const result = hasValidRowId(row);
+      expect(result).toBe(false);
+    });
+  });
+
+  it('returns true for edge case valid IDs', () => {
+    const validIds = ['1', 'a', 'A', '123', 'abc-123'];
+    
+    validIds.forEach(validId => {
+      const row = { id: validId };
+      const result = hasValidRowId(row);
+      expect(result).toBe(true);
+    });
+  });
+
+  it('handles null and undefined in custom getRowId by falling back', () => {
+    const customGetRowId1: GetRowId<DataRecord> = () => null as any;
+    const customGetRowId2: GetRowId<DataRecord> = () => undefined as any;
+    const row = { id: 'test' };
+
+    // When custom getRowId returns null/undefined, it falls back to row.id
+    expect(hasValidRowId(row, customGetRowId1)).toBe(true); // row.id='test' is valid
+    expect(hasValidRowId(row, customGetRowId2)).toBe(true); // row.id='test' is valid
+    
+    // Test with row that has no id
+    const rowNoId = { name: 'Test' };
+    expect(hasValidRowId(rowNoId, customGetRowId1)).toBe(false); // Falls back to index '0'
+    expect(hasValidRowId(rowNoId, customGetRowId2)).toBe(false); // Falls back to index '0'
+  });
+});
+
+describe('[unit] Integration', () => {
+  it('getRowIdSafe and hasValidRowId work together', () => {
+    const row = { id: 'test-id-123' };
+
+    const rowId = getRowIdSafe(row, 0);
+    const isValid = hasValidRowId(row);
+
+    expect(rowId).toBe('test-id-123');
+    expect(isValid).toBe(true);
+  });
+
+  it('hasValidRowId correctly identifies getRowIdSafe fallback cases', () => {
+    const rowWithValidId = { id: 'valid' };
+    const rowWithoutId = { name: 'Test' };
+
+    expect(hasValidRowId(rowWithValidId)).toBe(true);
+    expect(hasValidRowId(rowWithoutId)).toBe(false);
+  });
+
+  it('handles various row structures', () => {
+    const testCases = [
+      { row: { id: 'abc' }, expected: true },
+      { row: { id: '' }, expected: false },
+      { row: { id: '0' }, expected: false },
+      { row: { id: '1' }, expected: true },
+      { row: { id: null }, getRowId: undefined, expected: false },
+      { row: { id: undefined }, expected: false },
+      { row: { name: 'Test' }, expected: false },
+    ];
+
+    testCases.forEach(({ row, getRowId, expected }) => {
+      const result = hasValidRowId(row, getRowId);
+      expect(result).toBe(expected);
+    });
+  });
+});
+