@skillsmith/mcp-server 0.4.2 → 0.4.3

package/dist/src/__tests__/context.async.test.js

@@ -0,0 +1,223 @@
+/**
+ * Tests for async tool context creation with WASM fallback
+ *
+ * @see SMI-2756: Wave 3 coverage — async context lifecycle
+ * @see SMI-2207: Async database functions with WASM fallback
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { tmpdir } from 'os';
+import { join } from 'path';
+// ---------------------------------------------------------------------------
+// Hoisted mock state — must be declared with vi.hoisted() so they are
+// accessible in the vi.mock() factory closures (hoisted to top of file).
+// ---------------------------------------------------------------------------
+const { mockExistsSync } = vi.hoisted(() => ({
+    mockExistsSync: vi.fn().mockReturnValue(false),
+}));
+// ---------------------------------------------------------------------------
+// Module-level mocks
+// ---------------------------------------------------------------------------
+vi.mock('fs', async (importOriginal) => {
+    const actual = await importOriginal();
+    return { ...actual, existsSync: mockExistsSync };
+});
+vi.mock('../context.helpers.js', () => ({
+    getDefaultDbPath: vi.fn().mockReturnValue(':memory:'),
+    ensureDbDirectory: vi.fn(),
+}));
+vi.mock('../llm/failover.js', () => {
+    class MockLLMFailoverChain {
+        initialize = vi.fn().mockResolvedValue(undefined);
+        close = vi.fn();
+    }
+    return { LLMFailoverChain: MockLLMFailoverChain };
+});
+vi.mock('@skillsmith/core', async (importOriginal) => {
+    const actual = await importOriginal();
+    function makeMockDb(name = ':memory:') {
+        return {
+            close: vi.fn(),
+            exec: vi.fn(),
+            prepare: vi.fn().mockReturnValue({
+                run: vi.fn().mockReturnValue({ changes: 0, lastInsertRowid: 0 }),
+                get: vi.fn().mockReturnValue(undefined),
+                all: vi.fn().mockReturnValue([]),
+            }),
+            transaction: vi.fn().mockImplementation((fn) => fn),
+            pragma: vi.fn(),
+            open: true,
+            name,
+            memory: name === ':memory:',
+            readonly: false,
+        };
+    }
+    class MockSearchService {
+    }
+    class MockSkillRepository {
+    }
+    class MockSkillsmithApiClient {
+        isOffline() {
+            return true;
+        }
+    }
+    class MockSyncConfigRepository {
+        getConfig() {
+            return { enabled: false };
+        }
+    }
+    class MockSyncHistoryRepository {
+    }
+    class MockSyncEngine {
+    }
+    class MockSkillVersionRepository {
+    }
+    class MockBackgroundSyncService {
+        start = vi.fn();
+        stop = vi.fn();
+    }
+    return {
+        ...actual,
+        createDatabaseAsync: vi.fn().mockResolvedValue(makeMockDb(':memory:')),
+        openDatabaseAsync: vi.fn().mockResolvedValue(makeMockDb('existing.db')),
+        initializeSchema: vi.fn(),
+        SearchService: MockSearchService,
+        SkillRepository: MockSkillRepository,
+        SkillsmithApiClient: MockSkillsmithApiClient,
+        initializePostHog: vi.fn(),
+        shutdownPostHog: vi.fn().mockResolvedValue(undefined),
+        generateAnonymousId: vi.fn().mockReturnValue('anon-id-123'),
+        SyncConfigRepository: MockSyncConfigRepository,
+        SyncHistoryRepository: MockSyncHistoryRepository,
+        SyncEngine: MockSyncEngine,
+        SkillVersionRepository: MockSkillVersionRepository,
+        BackgroundSyncService: MockBackgroundSyncService,
+        getApiKey: vi.fn().mockReturnValue(undefined),
+        validateDbPath: actual.validateDbPath,
+    };
+});
+// ---------------------------------------------------------------------------
+// Import the module under test AFTER mocks are registered
+// ---------------------------------------------------------------------------
+import { createToolContextAsync, getToolContextAsync, resetAsyncToolContext, } from '../context.async.js';
+describe('context.async', () => {
+    beforeEach(async () => {
+        await resetAsyncToolContext();
+        // Disable background sync by default so tests don't hit SyncConfigRepository.getConfig()
+        vi.stubEnv('SKILLSMITH_BACKGROUND_SYNC', 'false');
+        mockExistsSync.mockReturnValue(false);
+    });
+    afterEach(async () => {
+        await resetAsyncToolContext();
+        vi.unstubAllEnvs();
+    });
+    // -------------------------------------------------------------------------
+    // createToolContextAsync
+    // -------------------------------------------------------------------------
+    describe('createToolContextAsync', () => {
+        it('creates context with in-memory database path', async () => {
+            const ctx = await createToolContextAsync({ dbPath: ':memory:' });
+            expect(ctx).toBeDefined();
+            expect(ctx.db).toBeDefined();
+            expect(ctx.searchService).toBeDefined();
+            expect(ctx.skillRepository).toBeDefined();
+            expect(ctx.apiClient).toBeDefined();
+        });
+        it('throws for path traversal in dbPath', async () => {
+            await expect(createToolContextAsync({ dbPath: '/etc/../../tmp/evil.db' })).rejects.toThrow(/Invalid database path/);
+        });
+        it('skips ensureDbDirectory for :memory: path', async () => {
+            const { ensureDbDirectory } = await import('../context.helpers.js');
+            await createToolContextAsync({ dbPath: ':memory:' });
+            expect(ensureDbDirectory).not.toHaveBeenCalled();
+        });
+        it('uses openDatabaseAsync when database file already exists', async () => {
+            const { openDatabaseAsync, createDatabaseAsync } = await import('@skillsmith/core');
+            const dbPath = join(tmpdir(), 'test-existing.db');
+            mockExistsSync.mockReturnValue(true);
+            // Reset call counts before this test's assertion
+            vi.mocked(openDatabaseAsync).mockClear();
+            vi.mocked(createDatabaseAsync).mockClear();
+            await createToolContextAsync({ dbPath });
+            expect(openDatabaseAsync).toHaveBeenCalledWith(dbPath);
+            expect(createDatabaseAsync).not.toHaveBeenCalled();
+        });
+        it('calls initializePostHog when telemetry env var is true', async () => {
+            const { initializePostHog } = await import('@skillsmith/core');
+            vi.stubEnv('SKILLSMITH_TELEMETRY_ENABLED', 'true');
+            vi.stubEnv('POSTHOG_API_KEY', 'phc_test-key');
+            await createToolContextAsync({ dbPath: ':memory:' });
+            expect(initializePostHog).toHaveBeenCalledWith(expect.objectContaining({ apiKey: 'phc_test-key' }));
+        });
+        it('does not create BackgroundSyncService when SKILLSMITH_BACKGROUND_SYNC is false', async () => {
+            vi.stubEnv('SKILLSMITH_BACKGROUND_SYNC', 'false');
+            const ctx = await createToolContextAsync({ dbPath: ':memory:' });
+            expect(ctx.backgroundSync).toBeUndefined();
+        });
+        it('creates LLMFailoverChain when SKILLSMITH_LLM_FAILOVER_ENABLED is true', async () => {
+            vi.stubEnv('SKILLSMITH_LLM_FAILOVER_ENABLED', 'true');
+            const ctx = await createToolContextAsync({ dbPath: ':memory:' });
+            expect(ctx.llmFailover).toBeDefined();
+        });
+    });
+    // -------------------------------------------------------------------------
+    // getToolContextAsync
+    // -------------------------------------------------------------------------
+    describe('getToolContextAsync', () => {
+        it('caches context on second call (returns same instance)', async () => {
+            const ctx1 = await getToolContextAsync({ dbPath: ':memory:' });
+            const ctx2 = await getToolContextAsync();
+            expect(ctx1).toBe(ctx2);
+        });
+        it('warns when options are provided after first initialisation', async () => {
+            const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+            await getToolContextAsync({ dbPath: ':memory:' });
+            // Second call with options — should warn and ignore them
+            await getToolContextAsync({ dbPath: ':memory:' });
+            expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('already initialized'));
+            warnSpy.mockRestore();
+        });
+    });
+    // -------------------------------------------------------------------------
+    // resetAsyncToolContext
+    // -------------------------------------------------------------------------
+    describe('resetAsyncToolContext', () => {
+        it('calls backgroundSync.stop() when backgroundSync is present', async () => {
+            vi.stubEnv('SKILLSMITH_BACKGROUND_SYNC', 'true');
+            const core = await import('@skillsmith/core');
+            const stopFn = vi.fn();
+            // Override SyncConfigRepository so the sync engine actually starts
+            const _OrigSyncConfig = core.SyncConfigRepository;
+            vi.spyOn(core, 'SyncConfigRepository').mockImplementationOnce(function () {
+                return { getConfig: () => ({ enabled: true }) };
+            });
+            // Override BackgroundSyncService to capture the stop method
+            const _OrigBgSync = core.BackgroundSyncService;
+            vi.spyOn(core, 'BackgroundSyncService').mockImplementationOnce(function () {
+                return { start: vi.fn(), stop: stopFn };
+            });
+            await getToolContextAsync({ dbPath: ':memory:' });
+            await resetAsyncToolContext();
+            expect(stopFn).toHaveBeenCalled();
+        });
+        it('calls llmFailover.close() when llmFailover is present', async () => {
+            vi.stubEnv('SKILLSMITH_LLM_FAILOVER_ENABLED', 'true');
+            const failoverModule = await import('../llm/failover.js');
+            const closeFn = vi.fn();
+            vi.spyOn(failoverModule, 'LLMFailoverChain').mockImplementationOnce(function () {
+                return { initialize: vi.fn().mockResolvedValue(undefined), close: closeFn };
+            });
+            await getToolContextAsync({ dbPath: ':memory:' });
+            await resetAsyncToolContext();
+            expect(closeFn).toHaveBeenCalled();
+        });
+        it('calls shutdownPostHog when distinctId is set', async () => {
+            const { shutdownPostHog } = await import('@skillsmith/core');
+            vi.stubEnv('SKILLSMITH_TELEMETRY_ENABLED', 'true');
+            vi.stubEnv('POSTHOG_API_KEY', 'phc_test-key');
+            await getToolContextAsync({ dbPath: ':memory:' });
+            await resetAsyncToolContext();
+            expect(shutdownPostHog).toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=context.async.test.js.map

package/dist/src/__tests__/context.async.test.js.map

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

package/dist/src/__tests__/middleware/errorFormatter.builders.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SMI-2754: Error Formatter Builders Tests
+ *
+ * Tests for the authentication-error builder functions in errorFormatter.builders.ts:
+ * - formatAuthenticationError
+ * - isAuthenticationError
+ * - extractAuthErrorDetails
+ */
+export {};
+//# sourceMappingURL=errorFormatter.builders.test.d.ts.map

package/dist/src/__tests__/middleware/errorFormatter.builders.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorFormatter.builders.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/middleware/errorFormatter.builders.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/src/__tests__/middleware/errorFormatter.builders.test.js

@@ -0,0 +1,93 @@
+/**
+ * SMI-2754: Error Formatter Builders Tests
+ *
+ * Tests for the authentication-error builder functions in errorFormatter.builders.ts:
+ * - formatAuthenticationError
+ * - isAuthenticationError
+ * - extractAuthErrorDetails
+ */
+import { describe, it, expect } from 'vitest';
+import { formatAuthenticationError, isAuthenticationError, extractAuthErrorDetails, } from '../../middleware/errorFormatter.builders.js';
+describe('formatAuthenticationError', () => {
+    it('returns MCP error response with default URLs when called with no arguments', () => {
+        const response = formatAuthenticationError();
+        expect(response.isError).toBe(true);
+        expect(response.content).toHaveLength(1);
+        expect(response.content[0].type).toBe('text');
+        expect(response.content[0].text).toContain('Authentication Required');
+        expect(response.content[0].text).toContain('https://skillsmith.app/signup');
+        expect(response.content[0].text).toContain('https://skillsmith.app/docs/getting-started#api-key');
+        expect(response._meta?.errorCode).toBe('AUTHENTICATION_REQUIRED');
+        expect(response._meta?.recoverable).toBe(true);
+    });
+    it('includes trial usage info when trialUsed and trialLimit are both provided', () => {
+        const response = formatAuthenticationError({
+            trialUsed: 8,
+            trialLimit: 10,
+        });
+        expect(response.content[0].text).toContain('8/10 free requests used');
+    });
+    it('omits trial usage info when only trialUsed is provided (both required)', () => {
+        const response = formatAuthenticationError({ trialUsed: 5 });
+        expect(response.content[0].text).not.toContain('free requests used');
+    });
+    it('uses custom signupUrl and docsUrl when provided in details', () => {
+        const response = formatAuthenticationError({
+            signupUrl: 'https://custom.example.com/register',
+            docsUrl: 'https://custom.example.com/docs',
+        });
+        expect(response.content[0].text).toContain('https://custom.example.com/register');
+        expect(response.content[0].text).toContain('https://custom.example.com/docs');
+        expect(response._meta?.upgradeUrl).toBe('https://custom.example.com/register');
+    });
+    it('includes reason text when provided', () => {
+        const response = formatAuthenticationError({
+            reason: 'Your free trial has been exhausted.',
+        });
+        expect(response.content[0].text).toContain('Your free trial has been exhausted.');
+    });
+});
+describe('isAuthenticationError', () => {
+    it('returns true when object has statusCode 401', () => {
+        expect(isAuthenticationError({ statusCode: 401, message: 'Unauthorized' })).toBe(true);
+    });
+    it('returns true when object has status 401', () => {
+        expect(isAuthenticationError({ status: 401 })).toBe(true);
+    });
+    it('returns true when message contains "authentication required" (case insensitive)', () => {
+        expect(isAuthenticationError({ message: 'Authentication Required for this route' })).toBe(true);
+    });
+    it('returns true when message contains "free trial exhausted"', () => {
+        expect(isAuthenticationError({ message: 'Free trial exhausted, please upgrade' })).toBe(true);
+    });
+    it('returns true when error field contains "authentication required"', () => {
+        expect(isAuthenticationError({ error: 'Authentication required' })).toBe(true);
+    });
+    it('returns false for an object that does not match any auth pattern', () => {
+        expect(isAuthenticationError({ statusCode: 403, message: 'Forbidden' })).toBe(false);
+    });
+    it('returns false for null input', () => {
+        expect(isAuthenticationError(null)).toBe(false);
+    });
+    it('returns false for non-object input (string)', () => {
+        expect(isAuthenticationError('error string')).toBe(false);
+    });
+});
+describe('extractAuthErrorDetails', () => {
+    it('returns the details object when present in the error', () => {
+        const details = { reason: 'Trial expired', trialUsed: 10, trialLimit: 10 };
+        const result = extractAuthErrorDetails({ status: 401, details });
+        expect(result).toEqual(details);
+    });
+    it('returns empty object when no details property is present', () => {
+        const result = extractAuthErrorDetails({ status: 401, message: 'Unauthorized' });
+        expect(result).toEqual({});
+    });
+    it('returns empty object for null input', () => {
+        expect(extractAuthErrorDetails(null)).toEqual({});
+    });
+    it('returns empty object for non-object input', () => {
+        expect(extractAuthErrorDetails(42)).toEqual({});
+    });
+});
+//# sourceMappingURL=errorFormatter.builders.test.js.map

package/dist/src/__tests__/middleware/errorFormatter.builders.test.js.map

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

package/dist/src/__tests__/middleware/license-renewal.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SMI-2756: Wave 3 — License middleware supplemental tests
+ *
+ * Companion file to license.test.ts (which exceeds the 500-line limit).
+ * Covers: expiration warning thresholds, getExpirationWarning boundary cases,
+ * invalidateCache forces re-validation, checkTool for community tools,
+ * createLicenseErrorResponse shape, and requireFeature HOF.
+ */
+export {};
+//# sourceMappingURL=license-renewal.test.d.ts.map

package/dist/src/__tests__/middleware/license-renewal.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license-renewal.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/middleware/license-renewal.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/src/__tests__/middleware/license-renewal.test.js

@@ -0,0 +1,152 @@
+/**
+ * SMI-2756: Wave 3 — License middleware supplemental tests
+ *
+ * Companion file to license.test.ts (which exceeds the 500-line limit).
+ * Covers: expiration warning thresholds, getExpirationWarning boundary cases,
+ * invalidateCache forces re-validation, checkTool for community tools,
+ * createLicenseErrorResponse shape, and requireFeature HOF.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { createLicenseMiddleware, getExpirationWarning, requireFeature, createLicenseErrorResponse, isEnterpriseFeature, requiresLicense, } from '../../middleware/license.js';
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+describe('License middleware — supplemental (SMI-2756)', () => {
+    beforeEach(() => {
+        vi.resetModules();
+        delete process.env.SKILLSMITH_LICENSE_KEY;
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        delete process.env.SKILLSMITH_LICENSE_KEY;
+    });
+    // -------------------------------------------------------------------------
+    // getExpirationWarning boundary cases
+    // -------------------------------------------------------------------------
+    describe('getExpirationWarning', () => {
+        it('returns undefined when expiresAt is undefined', () => {
+            expect(getExpirationWarning(undefined)).toBeUndefined();
+        });
+        it('returns undefined when license expires in more than 30 days', () => {
+            const future = new Date(Date.now() + 60 * MS_PER_DAY);
+            expect(getExpirationWarning(future)).toBeUndefined();
+        });
+        it('returns a warning string when license expires in <= 30 days', () => {
+            const soon = new Date(Date.now() + 15 * MS_PER_DAY);
+            const warning = getExpirationWarning(soon);
+            expect(typeof warning).toBe('string');
+            expect(warning).toContain('day');
+        });
+        it('returns singular "day" when exactly 1 day remains', () => {
+            const tomorrow = new Date(Date.now() + 1 * MS_PER_DAY + 60_000); // +1 min buffer
+            const warning = getExpirationWarning(tomorrow);
+            expect(warning).toContain('1 day');
+            // Should not say "1 days"
+            expect(warning).not.toContain('1 days');
+        });
+        it('returns undefined when license is already expired', () => {
+            const expired = new Date(Date.now() - MS_PER_DAY);
+            // daysUntilExpiry <= 0 — condition requires > 0
+            expect(getExpirationWarning(expired)).toBeUndefined();
+        });
+    });
+    // -------------------------------------------------------------------------
+    // checkTool — community tool (no license required)
+    // -------------------------------------------------------------------------
+    describe('checkTool — community tools', () => {
+        it('returns valid:true for a community tool even without license key', async () => {
+            const middleware = createLicenseMiddleware();
+            const result = await middleware.checkTool('search');
+            expect(result.valid).toBe(true);
+        });
+        it('returns valid:true for get_skill (community)', async () => {
+            const middleware = createLicenseMiddleware();
+            const result = await middleware.checkTool('get_skill');
+            expect(result.valid).toBe(true);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // invalidateCache forces community re-evaluation
+    // -------------------------------------------------------------------------
+    describe('invalidateCache', () => {
+        it('does not throw when called before any cache is populated', () => {
+            const middleware = createLicenseMiddleware();
+            expect(() => middleware.invalidateCache()).not.toThrow();
+        });
+        it('returns updated info after invalidation', async () => {
+            const middleware = createLicenseMiddleware();
+            // Populate cache
+            const first = await middleware.getLicenseInfo();
+            expect(first?.tier).toBe('community');
+            middleware.invalidateCache();
+            // Re-evaluate — should still succeed without error
+            const second = await middleware.getLicenseInfo();
+            expect(second?.tier).toBe('community');
+        });
+    });
+    // -------------------------------------------------------------------------
+    // createLicenseErrorResponse
+    // -------------------------------------------------------------------------
+    describe('createLicenseErrorResponse', () => {
+        it('returns isError:true', () => {
+            const response = createLicenseErrorResponse({
+                valid: false,
+                message: 'Upgrade required',
+                feature: 'audit_logging',
+                upgradeUrl: 'https://skillsmith.app/pricing',
+            });
+            expect(response.isError).toBe(true);
+        });
+        it('includes the message in content text', () => {
+            const response = createLicenseErrorResponse({
+                valid: false,
+                message: 'You need a team license',
+                feature: 'audit_logging',
+                upgradeUrl: 'https://skillsmith.app/pricing?feature=audit_logging',
+            });
+            const text = response.content[0].text;
+            const parsed = JSON.parse(text);
+            expect(parsed.message).toBe('You need a team license');
+        });
+        it('includes _meta.upgradeUrl when upgradeUrl is set', () => {
+            const response = createLicenseErrorResponse({
+                valid: false,
+                message: 'Upgrade',
+                upgradeUrl: 'https://skillsmith.app/pricing',
+            });
+            expect(response._meta?.upgradeUrl).toBe('https://skillsmith.app/pricing');
+        });
+    });
+    // -------------------------------------------------------------------------
+    // requireFeature HOF
+    // -------------------------------------------------------------------------
+    describe('requireFeature', () => {
+        it('returns a function that delegates to middleware.checkFeature', async () => {
+            const checkFeatureMock = vi.fn().mockResolvedValue({ valid: true });
+            const mockMiddleware = {
+                checkFeature: checkFeatureMock,
+                checkTool: vi.fn(),
+                getLicenseInfo: vi.fn(),
+                invalidateCache: vi.fn(),
+            };
+            const requireAuditLogging = requireFeature('audit_logging');
+            const result = await requireAuditLogging(mockMiddleware);
+            expect(checkFeatureMock).toHaveBeenCalledWith('audit_logging');
+            expect(result.valid).toBe(true);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // isEnterpriseFeature / requiresLicense helpers
+    // -------------------------------------------------------------------------
+    describe('helper functions', () => {
+        it('isEnterpriseFeature returns false for unknown tool name', () => {
+            expect(isEnterpriseFeature('nonexistent_tool')).toBe(false);
+        });
+        it('requiresLicense returns false for community tools', () => {
+            expect(requiresLicense('search')).toBe(false);
+            expect(requiresLicense('get_skill')).toBe(false);
+        });
+        it('requiresLicense returns false for unknown tools', () => {
+            expect(requiresLicense('completely_made_up_tool')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=license-renewal.test.js.map

package/dist/src/__tests__/middleware/license-renewal.test.js.map

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

package/dist/src/__tests__/middleware/quota-helpers.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SMI-2755 Wave 2: Quota helpers pure-function unit tests
+ *
+ * Tests for InMemoryQuotaStorage, getWarningMessage, and getWarningLevel
+ * from quota-helpers.ts. No mocking needed — all pure functions or
+ * simple in-memory operations.
+ */
+export {};
+//# sourceMappingURL=quota-helpers.test.d.ts.map

package/dist/src/__tests__/middleware/quota-helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-helpers.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/middleware/quota-helpers.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}