@xeno-js/shared 0.1.0

package/dist/shared/utils/__tests__/http.utils.test.js

@@ -0,0 +1,230 @@
+import { describe, expect, it } from 'vitest';
+import { HttpHelper } from '../../../shared';
+const VALID_GUID = '550e8400-e29b-41d4-a716-446655440000';
+describe('HttpHelper.normalizeHeaders', () => {
+    describe('non-object / falsy input', () => {
+        it('returns {} when headers is undefined', () => {
+            expect(HttpHelper.normalizeHeaders(undefined)).toEqual({});
+        });
+        it('returns {} when headers is null', () => {
+            expect(HttpHelper.normalizeHeaders(null)).toEqual({});
+        });
+        it('returns {} when headers is empty string', () => {
+            expect(HttpHelper.normalizeHeaders('')).toEqual({});
+        });
+        it('returns {} when headers is false', () => {
+            expect(HttpHelper.normalizeHeaders(false)).toEqual({});
+        });
+        it('returns {} when headers is a number', () => {
+            expect(HttpHelper.normalizeHeaders(42)).toEqual({});
+        });
+        it('returns {} when headers is a non-empty plain string', () => {
+            expect(HttpHelper.normalizeHeaders('content-type: text/html')).toEqual({});
+        });
+    });
+    describe('array input (typeof === object)', () => {
+        it('treats array as object with numeric keys', () => {
+            expect(HttpHelper.normalizeHeaders(['a', 'b'])).toEqual({ '0': 'a', '1': 'b' });
+        });
+    });
+    describe('valid plain-object input', () => {
+        it('returns {} when headers is an empty object', () => {
+            expect(HttpHelper.normalizeHeaders({})).toEqual({});
+        });
+        it('skips keys with undefined value', () => {
+            expect(HttpHelper.normalizeHeaders({ a: undefined })).toEqual({});
+        });
+        it('skips keys with null value', () => {
+            expect(HttpHelper.normalizeHeaders({ a: null })).toEqual({});
+        });
+        it('skips keys with false value', () => {
+            expect(HttpHelper.normalizeHeaders({ a: false })).toEqual({ a: 'false' });
+        });
+        it('converts string values as-is', () => {
+            expect(HttpHelper.normalizeHeaders({ 'content-type': 'application/json' })).toEqual({
+                'content-type': 'application/json',
+            });
+        });
+        it('converts numeric values to string', () => {
+            expect(HttpHelper.normalizeHeaders({ 'x-retry': 3 })).toEqual({ 'x-retry': '3' });
+        });
+        it('converts true boolean to string', () => {
+            expect(HttpHelper.normalizeHeaders({ 'x-flag': true })).toEqual({ 'x-flag': 'true' });
+        });
+        it('joins array values with comma', () => {
+            expect(HttpHelper.normalizeHeaders({ accept: ['text/html', 'application/json'] })).toEqual({
+                accept: 'text/html,application/json',
+            });
+        });
+        it('joins array of numbers to comma-separated string', () => {
+            expect(HttpHelper.normalizeHeaders({ ids: [1, 2, 3] })).toEqual({ ids: '1,2,3' });
+        });
+        it('processes multiple keys, skipping undefined ones', () => {
+            expect(HttpHelper.normalizeHeaders({
+                'content-type': 'application/json',
+                'accept': ['text/html', 'application/xml'],
+                'x-count': 5,
+                'skip': undefined,
+            })).toEqual({
+                'content-type': 'application/json',
+                'accept': 'text/html,application/xml',
+                'x-count': '5',
+            });
+        });
+    });
+    describe('immutability', () => {
+        it('HttpHelper is frozen', () => {
+            expect(Object.isFrozen(HttpHelper)).toBe(true);
+        });
+        it('does not mutate the input object', () => {
+            const input = { a: 'value' };
+            HttpHelper.normalizeHeaders(input);
+            expect(input).toEqual({ a: 'value' });
+        });
+    });
+});
+describe('HttpHelper.success', () => {
+    it('returns ok=true with default status 200', () => {
+        const res = HttpHelper.success({ id: 1 });
+        expect(res.ok).toBe(true);
+        expect(res.status).toBe(200);
+    });
+    it('wraps data in SuccessResponseDto shape', () => {
+        const res = HttpHelper.success('hello');
+        expect(res.data).toMatchObject({ success: true, data: 'hello', meta: {} });
+    });
+    it('accepts a custom status code', () => {
+        const res = HttpHelper.success(null, 201);
+        expect(res.status).toBe(201);
+    });
+    it('forwards custom meta', () => {
+        const res = HttpHelper.success({}, 200, { page: 1 });
+        expect(res.data.meta).toEqual({ page: 1 });
+    });
+    it('includes default Content-Type header', () => {
+        const res = HttpHelper.success({});
+        expect(res.headers['Content-Type']).toEqual(['application/json']);
+    });
+    it('merges custom headers with Content-Type', () => {
+        const res = HttpHelper.success({}, 200, {}, { 'X-Custom': 'value' });
+        expect(res.headers['X-Custom']).toBe('value');
+        expect(res.headers['Content-Type']).toEqual(['application/json']);
+    });
+    it('custom header does not override Content-Type', () => {
+        const res = HttpHelper.success({}, 200, {}, { 'Content-Type': 'text/plain' });
+        expect(res.headers['Content-Type']).toEqual(['application/json']);
+    });
+    it('supports paginated data', () => {
+        const paginatedData = {
+            items: ['item1', 'item2'],
+            total: 2,
+            page: 1,
+            pageSize: 10,
+            totalPages: 1,
+            hasNextPage: false,
+            hasPreviousPage: false,
+        };
+        const res = HttpHelper.success(paginatedData);
+        expect(res.data).toMatchObject({ success: true, data: paginatedData, meta: {} });
+    });
+});
+describe('HttpHelper.error', () => {
+    const errorBase = {
+        success: false,
+        error: { code: 'ERR', message: 'fail', details: undefined, path: undefined },
+        correlationId: VALID_GUID,
+        requestId: VALID_GUID,
+        spanId: VALID_GUID,
+        timestamp: new Date().toISOString(),
+    };
+    it('returns ok=false', () => {
+        const res = HttpHelper.error(errorBase);
+        expect(res.ok).toBe(false);
+    });
+    it('uses provided status', () => {
+        const res = HttpHelper.error(errorBase, 404);
+        expect(res.status).toBe(404);
+    });
+    it('defaults to 500 when status is null', () => {
+        const res = HttpHelper.error(errorBase, undefined);
+        expect(res.status).toBe(500);
+    });
+    it('sets error code and message in payload', () => {
+        const dto = {
+            ...errorBase,
+            error: {
+                code: 'NOT_FOUND',
+                message: 'resource missing',
+                details: undefined,
+                path: undefined,
+            },
+        };
+        const res = HttpHelper.error(dto);
+        const payload = res.data;
+        expect(payload.error.code).toBe('NOT_FOUND');
+        expect(payload.error.message).toBe('resource missing');
+    });
+    it('sets details when provided', () => {
+        const dto = {
+            ...errorBase,
+            error: { code: 'ERR', message: 'fail', details: 'stack trace', path: undefined },
+        };
+        const res = HttpHelper.error(dto);
+        const payload = res.data;
+        expect(payload.error.details).toBe('stack trace');
+    });
+    it('sets details to undefined when null', () => {
+        const res = HttpHelper.error(errorBase);
+        const payload = res.data;
+        expect(payload.error.details).toBeUndefined();
+    });
+    it('uses provided correlationId', () => {
+        const cid = 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa';
+        const dto = { ...errorBase, correlationId: cid };
+        const res = HttpHelper.error(dto);
+        const payload = res.data;
+        expect(payload.correlationId).toBe(cid);
+        expect(res.headers['X-Correlation-Id']).toEqual([cid]);
+    });
+    it('uses correlationId when provided', () => {
+        const res = HttpHelper.error(errorBase);
+        const payload = res.data;
+        expect(typeof payload.correlationId).toBe('string');
+        expect(payload.correlationId.length).toBeGreaterThan(0);
+    });
+    it('uses provided requestId', () => {
+        const rid = 'bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb';
+        const dto = { ...errorBase, requestId: rid };
+        const res = HttpHelper.error(dto);
+        const payload = res.data;
+        expect(payload.requestId).toBe(rid);
+        expect(res.headers['X-Request-Id']).toEqual([rid]);
+    });
+    it('uses requestId when provided', () => {
+        const res = HttpHelper.error(errorBase);
+        const payload = res.data;
+        expect(typeof payload.requestId).toBe('string');
+    });
+    it('includes standard error headers', () => {
+        const res = HttpHelper.error(errorBase);
+        expect(res.headers['Content-Type']).toEqual(['application/json']);
+        expect(res.headers['Cache-Control']).toEqual([
+            'no-store, no-cache, must-revalidate, proxy-revalidate',
+        ]);
+        expect(res.headers['Pragma']).toEqual(['no-cache']);
+        expect(res.headers['Expires']).toEqual(['0']);
+    });
+    it('merges customHeaders', () => {
+        const res = HttpHelper.error(errorBase, undefined, { 'X-Retry-After': '60' });
+        expect(res.headers['X-Retry-After']).toBe('60');
+    });
+    it('handles null customHeaders without error', () => {
+        expect(() => HttpHelper.error(errorBase, undefined, undefined)).not.toThrow();
+    });
+    it('timestamp is a valid ISO string', () => {
+        const res = HttpHelper.error(errorBase);
+        const payload = res.data;
+        expect(() => new Date(payload.timestamp).toISOString()).not.toThrow();
+    });
+});
+//# sourceMappingURL=http.utils.test.js.map

package/dist/shared/utils/__tests__/http.utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.utils.test.js","sourceRoot":"","sources":["../../../../src/shared/utils/__tests__/http.utils.test.ts"],"names":[],"mappings":"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"}

package/dist/shared/utils/__tests__/math.utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=math.utils.test.d.ts.map

package/dist/shared/utils/__tests__/math.utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.utils.test.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/__tests__/math.utils.test.ts"],"names":[],"mappings":""}

package/dist/shared/utils/__tests__/math.utils.test.js

@@ -0,0 +1,93 @@
+import { describe, expect, it } from 'vitest';
+import { MathHelper } from '../../../shared';
+describe('MathHelper', () => {
+    describe('immutability', () => {
+        it('MathHelper is frozen', () => {
+            expect(Object.isFrozen(MathHelper)).toBe(true);
+        });
+    });
+    describe('clamp', () => {
+        it('returns value when within range', () => {
+            expect(MathHelper.clamp(5, 0, 10)).toBe(5);
+        });
+        it('returns min when value is below min', () => {
+            expect(MathHelper.clamp(-5, 0, 10)).toBe(0);
+        });
+        it('returns max when value is above max', () => {
+            expect(MathHelper.clamp(15, 0, 10)).toBe(10);
+        });
+        it('returns min when value equals min', () => {
+            expect(MathHelper.clamp(0, 0, 10)).toBe(0);
+        });
+        it('returns max when value equals max', () => {
+            expect(MathHelper.clamp(10, 0, 10)).toBe(10);
+        });
+        it('works with negative range', () => {
+            expect(MathHelper.clamp(-3, -10, -1)).toBe(-3);
+        });
+        it('works when min equals max', () => {
+            expect(MathHelper.clamp(7, 5, 5)).toBe(5);
+        });
+    });
+    describe('roundTo', () => {
+        it('rounds to 0 decimals', () => {
+            expect(MathHelper.roundTo(3.7, 0)).toBe(4);
+        });
+        it('rounds to 2 decimals', () => {
+            expect(MathHelper.roundTo(3.14159, 2)).toBe(3.14);
+        });
+        it('rounds up at midpoint', () => {
+            expect(MathHelper.roundTo(1.005, 2)).toBeCloseTo(1.01, 1);
+        });
+        it('rounds negative values correctly', () => {
+            expect(MathHelper.roundTo(-2.567, 2)).toBe(-2.57);
+        });
+        it('returns integer unchanged when decimals=0', () => {
+            expect(MathHelper.roundTo(5, 0)).toBe(5);
+        });
+        it('handles large decimal precision', () => {
+            expect(MathHelper.roundTo(1.123456789, 5)).toBe(1.12346);
+        });
+    });
+    describe('safeDivide', () => {
+        it('divides normally when denominator is non-zero', () => {
+            expect(MathHelper.safeDivide(10, 2)).toBe(5);
+        });
+        it('returns default fallback (0) when denominator is zero', () => {
+            expect(MathHelper.safeDivide(10, 0)).toBe(0);
+        });
+        it('returns custom fallback when denominator is zero', () => {
+            expect(MathHelper.safeDivide(10, 0, -1)).toBe(-1);
+        });
+        it('handles negative numerator', () => {
+            expect(MathHelper.safeDivide(-9, 3)).toBe(-3);
+        });
+        it('handles negative denominator', () => {
+            expect(MathHelper.safeDivide(9, -3)).toBe(-3);
+        });
+        it('returns 0 when numerator is 0', () => {
+            expect(MathHelper.safeDivide(0, 5)).toBe(0);
+        });
+    });
+    describe('toPercentage', () => {
+        it('returns correct percentage', () => {
+            expect(MathHelper.toPercentage(25, 100)).toBe(25);
+        });
+        it('returns 0 when total is 0', () => {
+            expect(MathHelper.toPercentage(10, 0)).toBe(0);
+        });
+        it('returns 100 when part equals total', () => {
+            expect(MathHelper.toPercentage(5, 5)).toBe(100);
+        });
+        it('returns 0 when part is 0', () => {
+            expect(MathHelper.toPercentage(0, 50)).toBe(0);
+        });
+        it('can exceed 100 when part > total', () => {
+            expect(MathHelper.toPercentage(150, 100)).toBe(150);
+        });
+        it('works with decimal values', () => {
+            expect(MathHelper.toPercentage(1, 3)).toBeCloseTo(33.333, 2);
+        });
+    });
+});
+//# sourceMappingURL=math.utils.test.js.map

package/dist/shared/utils/__tests__/math.utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.utils.test.js","sourceRoot":"","sources":["../../../../src/shared/utils/__tests__/math.utils.test.ts"],"names":[],"mappings":"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"}

package/dist/shared/utils/__tests__/promise.utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=promise.utils.test.d.ts.map

package/dist/shared/utils/__tests__/promise.utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.utils.test.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/__tests__/promise.utils.test.ts"],"names":[],"mappings":""}

package/dist/shared/utils/__tests__/promise.utils.test.js

@@ -0,0 +1,101 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { PromiseHelper } from '../../../shared';
+describe('PromiseHelper', () => {
+    describe('immutability', () => {
+        it('PromiseHelper is frozen', () => {
+            expect(Object.isFrozen(PromiseHelper)).toBe(true);
+        });
+    });
+    describe('delay', () => {
+        beforeEach(() => {
+            vi.useFakeTimers();
+        });
+        afterEach(() => {
+            vi.useRealTimers();
+        });
+        it('returns a Promise', () => {
+            const result = PromiseHelper.delay(100);
+            expect(result).toBeInstanceOf(Promise);
+            vi.runAllTimers();
+        });
+        it('resolves after the specified ms', async () => {
+            const p = PromiseHelper.delay(500);
+            vi.advanceTimersByTime(500);
+            await expect(p).resolves.toBeUndefined();
+        });
+        it('does not resolve before the specified ms', async () => {
+            let resolved = false;
+            const p = PromiseHelper.delay(1000).then(() => {
+                resolved = true;
+            });
+            vi.advanceTimersByTime(999);
+            // flush microtasks without completing the timer
+            await Promise.resolve();
+            expect(resolved).toBe(false);
+            vi.advanceTimersByTime(1);
+            await p;
+            expect(resolved).toBe(true);
+        });
+        it('resolves immediately with 0 ms', async () => {
+            const p = PromiseHelper.delay(0);
+            vi.advanceTimersByTime(0);
+            await expect(p).resolves.toBeUndefined();
+        });
+    });
+    describe('delayWithJitter', () => {
+        beforeEach(() => {
+            vi.useFakeTimers();
+        });
+        afterEach(() => {
+            vi.useRealTimers();
+        });
+        it('returns a Promise', () => {
+            const result = PromiseHelper.delayWithJitter(100, 50);
+            expect(result).toBeInstanceOf(Promise);
+            vi.runAllTimers();
+        });
+        it('resolves when baseDelay + maxJitter time has elapsed (jitter = maxJitterMs - 1)', async () => {
+            // Force Math.random to return ~1 so jitter ≈ maxJitterMs - 1
+            vi.spyOn(Math, 'random').mockReturnValue(0.999);
+            const base = 200;
+            const maxJitter = 100;
+            const expectedJitter = Math.floor(0.999 * maxJitter); // 99
+            const p = PromiseHelper.delayWithJitter(base, maxJitter);
+            vi.advanceTimersByTime(base + expectedJitter);
+            await expect(p).resolves.toBeUndefined();
+            vi.restoreAllMocks();
+        });
+        it('resolves with zero jitter when Math.random returns 0', async () => {
+            vi.spyOn(Math, 'random').mockReturnValue(0);
+            const p = PromiseHelper.delayWithJitter(300, 200);
+            vi.advanceTimersByTime(300); // jitter = 0
+            await expect(p).resolves.toBeUndefined();
+            vi.restoreAllMocks();
+        });
+        it('does not resolve before base + jitter elapsed', async () => {
+            vi.spyOn(Math, 'random').mockReturnValue(0.5);
+            const base = 100;
+            const maxJitter = 100;
+            const jitter = Math.floor(0.5 * maxJitter); // 50
+            let resolved = false;
+            const p = PromiseHelper.delayWithJitter(base, maxJitter).then(() => {
+                resolved = true;
+            });
+            vi.advanceTimersByTime(base + jitter - 1);
+            await Promise.resolve();
+            expect(resolved).toBe(false);
+            vi.advanceTimersByTime(1);
+            await p;
+            expect(resolved).toBe(true);
+            vi.restoreAllMocks();
+        });
+        it('resolves with base=0 and maxJitter=0', async () => {
+            vi.spyOn(Math, 'random').mockReturnValue(0);
+            const p = PromiseHelper.delayWithJitter(0, 0);
+            vi.advanceTimersByTime(0);
+            await expect(p).resolves.toBeUndefined();
+            vi.restoreAllMocks();
+        });
+    });
+});
+//# sourceMappingURL=promise.utils.test.js.map

package/dist/shared/utils/__tests__/promise.utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.utils.test.js","sourceRoot":"","sources":["../../../../src/shared/utils/__tests__/promise.utils.test.ts"],"names":[],"mappings":"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"}

package/dist/shared/utils/__tests__/string.utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=string.utils.test.d.ts.map

package/dist/shared/utils/__tests__/string.utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.utils.test.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/__tests__/string.utils.test.ts"],"names":[],"mappings":""}

package/dist/shared/utils/__tests__/string.utils.test.js

@@ -0,0 +1,153 @@
+import { describe, expect, it } from 'vitest';
+import { StringHelper } from '../../../shared';
+describe('StringHelper', () => {
+    describe('immutability', () => {
+        it('StringHelper is frozen', () => {
+            expect(Object.isFrozen(StringHelper)).toBe(true);
+        });
+    });
+    // ─── safeStringify ───────────────────────────────────────────────────────────
+    describe('safeStringify', () => {
+        it('stringifies a plain object', () => {
+            expect(StringHelper.safeStringify({ a: 1 })).toBe('{"a":1}');
+        });
+        it('stringifies a number', () => {
+            expect(StringHelper.safeStringify(42)).toBe('42');
+        });
+        it('stringifies null', () => {
+            expect(StringHelper.safeStringify(null)).toBe('null');
+        });
+        it('stringifies an array', () => {
+            expect(StringHelper.safeStringify([1, 2])).toBe('[1,2]');
+        });
+        it('falls back to String() for circular references', () => {
+            const obj = {};
+            obj['self'] = obj;
+            const result = StringHelper.safeStringify(obj);
+            expect(typeof result).toBe('string');
+            expect(result).toBe('[object Object]');
+        });
+    });
+    // ─── safeParse ───────────────────────────────────────────────────────────────
+    describe('safeParse', () => {
+        it('parses a valid JSON string', () => {
+            expect(StringHelper.safeParse('{"a":1}')).toEqual({ a: 1 });
+        });
+        it('parses a JSON number string', () => {
+            expect(StringHelper.safeParse('42')).toBe(42);
+        });
+        it('returns the original input when parsing fails and no fallback', () => {
+            expect(StringHelper.safeParse('not-json')).toBe('not-json');
+        });
+        it('returns the provided fallback when parsing fails', () => {
+            expect(StringHelper.safeParse('not-json', 'fallback')).toBe('fallback');
+        });
+        it('returns undefined fallback when parsing fails and fallback is undefined', () => {
+            expect(StringHelper.safeParse('not-json', undefined)).toBe('not-json');
+        });
+    });
+    // ─── camelCase ───────────────────────────────────────────────────────────────
+    describe('camelCase', () => {
+        it('converts snake_case to camelCase', () => {
+            expect(StringHelper.camelCase('hello_world')).toBe('helloWorld');
+        });
+        it('converts kebab-case to camelCase', () => {
+            expect(StringHelper.camelCase('hello-world')).toBe('helloWorld');
+        });
+        it('converts space-separated words to camelCase', () => {
+            expect(StringHelper.camelCase('hello world')).toBe('helloWorld');
+        });
+        it('handles multiple separators', () => {
+            expect(StringHelper.camelCase('foo_bar-baz qux')).toBe('fooBarBazQux');
+        });
+        it('returns empty string for empty input', () => {
+            expect(StringHelper.camelCase('')).toBe('');
+        });
+        it('lowercases the first segment', () => {
+            expect(StringHelper.camelCase('HELLO_WORLD')).toBe('helloWORLD');
+        });
+        it('handles single word', () => {
+            expect(StringHelper.camelCase('hello')).toBe('hello');
+        });
+    });
+    // ─── interpolate ─────────────────────────────────────────────────────────────
+    describe('interpolate', () => {
+        it('replaces a single placeholder', () => {
+            expect(StringHelper.interpolate('Hello {{name}}!', { name: 'World' })).toBe('Hello World!');
+        });
+        it('replaces multiple placeholders', () => {
+            expect(StringHelper.interpolate('{{a}} + {{b}} = {{c}}', { a: 1, b: 2, c: 3 })).toBe('1 + 2 = 3');
+        });
+        it('leaves unresolved placeholders unchanged', () => {
+            expect(StringHelper.interpolate('Hello {{name}}!', {})).toBe('Hello {{name}}!');
+        });
+        it('handles numeric values', () => {
+            expect(StringHelper.interpolate('Count: {{n}}', { n: 99 })).toBe('Count: 99');
+        });
+        it('returns template unchanged when vars is empty', () => {
+            expect(StringHelper.interpolate('no placeholders', {})).toBe('no placeholders');
+        });
+    });
+    // ─── truncate ────────────────────────────────────────────────────────────────
+    describe('truncate', () => {
+        it('returns input unchanged when within maxLength', () => {
+            expect(StringHelper.truncate('hello', 10)).toBe('hello');
+        });
+        it('returns input unchanged when equal to maxLength', () => {
+            expect(StringHelper.truncate('hello', 5)).toBe('hello');
+        });
+        it('truncates and appends default suffix', () => {
+            expect(StringHelper.truncate('hello world', 8)).toBe('hello w…');
+        });
+        it('truncates and appends custom suffix', () => {
+            expect(StringHelper.truncate('hello world', 8, '...')).toBe('hello...');
+        });
+        it('returns only suffix when maxLength equals suffix length', () => {
+            expect(StringHelper.truncate('hello world', 1)).toBe('…');
+        });
+        it('returns empty string when maxLength is 0 and suffix is empty', () => {
+            expect(StringHelper.truncate('hello', 0, '')).toBe('');
+        });
+        it('cutAt is clamped to 0 when maxLength < suffix length', () => {
+            expect(StringHelper.truncate('hello world', 2, '...')).toBe('...');
+        });
+    });
+    // ─── generateReferenceCode ───────────────────────────────────────────────────
+    describe('generateReferenceCode', () => {
+        it('returns a string matching the expected format', () => {
+            const code = StringHelper.generateReferenceCode('TRV');
+            expect(code).toMatch(/^TRV-[A-Z0-9]{6}-\d{4}$/);
+        });
+        it('includes the current year', () => {
+            const year = new Date().getFullYear();
+            const code = StringHelper.generateReferenceCode('TST');
+            expect(code).toContain(`-${year}`);
+        });
+        it('generates different codes on successive calls', () => {
+            const a = StringHelper.generateReferenceCode('X');
+            const b = StringHelper.generateReferenceCode('X');
+            // Probabilistically different (1/36^6 chance of collision)
+            expect(a === b).toBe(false);
+        });
+        it('uses the provided prefix', () => {
+            const code = StringHelper.generateReferenceCode('ABC');
+            expect(code.startsWith('ABC-')).toBe(true);
+        });
+    });
+    // ─── getSingleValue ──────────────────────────────────────────────────────────
+    describe('getSingleValue', () => {
+        it('returns the string itself when input is a string', () => {
+            expect(StringHelper.getSingleValue('hello')).toBe('hello');
+        });
+        it('returns the first element when input is an array', () => {
+            expect(StringHelper.getSingleValue(['first', 'second'])).toBe('first');
+        });
+        it('returns undefined when input is an empty array', () => {
+            expect(StringHelper.getSingleValue([])).toBeUndefined();
+        });
+        it('returns the single element of a one-item array', () => {
+            expect(StringHelper.getSingleValue(['only'])).toBe('only');
+        });
+    });
+});
+//# sourceMappingURL=string.utils.test.js.map