@redocly/openapi-docs 3.24.0-next.9 → 3.24.1

package/lib/services/code-samples/httpsnippet/targets/r/__tests__/httr.test.js

@@ -0,0 +1,126 @@
+export { HTTPSnippet } from '../../../index.js'; // we need to reexport it before to prevent circular ref issue
+import httr from '../httr.js';
+import { originalOptions, serverVariablesOptions, source } from '../../__mocks__/mock.js';
+describe('#code-samples R lang', () => {
+    describe('handler', () => {
+        it('returns code API POST /pet', () => {
+            const result = httr(source['POST http://petstore.swagger.io/v2/pet'], originalOptions, {
+                target: 'r',
+                client: 'httr',
+            });
+            expect(result).toMatchSnapshot();
+        });
+        it('returns code with path parameters reserved (data) and not (petId) /pet/{petId}/uploadImage/{data}', () => {
+            const result = httr(source['POST http://petstore.swagger.io/v2/pet/{petId}/uploadImage/{data}'], originalOptions, { target: 'r', client: 'httr' });
+            expect(result).toMatchSnapshot();
+        });
+        it('returns code with one path parameter inside url /pet/{petId}/uploadImage', () => {
+            const result = httr(source['POST http://petstore.swagger.io/v2/pet/{petId}/uploadImage'], originalOptions, { target: 'r', client: 'httr' });
+            expect(result).toMatchSnapshot();
+        });
+        it('returns code with path parameter and query /pet/findByStatus/{id}?status=...', () => {
+            const result = httr(source['GET http://petstore.swagger.io/v2/pet/findByStatus/{id}'], originalOptions, { target: 'r', client: 'httr' });
+            expect(result).toMatchSnapshot();
+        });
+        it('should generate code with server variables', () => {
+            const result = httr(source['POST https://{customerId}.saas-app.com:{port}/v2'], serverVariablesOptions, { target: 'r', client: 'httr' });
+            expect(result).toMatchSnapshot();
+        });
+        it('should generate code with basic auth', () => {
+            const result = httr(source['POST http://petstore.swagger.io/login'], serverVariablesOptions, {
+                target: 'r',
+                client: 'httr',
+            });
+            expect(result).toMatchSnapshot();
+        });
+        it('should handle URL_ENCODED with text but no params (serializedValue case)', () => {
+            const sourceWithUrlEncodedText = {
+                method: 'post',
+                url: 'http://petstore.swagger.io/v2/pet',
+                httpVersion: 'HTTP/1.1',
+                cookies: [],
+                headers: [{ name: 'Content-Type', value: 'application/x-www-form-urlencoded' }],
+                queryString: [],
+                postData: {
+                    mimeType: 'application/x-www-form-urlencoded',
+                    text: 'name=Museum+Visitor&value=premium&count=5',
+                    params: [],
+                },
+                headersSize: 0,
+                bodySize: 0,
+                securityOAuth2ExtraCalls: [],
+                pathParameters: {},
+                serverVariables: {},
+                queryObj: {},
+                headersObj: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                cookiesObj: {},
+                allHeaders: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                uriObj: {
+                    protocol: 'http:',
+                    slashes: true,
+                    auth: null,
+                    host: 'petstore.swagger.io',
+                    port: null,
+                    hostname: 'petstore.swagger.io',
+                    hash: null,
+                    search: '',
+                    query: {},
+                    pathname: '/v2/pet',
+                    path: '/v2/pet',
+                    href: 'http://petstore.swagger.io/v2/pet',
+                },
+                fullUrl: 'http://petstore.swagger.io/v2/pet',
+            };
+            const result = httr(sourceWithUrlEncodedText, originalOptions, {
+                target: 'r',
+                client: 'httr',
+            });
+            expect(result).toMatchSnapshot();
+        });
+        it('should handle MULTIPART with text but no params (serializedValue case)', () => {
+            const sourceWithMultipartText = {
+                method: 'post',
+                url: 'http://petstore.swagger.io/v2/pet',
+                httpVersion: 'HTTP/1.1',
+                cookies: [],
+                headers: [{ name: 'Content-Type', value: 'multipart/form-data' }],
+                queryString: [],
+                postData: {
+                    mimeType: 'multipart/form-data',
+                    text: '--boundary123\r\nContent-Disposition: form-data; name="field1"\r\n\r\nvalue1\r\n--boundary123\r\nContent-Disposition: form-data; name="field2"\r\n\r\nvalue2\r\n--boundary123--',
+                    params: [],
+                },
+                headersSize: 0,
+                bodySize: 0,
+                securityOAuth2ExtraCalls: [],
+                pathParameters: {},
+                serverVariables: {},
+                queryObj: {},
+                headersObj: { 'Content-Type': 'multipart/form-data' },
+                cookiesObj: {},
+                allHeaders: { 'Content-Type': 'multipart/form-data' },
+                uriObj: {
+                    protocol: 'http:',
+                    slashes: true,
+                    auth: null,
+                    host: 'petstore.swagger.io',
+                    port: null,
+                    hostname: 'petstore.swagger.io',
+                    hash: null,
+                    search: '',
+                    query: {},
+                    pathname: '/v2/pet',
+                    path: '/v2/pet',
+                    href: 'http://petstore.swagger.io/v2/pet',
+                },
+                fullUrl: 'http://petstore.swagger.io/v2/pet',
+            };
+            const result = httr(sourceWithMultipartText, originalOptions, {
+                target: 'r',
+                client: 'httr',
+            });
+            expect(result).toMatchSnapshot();
+        });
+    });
+});
+//# sourceMappingURL=httr.test.js.map

package/lib/services/code-samples/httpsnippet/targets/ruby/__tests__/native.test.d.ts

@@ -0,0 +1 @@
+export { HTTPSnippet } from '../../../index.js';

package/lib/services/code-samples/httpsnippet/targets/ruby/__tests__/native.test.js

@@ -0,0 +1,129 @@
+export { HTTPSnippet } from '../../../index.js'; // we need to reexport it before to prevent circular ref issue
+import native from '../native.js';
+import { originalOptions, serverVariablesOptions, source } from '../../__mocks__/mock.js';
+describe('#code-samples Ruby lang', () => {
+    describe('handler', () => {
+        it('returns code API POST /pet', () => {
+            const result = native(source['POST http://petstore.swagger.io/v2/pet'], originalOptions, {
+                target: 'ruby',
+                client: 'net::http',
+            });
+            expect(result).toMatchSnapshot();
+        });
+        it('returns code with path parameters reserved (data) and not (petId) /pet/{petId}/uploadImage/{data}', () => {
+            const result = native(source['POST http://petstore.swagger.io/v2/pet/{petId}/uploadImage/{data}'], originalOptions, { target: 'ruby', client: 'net::http' });
+            expect(result).toMatchSnapshot();
+        });
+        it('returns code with one path parameter inside url /pet/{petId}/uploadImage', () => {
+            const result = native(source['POST http://petstore.swagger.io/v2/pet/{petId}/uploadImage'], originalOptions, { target: 'ruby', client: 'net::http' });
+            expect(result).toMatchSnapshot();
+        });
+        it('returns code with path parameter and query /pet/findByStatus/{id}?status=...', () => {
+            const result = native(source['GET http://petstore.swagger.io/v2/pet/findByStatus/{id}'], originalOptions, { target: 'ruby', client: 'net::http' });
+            expect(result).toMatchSnapshot();
+        });
+        it('should generate code with server variables', () => {
+            const result = native(source['POST https://{customerId}.saas-app.com:{port}/v2'], serverVariablesOptions, {
+                target: 'ruby',
+                client: 'net::http',
+            });
+            expect(result).toMatchSnapshot();
+        });
+        it('should generate code with basic auth', () => {
+            const result = native(source['POST http://petstore.swagger.io/login'], serverVariablesOptions, {
+                target: 'ruby',
+                client: 'net::http',
+            });
+            expect(result).toMatchSnapshot();
+        });
+        it('should handle URL_ENCODED with text but no params (serializedValue case)', () => {
+            const sourceWithUrlEncodedText = {
+                method: 'post',
+                url: 'http://petstore.swagger.io/v2/pet',
+                httpVersion: 'HTTP/1.1',
+                cookies: [],
+                headers: [{ name: 'Content-Type', value: 'application/x-www-form-urlencoded' }],
+                queryString: [],
+                postData: {
+                    mimeType: 'application/x-www-form-urlencoded',
+                    text: 'name=Museum+Visitor&value=premium&count=5',
+                    params: [],
+                },
+                headersSize: 0,
+                bodySize: 0,
+                securityOAuth2ExtraCalls: [],
+                pathParameters: {},
+                serverVariables: {},
+                queryObj: {},
+                headersObj: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                cookiesObj: {},
+                allHeaders: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                uriObj: {
+                    protocol: 'http:',
+                    slashes: true,
+                    auth: null,
+                    host: 'petstore.swagger.io',
+                    port: null,
+                    hostname: 'petstore.swagger.io',
+                    hash: null,
+                    search: '',
+                    query: {},
+                    pathname: '/v2/pet',
+                    path: '/v2/pet',
+                    href: 'http://petstore.swagger.io/v2/pet',
+                },
+                fullUrl: 'http://petstore.swagger.io/v2/pet',
+            };
+            const result = native(sourceWithUrlEncodedText, originalOptions, {
+                target: 'ruby',
+                client: 'net::http',
+            });
+            expect(result).toMatchSnapshot();
+        });
+        it('should handle MULTIPART with text but no params (serializedValue case)', () => {
+            const sourceWithMultipartText = {
+                method: 'post',
+                url: 'http://petstore.swagger.io/v2/pet',
+                httpVersion: 'HTTP/1.1',
+                cookies: [],
+                headers: [{ name: 'Content-Type', value: 'multipart/form-data' }],
+                queryString: [],
+                postData: {
+                    mimeType: 'multipart/form-data',
+                    text: '--boundary123\r\nContent-Disposition: form-data; name="field1"\r\n\r\nvalue1\r\n--boundary123\r\nContent-Disposition: form-data; name="field2"\r\n\r\nvalue2\r\n--boundary123--',
+                    params: [],
+                },
+                headersSize: 0,
+                bodySize: 0,
+                securityOAuth2ExtraCalls: [],
+                pathParameters: {},
+                serverVariables: {},
+                queryObj: {},
+                headersObj: { 'Content-Type': 'multipart/form-data' },
+                cookiesObj: {},
+                allHeaders: { 'Content-Type': 'multipart/form-data' },
+                uriObj: {
+                    protocol: 'http:',
+                    slashes: true,
+                    auth: null,
+                    host: 'petstore.swagger.io',
+                    port: null,
+                    hostname: 'petstore.swagger.io',
+                    hash: null,
+                    search: '',
+                    query: {},
+                    pathname: '/v2/pet',
+                    path: '/v2/pet',
+                    href: 'http://petstore.swagger.io/v2/pet',
+                },
+                fullUrl: 'http://petstore.swagger.io/v2/pet',
+            };
+            const result = native(sourceWithMultipartText, originalOptions, {
+                target: 'ruby',
+                client: 'net::http',
+            });
+            expect(result).toMatchSnapshot();
+        });
+    });
+});
+//# sourceMappingURL=native.test.js.map

package/lib/services/code-samples/httpsnippet/targets/shell/__tests__/curl.test.d.ts

@@ -0,0 +1 @@
+export { HTTPSnippet } from '../../../index.js';

package/lib/services/code-samples/httpsnippet/targets/shell/__tests__/curl.test.js

@@ -0,0 +1,129 @@
+export { HTTPSnippet } from '../../../index.js'; // we need to reexport it before to prevent circular ref issue
+import curl from '../curl.js';
+import { originalOptions, serverVariablesOptions, source } from '../../__mocks__/mock.js';
+describe('#code-samples Curl', () => {
+    describe('handler', () => {
+        it('returns code API PUT /pet', () => {
+            const result = curl(source['PUT http://petstore.swagger.io/v2/pet'], originalOptions, {
+                target: 'shell',
+                client: 'curl',
+            });
+            expect(result).toMatchSnapshot();
+        });
+        it('returns code with path parameters reserved (data) and not (petId) /pet/{petId}/uploadImage/{data}', () => {
+            const result = curl(source['POST http://petstore.swagger.io/v2/pet/{petId}/uploadImage/{data}'], originalOptions, { target: 'shell', client: 'curl' });
+            expect(result).toMatchSnapshot();
+        });
+        it('returns code with one path parameter inside url /pet/{petId}/uploadImage', () => {
+            const result = curl(source['POST http://petstore.swagger.io/v2/pet/{petId}/uploadImage'], originalOptions, { target: 'shell', client: 'curl' });
+            expect(result).toMatchSnapshot();
+        });
+        it('returns code with path parameter and query /pet/findByStatus/{id}?status=...', () => {
+            const result = curl(source['GET http://petstore.swagger.io/v2/pet/findByStatus/{id}'], originalOptions, { target: 'shell', client: 'curl' });
+            expect(result).toMatchSnapshot();
+        });
+        it('should generate code with server variables', () => {
+            const result = curl(source['POST https://{customerId}.saas-app.com:{port}/v2'], serverVariablesOptions, {
+                target: 'shell',
+                client: 'curl',
+            });
+            expect(result).toMatchSnapshot();
+        });
+        it('should generate code with basic auth', () => {
+            const result = curl(source['POST http://petstore.swagger.io/login'], serverVariablesOptions, {
+                target: 'shell',
+                client: 'curl',
+            });
+            expect(result).toMatchSnapshot();
+        });
+        it('should handle MULTIPART with text but no params (serializedValue case)', () => {
+            const sourceWithMultipartText = {
+                method: 'post',
+                url: 'http://petstore.swagger.io/v2/pet',
+                httpVersion: 'HTTP/1.1',
+                cookies: [],
+                headers: [{ name: 'Content-Type', value: 'multipart/form-data' }],
+                queryString: [],
+                postData: {
+                    mimeType: 'multipart/form-data',
+                    text: '--boundary123\r\nContent-Disposition: form-data; name="field1"\r\n\r\nvalue1\r\n--boundary123\r\nContent-Disposition: form-data; name="field2"\r\n\r\nvalue2\r\n--boundary123--',
+                    params: [],
+                },
+                headersSize: 0,
+                bodySize: 0,
+                securityOAuth2ExtraCalls: [],
+                pathParameters: {},
+                serverVariables: {},
+                queryObj: {},
+                headersObj: { 'Content-Type': 'multipart/form-data' },
+                cookiesObj: {},
+                allHeaders: { 'Content-Type': 'multipart/form-data' },
+                uriObj: {
+                    protocol: 'http:',
+                    slashes: true,
+                    auth: null,
+                    host: 'petstore.swagger.io',
+                    port: null,
+                    hostname: 'petstore.swagger.io',
+                    hash: null,
+                    search: '',
+                    query: {},
+                    pathname: '/v2/pet',
+                    path: '/v2/pet',
+                    href: 'http://petstore.swagger.io/v2/pet',
+                },
+                fullUrl: 'http://petstore.swagger.io/v2/pet',
+            };
+            const result = curl(sourceWithMultipartText, originalOptions, {
+                target: 'shell',
+                client: 'curl',
+            });
+            expect(result).toMatchSnapshot();
+        });
+        it('should handle URL_ENCODED with text but no params (serializedValue case)', () => {
+            const sourceWithUrlEncodedText = {
+                method: 'post',
+                url: 'http://petstore.swagger.io/v2/pet',
+                httpVersion: 'HTTP/1.1',
+                cookies: [],
+                headers: [{ name: 'Content-Type', value: 'application/x-www-form-urlencoded' }],
+                queryString: [],
+                postData: {
+                    mimeType: 'application/x-www-form-urlencoded',
+                    text: 'name=Museum+Visitor&value=premium&count=5',
+                    params: [],
+                },
+                headersSize: 0,
+                bodySize: 0,
+                securityOAuth2ExtraCalls: [],
+                pathParameters: {},
+                serverVariables: {},
+                queryObj: {},
+                headersObj: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                cookiesObj: {},
+                allHeaders: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                uriObj: {
+                    protocol: 'http:',
+                    slashes: true,
+                    auth: null,
+                    host: 'petstore.swagger.io',
+                    port: null,
+                    hostname: 'petstore.swagger.io',
+                    hash: null,
+                    search: '',
+                    query: {},
+                    pathname: '/v2/pet',
+                    path: '/v2/pet',
+                    href: 'http://petstore.swagger.io/v2/pet',
+                },
+                fullUrl: 'http://petstore.swagger.io/v2/pet',
+            };
+            const result = curl(sourceWithUrlEncodedText, originalOptions, {
+                target: 'shell',
+                client: 'curl',
+            });
+            expect(result).toMatchSnapshot();
+        });
+    });
+});
+//# sourceMappingURL=curl.test.js.map

package/lib/services/config-options/__tests__/helpers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/services/config-options/__tests__/helpers.test.js

@@ -0,0 +1,234 @@
+import { vi } from 'vitest';
+import { normalizeShowExtensions, normalizeScrollYOffset, 
+// @community-ignore
+normalizeCodeSamples,
+// @community-ignore-end
+ } from '../helpers.js';
+import { querySelector } from '../../../utils/dom.js';
+import { isNumeric } from '../../../utils/helpers.js';
+// @community-ignore
+import { Languages } from '../../code-samples/constants.js';
+// @community-ignore-end
+vi.mock('../../../utils/dom.js');
+vi.mock('../../../utils/helpers.js');
+const mockQuerySelector = querySelector;
+const mockIsNumeric = isNumeric;
+describe('helpers', () => {
+    const originalConsoleWarn = console.warn;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        console.warn = vi.fn();
+    });
+    afterAll(() => {
+        console.warn = originalConsoleWarn;
+    });
+    describe('normalizeShowExtensions', () => {
+        it('should return false for undefined value', () => {
+            const result = normalizeShowExtensions(undefined);
+            expect(result).toBe(false);
+        });
+        it('should return true for empty string', () => {
+            const result = normalizeShowExtensions('');
+            expect(result).toBe(true);
+        });
+        it('should return true for string "true"', () => {
+            const result = normalizeShowExtensions('true');
+            expect(result).toBe(true);
+        });
+        it('should return false for string "false"', () => {
+            const result = normalizeShowExtensions('false');
+            expect(result).toBe(false);
+        });
+        it('should return array of extensions for comma-separated string', () => {
+            const result = normalizeShowExtensions('x-extension,y-extension, z-extension');
+            expect(result).toEqual(['x-extension', 'y-extension', 'z-extension']);
+        });
+        it('should trim whitespace from extensions', () => {
+            const result = normalizeShowExtensions('  x-ext  ,  y-ext  ');
+            expect(result).toEqual(['x-ext', 'y-ext']);
+        });
+        it('should return boolean value as-is when not string', () => {
+            const result = normalizeShowExtensions(true);
+            expect(result).toBe(true);
+        });
+        it('should return array value as-is when not string', () => {
+            const extensions = ['x-custom', 'y-custom'];
+            const result = normalizeShowExtensions(extensions);
+            expect(result).toBe(extensions);
+        });
+        it('should handle single extension without comma', () => {
+            const result = normalizeShowExtensions('x-single-extension');
+            expect(result).toEqual(['x-single-extension']);
+        });
+        it('should handle empty extensions in comma-separated string', () => {
+            const result = normalizeShowExtensions('x-ext,,y-ext,');
+            expect(result).toEqual(['x-ext', 'y-ext']);
+        });
+    });
+    describe('normalizeScrollYOffset', () => {
+        beforeEach(() => {
+            mockIsNumeric.mockReset();
+            mockQuerySelector.mockReset();
+        });
+        it('should return function that returns element bottom for valid selector', () => {
+            const mockElement = {
+                getBoundingClientRect: vi.fn().mockReturnValue({ bottom: 100 }),
+            };
+            mockIsNumeric.mockReturnValue(false);
+            mockQuerySelector.mockReturnValue(mockElement);
+            const offsetFn = normalizeScrollYOffset('#header');
+            const result = offsetFn();
+            expect(mockQuerySelector).toHaveBeenCalledWith('#header');
+            expect(mockElement.getBoundingClientRect).toHaveBeenCalled();
+            expect(result).toBe(100);
+        });
+        it('should return function that returns 0 and warn for invalid selector', () => {
+            mockIsNumeric.mockReturnValue(false);
+            mockQuerySelector.mockReturnValue(null);
+            const offsetFn = normalizeScrollYOffset('#non-existent');
+            const result = offsetFn();
+            expect(console.warn).toHaveBeenCalledWith('scrollYOffset value is a selector to non-existing element. Using offset 0 by default');
+            expect(result).toBe(0);
+        });
+        it('should return function that returns number for numeric value', () => {
+            const offsetFn = normalizeScrollYOffset(50);
+            const result = offsetFn();
+            expect(result).toBe(50);
+        });
+        it('should return function that parses numeric string', () => {
+            mockIsNumeric.mockReturnValue(true);
+            const offsetFn = normalizeScrollYOffset('75.5');
+            const result = offsetFn();
+            expect(result).toBe(75.5);
+        });
+        it('should handle function that returns number', () => {
+            const mockFn = vi.fn().mockReturnValue(120);
+            const offsetFn = normalizeScrollYOffset(mockFn);
+            const result = offsetFn();
+            expect(mockFn).toHaveBeenCalled();
+            expect(result).toBe(120);
+        });
+        it('should warn when function returns non-number', () => {
+            const mockFn = vi.fn().mockReturnValue('invalid');
+            const offsetFn = normalizeScrollYOffset(mockFn);
+            const result = offsetFn();
+            expect(console.warn).toHaveBeenCalledWith('scrollYOffset should return number but returned value "invalid" of type string');
+            expect(result).toBe('invalid');
+        });
+        it('should return function that returns 0 for invalid value types', () => {
+            const offsetFn = normalizeScrollYOffset({});
+            const result = offsetFn();
+            expect(console.warn).toHaveBeenCalledWith('Wrong value for scrollYOffset ReDoc option: should be string, number or function');
+            expect(result).toBe(0);
+        });
+        it('should return function that returns 0 for undefined', () => {
+            const offsetFn = normalizeScrollYOffset(undefined);
+            const result = offsetFn();
+            expect(result).toBe(0);
+        });
+        it('should handle string that is numeric but not call querySelector', () => {
+            mockIsNumeric.mockReturnValue(true);
+            const offsetFn = normalizeScrollYOffset('42');
+            const result = offsetFn();
+            expect(mockQuerySelector).not.toHaveBeenCalled();
+            expect(result).toBe(42);
+        });
+        it('should handle zero numeric value', () => {
+            const offsetFn = normalizeScrollYOffset(0);
+            const result = offsetFn();
+            expect(result).toBe(0);
+        });
+        it('should handle negative numeric value', () => {
+            const offsetFn = normalizeScrollYOffset(-10);
+            const result = offsetFn();
+            expect(result).toBe(-10);
+        });
+    });
+    // @community-ignore
+    describe('normalizeCodeSamples', () => {
+        const expectedDefaultLanguages = Object.values(Languages).map((lang) => ({ lang }));
+        it('should return default structure for undefined value', () => {
+            const result = normalizeCodeSamples(undefined);
+            expect(result).toEqual({
+                languages: expectedDefaultLanguages,
+            });
+        });
+        it('should return default structure for null value', () => {
+            const result = normalizeCodeSamples(null);
+            expect(result).toEqual({
+                languages: expectedDefaultLanguages,
+            });
+        });
+        it('should merge provided config with defaults', () => {
+            const customConfig = {
+                skipOptionalParameters: true,
+                withOAuth2Call: false,
+            };
+            const result = normalizeCodeSamples(customConfig);
+            expect(result).toEqual({
+                languages: expectedDefaultLanguages,
+                skipOptionalParameters: true,
+                withOAuth2Call: false,
+            });
+        });
+        it('should preserve custom languages when provided', () => {
+            const customLanguages = [
+                { lang: 'curl' },
+                { lang: 'JavaScript', label: 'JS' },
+            ];
+            const customConfig = {
+                languages: customLanguages,
+            };
+            const result = normalizeCodeSamples(customConfig);
+            expect(result).toEqual({
+                languages: customLanguages,
+            });
+        });
+        it('should merge complex config with all properties', () => {
+            const onSampleTabClickMock = vi.fn();
+            const customLanguages = [{ lang: 'Python', options: { withComments: true } }];
+            const customConfig = {
+                languages: customLanguages,
+                skipOptionalParameters: true,
+                withOAuth2Call: true,
+                onSampleTabClick: onSampleTabClickMock,
+            };
+            const result = normalizeCodeSamples(customConfig);
+            expect(result).toEqual({
+                languages: customLanguages,
+                skipOptionalParameters: true,
+                withOAuth2Call: true,
+                onSampleTabClick: onSampleTabClickMock,
+            });
+        });
+        it('should handle empty object config', () => {
+            const result = normalizeCodeSamples({});
+            expect(result).toEqual({
+                languages: expectedDefaultLanguages,
+            });
+        });
+        it('should handle config with only boolean properties', () => {
+            const customConfig = {
+                skipOptionalParameters: false,
+                withOAuth2Call: true,
+            };
+            const result = normalizeCodeSamples(customConfig);
+            expect(result).toEqual({
+                languages: expectedDefaultLanguages,
+                skipOptionalParameters: false,
+                withOAuth2Call: true,
+            });
+        });
+        it('should verify default languages structure', () => {
+            const result = normalizeCodeSamples();
+            // Verify that each language from the Languages constant is included
+            const languageValues = Object.values(Languages);
+            expect(result.languages).toHaveLength(languageValues.length);
+            languageValues.forEach((lang, index) => {
+                expect(result.languages[index]).toEqual({ lang });
+            });
+        });
+    });
+    // @community-ignore-end
+});
+//# sourceMappingURL=helpers.test.js.map

package/lib/services/history/__tests__/helpers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/services/history/__tests__/helpers.test.js

@@ -0,0 +1,19 @@
+import { joinWithSeparator } from '../helpers.js';
+describe('History helpers', () => {
+    describe('joinWithSeparator', () => {
+        test.each `
+      base         | path         | expected
+      ${'a'}       | ${'b'}       | ${'a/b'}
+      ${'a/'}      | ${'/b'}      | ${'a/b'}
+      ${'a'}       | ${''}        | ${'a'}
+      ${''}        | ${'b'}       | ${'b'}
+      ${'a/'}      | ${undefined} | ${'a'}
+      ${undefined} | ${'/b'}      | ${'b'}
+      ${'/a/'}     | ${'/b/'}     | ${'/a/b/'}
+      ${'/'}       | ${'b'}       | ${'/b'}
+    `('returns $expected when joining "$base" and "$path"', ({ base, path, expected }) => {
+            expect(joinWithSeparator(base, path)).toBe(expected);
+        });
+    });
+});
+//# sourceMappingURL=helpers.test.js.map

package/lib/services/menu/__tests__/buildNestedTagsItems.test.d.ts

@@ -0,0 +1 @@
+export {};