@flusys/nestjs-shared 7.1.0 → 8.0.0-beta.1

package/cjs/utils/query-helpers.util.spec.js

@@ -1,209 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _common = require("@nestjs/common");
-const _loggedusermock = require("@test-utils/mocks/logged-user.mock");
-const _queryhelpersutil = require("./query-helpers.util");
-function createMockQueryBuilder() {
-    return {
-        andWhere: jest.fn().mockReturnThis()
-    };
-}
-describe('query-helpers.util', ()=>{
-    describe('applyCompanyFilter', ()=>{
-        it('should apply the company filter when feature enabled and user has companyId', ()=>{
-            const query = createMockQueryBuilder();
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: 'company-1'
-            });
-            (0, _queryhelpersutil.applyCompanyFilter)(query, {
-                isCompanyFeatureEnabled: true,
-                entityAlias: 'file'
-            }, user);
-            expect(query.andWhere).toHaveBeenCalledWith('file.companyId = :companyId', {
-                companyId: 'company-1'
-            });
-        });
-        it('should use a custom column name when provided', ()=>{
-            const query = createMockQueryBuilder();
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: 'company-1'
-            });
-            (0, _queryhelpersutil.applyCompanyFilter)(query, {
-                isCompanyFeatureEnabled: true,
-                entityAlias: 'file',
-                columnName: 'company_id'
-            }, user);
-            expect(query.andWhere).toHaveBeenCalledWith('file.company_id = :companyId', {
-                companyId: 'company-1'
-            });
-        });
-        it('should not apply filter when feature disabled', ()=>{
-            const query = createMockQueryBuilder();
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: 'company-1'
-            });
-            (0, _queryhelpersutil.applyCompanyFilter)(query, {
-                isCompanyFeatureEnabled: false,
-                entityAlias: 'file'
-            }, user);
-            expect(query.andWhere).not.toHaveBeenCalled();
-        });
-        it('should not apply filter when user is null', ()=>{
-            const query = createMockQueryBuilder();
-            (0, _queryhelpersutil.applyCompanyFilter)(query, {
-                isCompanyFeatureEnabled: true,
-                entityAlias: 'file'
-            }, null);
-            expect(query.andWhere).not.toHaveBeenCalled();
-        });
-        it('should not apply filter when user has no companyId', ()=>{
-            const query = createMockQueryBuilder();
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: undefined
-            });
-            (0, _queryhelpersutil.applyCompanyFilter)(query, {
-                isCompanyFeatureEnabled: true,
-                entityAlias: 'file'
-            }, user);
-            expect(query.andWhere).not.toHaveBeenCalled();
-        });
-        it('should return the same query builder instance', ()=>{
-            const query = createMockQueryBuilder();
-            const result = (0, _queryhelpersutil.applyCompanyFilter)(query, {
-                isCompanyFeatureEnabled: false,
-                entityAlias: 'file'
-            }, null);
-            expect(result).toBe(query);
-        });
-    });
-    describe('buildCompanyWhereCondition', ()=>{
-        it('should add companyId when feature enabled and user has one', ()=>{
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: 'company-1'
-            });
-            const result = (0, _queryhelpersutil.buildCompanyWhereCondition)({
-                id: '1'
-            }, true, user);
-            expect(result).toEqual({
-                id: '1',
-                companyId: 'company-1'
-            });
-        });
-        it('should return base where unchanged when feature disabled', ()=>{
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: 'company-1'
-            });
-            const result = (0, _queryhelpersutil.buildCompanyWhereCondition)({
-                id: '1'
-            }, false, user);
-            expect(result).toEqual({
-                id: '1'
-            });
-        });
-        it('should return base where unchanged when user is null', ()=>{
-            const result = (0, _queryhelpersutil.buildCompanyWhereCondition)({
-                id: '1'
-            }, true, null);
-            expect(result).toEqual({
-                id: '1'
-            });
-        });
-        it('should return base where unchanged when user has no companyId', ()=>{
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: undefined
-            });
-            const result = (0, _queryhelpersutil.buildCompanyWhereCondition)({
-                id: '1'
-            }, true, user);
-            expect(result).toEqual({
-                id: '1'
-            });
-        });
-    });
-    describe('hasCompanyId', ()=>{
-        it('should return true for an object with a companyId property', ()=>{
-            expect((0, _queryhelpersutil.hasCompanyId)({
-                companyId: 'company-1'
-            })).toBe(true);
-        });
-        it('should return true even when companyId is explicitly undefined but present', ()=>{
-            expect((0, _queryhelpersutil.hasCompanyId)({
-                companyId: undefined
-            })).toBe(true);
-        });
-        it('should return false for an object without a companyId property', ()=>{
-            expect((0, _queryhelpersutil.hasCompanyId)({
-                id: '1'
-            })).toBe(false);
-        });
-        it('should return false for null', ()=>{
-            expect((0, _queryhelpersutil.hasCompanyId)(null)).toBe(false);
-        });
-        it('should return false for non-object values', ()=>{
-            expect((0, _queryhelpersutil.hasCompanyId)('string')).toBe(false);
-            expect((0, _queryhelpersutil.hasCompanyId)(42)).toBe(false);
-        });
-    });
-    describe('validateCompanyOwnership', ()=>{
-        it('should not throw when feature disabled', ()=>{
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: 'company-1'
-            });
-            expect(()=>(0, _queryhelpersutil.validateCompanyOwnership)({
-                    companyId: 'company-2'
-                }, user, false, 'Entity')).not.toThrow();
-        });
-        it('should not throw when user is null', ()=>{
-            expect(()=>(0, _queryhelpersutil.validateCompanyOwnership)({
-                    companyId: 'company-2'
-                }, null, true, 'Entity')).not.toThrow();
-        });
-        it('should not throw when entity has no companyId', ()=>{
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: 'company-1'
-            });
-            expect(()=>(0, _queryhelpersutil.validateCompanyOwnership)({
-                    id: '1'
-                }, user, true, 'Entity')).not.toThrow();
-        });
-        it('should not throw when entity companyId is falsy', ()=>{
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: 'company-1'
-            });
-            expect(()=>(0, _queryhelpersutil.validateCompanyOwnership)({
-                    companyId: null
-                }, user, true, 'Entity')).not.toThrow();
-        });
-        it('should not throw when entity companyId matches user companyId', ()=>{
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: 'company-1'
-            });
-            expect(()=>(0, _queryhelpersutil.validateCompanyOwnership)({
-                    companyId: 'company-1'
-                }, user, true, 'Entity')).not.toThrow();
-        });
-        it('should throw BadRequestException when entity belongs to a different company', ()=>{
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: 'company-1'
-            });
-            expect(()=>(0, _queryhelpersutil.validateCompanyOwnership)({
-                    companyId: 'company-2'
-                }, user, true, 'Email configuration')).toThrow(_common.BadRequestException);
-        });
-        it('should include the entity name in the thrown exception message', ()=>{
-            const user = (0, _loggedusermock.buildMockUser)({
-                companyId: 'company-1'
-            });
-            try {
-                (0, _queryhelpersutil.validateCompanyOwnership)({
-                    companyId: 'company-2'
-                }, user, true, 'Email configuration');
-                fail('expected to throw');
-            } catch (error) {
-                expect(error.getResponse().message).toContain('Email configuration');
-            }
-        });
-    });
-});

package/cjs/utils/request.util.js

@@ -1,96 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get buildCookieOptions () {
-        return buildCookieOptions;
-    },
-    get buildFrontendUrl () {
-        return buildFrontendUrl;
-    },
-    get extractFrontendUrl () {
-        return extractFrontendUrl;
-    },
-    get isBrowserRequest () {
-        return isBrowserRequest;
-    },
-    get parseDurationToMs () {
-        return parseDurationToMs;
-    }
-});
-const _config = require("@flusys/nestjs-core/config");
-const _constants = require("../constants");
-/** Time unit multipliers in milliseconds */ const TIME_UNIT_MS = {
-    s: 1000,
-    m: 60 * 1000,
-    h: 60 * 60 * 1000,
-    d: 24 * 60 * 60 * 1000,
-    w: 7 * 24 * 60 * 60 * 1000
-};
-/** Get normalized client type from request header */ function getClientType(req) {
-    const clientType = req.headers[_constants.CLIENT_TYPE_HEADER];
-    return clientType ? clientType.toLowerCase() : null;
-}
-function isBrowserRequest(req) {
-    const clientType = getClientType(req);
-    if (clientType) {
-        return clientType === 'browser' || clientType === 'web';
-    }
-    const accept = req.headers['accept'] || '';
-    if (accept.includes('text/html')) return true;
-    const userAgent = req.headers['user-agent'] || '';
-    const browserPatterns = /mozilla|chrome|safari|firefox|edge|opera|msie/i;
-    return browserPatterns.test(userAgent) && !userAgent.includes('Postman');
-}
-function buildCookieOptions(req) {
-    const hostname = req.hostname || '';
-    const origin = req.headers.origin || '';
-    const isProduction = _config.envConfig.isProduction();
-    const forwardedProto = req.headers['x-forwarded-proto'];
-    const isHttps = isProduction || forwardedProto === 'https' || origin.startsWith('https://') || req.secure;
-    let domain;
-    const domainParts = hostname.split('.');
-    if (domainParts.length > 2 && !hostname.includes('localhost')) {
-        domain = '.' + domainParts.slice(-2).join('.');
-    }
-    return {
-        secure: isHttps,
-        sameSite: isHttps ? 'strict' : 'lax',
-        ...domain && {
-            domain
-        }
-    };
-}
-function parseDurationToMs(duration, defaultMs = TIME_UNIT_MS.w) {
-    const match = duration.match(/^(\d+)(s|m|h|d|w)$/);
-    if (!match) return defaultMs;
-    const value = parseInt(match[1], 10);
-    const unit = match[2];
-    return value * (TIME_UNIT_MS[unit] ?? TIME_UNIT_MS.d);
-}
-function extractFrontendUrl(req) {
-    const allowedOrigins = _config.envConfig.getOrigins();
-    const origin = (req.get('origin') ?? req.get('referer') ?? '').trim();
-    if (origin && allowedOrigins.length) {
-        const matched = allowedOrigins.find((u)=>origin.startsWith(u));
-        if (matched) {
-            return matched;
-        }
-    }
-    const host = req.get('host');
-    if (!host) {
-        throw new Error('Unable to determine frontend URL from request');
-    }
-    return `${req.protocol}://${host}`;
-}
-function buildFrontendUrl(req, path) {
-    const baseUrl = extractFrontendUrl(req);
-    return `${baseUrl}${path}`;
-}

package/cjs/utils/request.util.spec.js

@@ -1,249 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _requestutil = require("./request.util");
-const isProductionMock = jest.fn();
-const getOriginsMock = jest.fn();
-jest.mock('@flusys/nestjs-core/config', ()=>({
-        envConfig: {
-            isProduction: ()=>isProductionMock(),
-            getOrigins: ()=>getOriginsMock()
-        }
-    }));
-function buildRequest(overrides = {}) {
-    return {
-        headers: {},
-        hostname: 'app.example.com',
-        secure: false,
-        get: jest.fn((name)=>overrides.headers?.[name.toLowerCase()]),
-        ...overrides
-    };
-}
-describe('request.util', ()=>{
-    beforeEach(()=>{
-        isProductionMock.mockReset().mockReturnValue(false);
-        getOriginsMock.mockReset().mockReturnValue([]);
-    });
-    describe('isBrowserRequest', ()=>{
-        it('should return true when x-client-type header is "browser"', ()=>{
-            const req = buildRequest({
-                headers: {
-                    'x-client-type': 'browser'
-                }
-            });
-            expect((0, _requestutil.isBrowserRequest)(req)).toBe(true);
-        });
-        it('should return true when x-client-type header is "web"', ()=>{
-            const req = buildRequest({
-                headers: {
-                    'x-client-type': 'WEB'
-                }
-            });
-            expect((0, _requestutil.isBrowserRequest)(req)).toBe(true);
-        });
-        it('should return false when x-client-type header is a non-browser value', ()=>{
-            const req = buildRequest({
-                headers: {
-                    'x-client-type': 'mobile'
-                }
-            });
-            expect((0, _requestutil.isBrowserRequest)(req)).toBe(false);
-        });
-        it('should return true when accept header includes text/html', ()=>{
-            const req = buildRequest({
-                headers: {
-                    accept: 'text/html,application/xhtml+xml'
-                }
-            });
-            expect((0, _requestutil.isBrowserRequest)(req)).toBe(true);
-        });
-        it('should return true for a recognized browser user-agent', ()=>{
-            const req = buildRequest({
-                headers: {
-                    'user-agent': 'Mozilla/5.0 Chrome/100.0 Safari/537.36'
-                }
-            });
-            expect((0, _requestutil.isBrowserRequest)(req)).toBe(true);
-        });
-        it('should return false for Postman user-agent even if it matches browser patterns', ()=>{
-            const req = buildRequest({
-                headers: {
-                    'user-agent': 'PostmanRuntime/7.0 chrome'
-                }
-            });
-            expect((0, _requestutil.isBrowserRequest)(req)).toBe(false);
-        });
-        it('should return false when no headers indicate a browser', ()=>{
-            const req = buildRequest({
-                headers: {
-                    'user-agent': 'curl/7.79.1'
-                }
-            });
-            expect((0, _requestutil.isBrowserRequest)(req)).toBe(false);
-        });
-    });
-    describe('buildCookieOptions', ()=>{
-        it('should mark cookies secure and sameSite strict in production', ()=>{
-            isProductionMock.mockReturnValue(true);
-            const req = buildRequest({
-                headers: {}
-            });
-            const options = (0, _requestutil.buildCookieOptions)(req);
-            expect(options.secure).toBe(true);
-            expect(options.sameSite).toBe('strict');
-        });
-        it('should mark cookies insecure and sameSite lax in dev with no forwarded proto', ()=>{
-            isProductionMock.mockReturnValue(false);
-            const req = buildRequest({
-                headers: {}
-            });
-            const options = (0, _requestutil.buildCookieOptions)(req);
-            expect(options.secure).toBe(false);
-            expect(options.sameSite).toBe('lax');
-        });
-        it('should treat x-forwarded-proto: https as secure', ()=>{
-            isProductionMock.mockReturnValue(false);
-            const req = buildRequest({
-                headers: {
-                    'x-forwarded-proto': 'https'
-                }
-            });
-            const options = (0, _requestutil.buildCookieOptions)(req);
-            expect(options.secure).toBe(true);
-            expect(options.sameSite).toBe('strict');
-        });
-        it('should treat an https origin header as secure', ()=>{
-            isProductionMock.mockReturnValue(false);
-            const req = buildRequest({
-                headers: {
-                    origin: 'https://app.example.com'
-                }
-            });
-            const options = (0, _requestutil.buildCookieOptions)(req);
-            expect(options.secure).toBe(true);
-        });
-        it('should treat req.secure as secure', ()=>{
-            isProductionMock.mockReturnValue(false);
-            const req = buildRequest({
-                headers: {},
-                secure: true
-            });
-            const options = (0, _requestutil.buildCookieOptions)(req);
-            expect(options.secure).toBe(true);
-        });
-        it('should not set a domain for a localhost hostname', ()=>{
-            isProductionMock.mockReturnValue(false);
-            const req = buildRequest({
-                headers: {},
-                hostname: 'localhost'
-            });
-            const options = (0, _requestutil.buildCookieOptions)(req);
-            expect(options.domain).toBeUndefined();
-        });
-        it('should not set a domain for a bare two-part hostname', ()=>{
-            isProductionMock.mockReturnValue(false);
-            const req = buildRequest({
-                headers: {},
-                hostname: 'example.com'
-            });
-            const options = (0, _requestutil.buildCookieOptions)(req);
-            expect(options.domain).toBeUndefined();
-        });
-        it('should set a leading-dot domain for a subdomain hostname', ()=>{
-            isProductionMock.mockReturnValue(false);
-            const req = buildRequest({
-                headers: {},
-                hostname: 'app.example.com'
-            });
-            const options = (0, _requestutil.buildCookieOptions)(req);
-            expect(options.domain).toBe('.example.com');
-        });
-    });
-    describe('parseDurationToMs', ()=>{
-        it('should parse seconds', ()=>{
-            expect((0, _requestutil.parseDurationToMs)('30s')).toBe(30 * 1000);
-        });
-        it('should parse minutes', ()=>{
-            expect((0, _requestutil.parseDurationToMs)('15m')).toBe(15 * 60 * 1000);
-        });
-        it('should parse hours', ()=>{
-            expect((0, _requestutil.parseDurationToMs)('2h')).toBe(2 * 60 * 60 * 1000);
-        });
-        it('should parse days', ()=>{
-            expect((0, _requestutil.parseDurationToMs)('7d')).toBe(7 * 24 * 60 * 60 * 1000);
-        });
-        it('should parse weeks', ()=>{
-            expect((0, _requestutil.parseDurationToMs)('2w')).toBe(2 * 7 * 24 * 60 * 60 * 1000);
-        });
-        it('should return the default when the string does not match the pattern', ()=>{
-            expect((0, _requestutil.parseDurationToMs)('garbage')).toBe(7 * 24 * 60 * 60 * 1000);
-        });
-        it('should return a custom default when provided and pattern does not match', ()=>{
-            expect((0, _requestutil.parseDurationToMs)('garbage', 12345)).toBe(12345);
-        });
-    });
-    describe('extractFrontendUrl', ()=>{
-        it('should return the matched allowed origin when the request origin starts with it', ()=>{
-            getOriginsMock.mockReturnValue([
-                'https://app.example.com'
-            ]);
-            const req = buildRequest({
-                headers: {
-                    origin: 'https://app.example.com'
-                },
-                get: jest.fn((name)=>{
-                    if (name === 'origin') return 'https://app.example.com';
-                    return undefined;
-                })
-            });
-            expect((0, _requestutil.extractFrontendUrl)(req)).toBe('https://app.example.com');
-        });
-        it('should fall back to referer when origin header is absent', ()=>{
-            getOriginsMock.mockReturnValue([
-                'https://app.example.com'
-            ]);
-            const req = buildRequest({
-                get: jest.fn((name)=>{
-                    if (name === 'referer') return 'https://app.example.com/some/path';
-                    return undefined;
-                })
-            });
-            expect((0, _requestutil.extractFrontendUrl)(req)).toBe('https://app.example.com');
-        });
-        it('should fall back to protocol + host when no origin matches an allowed origin', ()=>{
-            getOriginsMock.mockReturnValue([
-                'https://other.example.com'
-            ]);
-            const req = buildRequest({
-                get: jest.fn((name)=>{
-                    if (name === 'host') return 'app.example.com';
-                    return undefined;
-                }),
-                protocol: 'https'
-            });
-            expect((0, _requestutil.extractFrontendUrl)(req)).toBe('https://app.example.com');
-        });
-        it('should throw when no origin/referer matches and no host header is present', ()=>{
-            getOriginsMock.mockReturnValue([]);
-            const req = buildRequest({
-                get: jest.fn(()=>undefined)
-            });
-            expect(()=>(0, _requestutil.extractFrontendUrl)(req)).toThrow('Unable to determine frontend URL from request');
-        });
-    });
-    describe('buildFrontendUrl', ()=>{
-        it('should append the path to the resolved frontend base URL', ()=>{
-            getOriginsMock.mockReturnValue([
-                'https://app.example.com'
-            ]);
-            const req = buildRequest({
-                get: jest.fn((name)=>{
-                    if (name === 'origin') return 'https://app.example.com';
-                    return undefined;
-                })
-            });
-            expect((0, _requestutil.buildFrontendUrl)(req, '/reset-password?token=abc')).toBe('https://app.example.com/reset-password?token=abc');
-        });
-    });
-});

package/cjs/utils/string.util.js

@@ -1,63 +0,0 @@
-/**
- * String utility functions
- */ /**
- * Generate URL-friendly slug from a string
- * @param text - The text to convert to slug
- * @param maxLength - Maximum length of the slug (default: 100)
- * @returns URL-friendly slug
- *
- * @example
- * generateSlug('My Company Name') // 'my-company-name'
- * generateSlug('Hello World!') // 'hello-world'
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get generateSlug () {
-        return generateSlug;
-    },
-    get generateUniqueSlug () {
-        return generateUniqueSlug;
-    }
-});
-function generateSlug(text, maxLength = 100) {
-    return text.toLowerCase().trim().replace(/[^a-z0-9\s-]/g, '') // Remove special characters
-    .replace(/\s+/g, '-') // Replace spaces with hyphens
-    .replace(/-+/g, '-') // Replace multiple hyphens with single
-    .replace(/^-+|-+$/g, '') // Remove leading/trailing hyphens
-    .substring(0, maxLength);
-}
-async function generateUniqueSlug(text, findMatchingSlugs, maxLength = 100) {
-    const baseSlug = generateSlug(text, maxLength);
-    // Single query to get all matching slugs
-    const existingSlugs = await findMatchingSlugs(baseSlug);
-    // No collisions - base slug is available
-    if (existingSlugs.length === 0) {
-        return baseSlug;
-    }
-    // Build set for O(1) lookup
-    const existingSet = new Set(existingSlugs);
-    // Base slug not taken (only suffixed versions exist)
-    if (!existingSet.has(baseSlug)) {
-        return baseSlug;
-    }
-    // Find next available suffix in memory (fast)
-    let counter = 1;
-    while(counter < 10000){
-        const slugWithSuffix = `${baseSlug}-${counter}`;
-        if (!existingSet.has(slugWithSuffix)) {
-            return slugWithSuffix;
-        }
-        counter++;
-    }
-    // Fallback: append random string (extremely rare edge case)
-    const randomSuffix = Math.random().toString(36).substring(2, 8);
-    return `${baseSlug}-${randomSuffix}`;
-}

package/cjs/utils/string.util.spec.js

@@ -1,63 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _stringutil = require("./string.util");
-describe('string.util', ()=>{
-    describe('generateSlug', ()=>{
-        it('should lowercase and hyphenate a plain string', ()=>{
-            expect((0, _stringutil.generateSlug)('My Company Name')).toBe('my-company-name');
-        });
-        it('should strip special characters', ()=>{
-            expect((0, _stringutil.generateSlug)('Hello World!')).toBe('hello-world');
-        });
-        it('should collapse repeated whitespace and hyphens', ()=>{
-            expect((0, _stringutil.generateSlug)('Foo   Bar--Baz')).toBe('foo-bar-baz');
-        });
-        it('should trim leading/trailing hyphens produced by punctuation', ()=>{
-            expect((0, _stringutil.generateSlug)('  -Hello-  ')).toBe('hello');
-        });
-        it('should truncate to maxLength', ()=>{
-            expect((0, _stringutil.generateSlug)('abcdefghij', 5)).toBe('abcde');
-        });
-        it('should return an empty string for input that is only special characters', ()=>{
-            expect((0, _stringutil.generateSlug)('!!!???')).toBe('');
-        });
-    });
-    describe('generateUniqueSlug', ()=>{
-        it('should return the base slug when there are no collisions', async ()=>{
-            const findMatchingSlugs = jest.fn().mockResolvedValue([]);
-            const slug = await (0, _stringutil.generateUniqueSlug)('My Company', findMatchingSlugs);
-            expect(slug).toBe('my-company');
-            expect(findMatchingSlugs).toHaveBeenCalledWith('my-company');
-        });
-        it('should return the base slug when only suffixed variants exist', async ()=>{
-            const findMatchingSlugs = jest.fn().mockResolvedValue([
-                'my-company-1'
-            ]);
-            const slug = await (0, _stringutil.generateUniqueSlug)('My Company', findMatchingSlugs);
-            expect(slug).toBe('my-company');
-        });
-        it('should append the next available numeric suffix on collision', async ()=>{
-            const findMatchingSlugs = jest.fn().mockResolvedValue([
-                'my-company',
-                'my-company-1',
-                'my-company-2'
-            ]);
-            const slug = await (0, _stringutil.generateUniqueSlug)('My Company', findMatchingSlugs);
-            expect(slug).toBe('my-company-3');
-        });
-        it('should fall back to a random suffix when all 9999 slots are taken', async ()=>{
-            const taken = [
-                'my-company',
-                ...Array.from({
-                    length: 9999
-                }, (_, i)=>`my-company-${i + 1}`)
-            ];
-            const findMatchingSlugs = jest.fn().mockResolvedValue(taken);
-            const slug = await (0, _stringutil.generateUniqueSlug)('My Company', findMatchingSlugs);
-            expect(slug).toMatch(/^my-company-[a-z0-9]+$/);
-            expect(taken).not.toContain(slug);
-        });
-    });
-});