refactor(clerk-js): Remove unused debugLogger functionality#6615

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jacekradko merged 5 commits into from
Aug 24, 2025
Merged

refactor(clerk-js): Remove unused debugLogger functionality #6615

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
d0f2476
refactor(clerk-js): Remove unused functionality
jacekradko Aug 23, 2025
e0d444d
additional removal
jacekradko Aug 23, 2025
3bb114d
remove unused utility types
jacekradko Aug 23, 2025
9b3e657
changeset
jacekradko Aug 23, 2025
3c13778
pr feedback
jacekradko Aug 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/dull-rules-dance.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
---
'@clerk/clerk-js': patch
---

Removing unused debugLogger functionality
8 changes: 0 additions & 8 deletions packages/clerk-js/src/core/clerk.ts
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -85,7 +85,6 @@ import type {
Web3Provider,
} from '@clerk/types';

import type { DebugLoggerInterface } from '@/utils/debug';
import { debugLogger, initDebugLogger } from '@/utils/debug';

import type { MountComponentRenderer } from '../ui/Components';
Expand DownExpand Up@@ -163,11 +162,6 @@ type SetActiveHook = (intent?: 'sign-out') => void | Promise<void>;

export type ClerkCoreBroadcastChannelEvent = { type: 'signout' };

/**
* Interface for the debug logger with all available logging methods
*/
// DebugLoggerInterface imported from '@/utils/debug'

declare global {
interface Window {
Clerk?: Clerk;
Expand DownExpand Up@@ -219,8 +213,6 @@ export class Clerk implements ClerkInterface {
public __internal_country?: string | null;
public telemetry: TelemetryCollector | undefined;
public readonly __internal_state: State = new State();
// Deprecated: use global singleton from `@/utils/debug`
public debugLogger?: DebugLoggerInterface;

protected internal_last_error: ClerkAPIError | null = null;
// converted to protected environment to support `updateEnvironment` type assertion
Expand Down
291 changes: 42 additions & 249 deletions packages/clerk-js/src/core/modules/debug/__tests__/logger.spec.ts
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
import { afterEach, beforeEach, describe, expect, it } from 'vitest';

import { DebugLogger } from '../logger';
import type { DebugLogEntry, DebugLogFilter } from '../types';
import type { DebugLogEntry } from '../types';

// Mock transport for testing
class MockTransport {
public sentEntries: DebugLogEntry[] = [];

Expand All@@ -22,7 +21,7 @@ describe('DebugLogger', () => {

beforeEach(() => {
mockTransport = new MockTransport();
logger = new DebugLogger(mockTransport, 'trace');
logger = new DebugLogger(mockTransport, 'debug');
});

afterEach(() => {
Expand All@@ -35,14 +34,12 @@ describe('DebugLogger', () => {
logger.warn('warn message');
logger.info('info message');
logger.debug('debug message');
logger.trace('trace message');

expect(mockTransport.sentEntries).toHaveLength(5);
expect(mockTransport.sentEntries).toHaveLength(4);
expect(mockTransport.sentEntries[0].level).toBe('error');
expect(mockTransport.sentEntries[1].level).toBe('warn');
expect(mockTransport.sentEntries[2].level).toBe('info');
expect(mockTransport.sentEntries[3].level).toBe('debug');
expect(mockTransport.sentEntries[4].level).toBe('trace');
});

it('should include context and source in log entries', () => {
Expand All@@ -59,7 +56,6 @@ describe('DebugLogger', () => {
it('should respect log level filtering', () => {
const infoLogger = new DebugLogger(mockTransport, 'info');

infoLogger.trace('trace message');
infoLogger.debug('debug message');
infoLogger.info('info message');
infoLogger.warn('warn message');
Expand All@@ -70,267 +66,64 @@ describe('DebugLogger', () => {
});
});

describe('filter functionality', () => {
describe('level filtering', () => {
it('should filter by specific log level', () => {
const filters: DebugLogFilter[] = [{ level: 'error' }];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
describe('edge cases', () => {
it('should handle undefined context', () => {
logger.info('message with undefined context', undefined);

filteredLogger.info('info message');
filteredLogger.warn('warn message');
filteredLogger.error('error message');

expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].level).toBe('error');
});

it('should allow all levels when no level filter is specified', () => {
const filters: DebugLogFilter[] = [{}];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.info('info message');
filteredLogger.warn('warn message');
filteredLogger.error('error message');

expect(mockTransport.sentEntries).toHaveLength(3);
});
});

describe('source filtering', () => {
it('should filter by exact string source', () => {
const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.info('message 1', undefined, 'auth-module');
filteredLogger.info('message 2', undefined, 'other-module');
filteredLogger.info('message 3', undefined, 'auth-module');

expect(mockTransport.sentEntries).toHaveLength(2);
expect(mockTransport.sentEntries[0].source).toBe('auth-module');
expect(mockTransport.sentEntries[1].source).toBe('auth-module');
});

it('should filter by RegExp source pattern', () => {
const filters: DebugLogFilter[] = [{ source: /auth-.*/ }];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.info('message 1', undefined, 'auth-module');
filteredLogger.info('message 2', undefined, 'auth-service');
filteredLogger.info('message 3', undefined, 'other-module');

expect(mockTransport.sentEntries).toHaveLength(2);
expect(mockTransport.sentEntries[0].source).toBe('auth-module');
expect(mockTransport.sentEntries[1].source).toBe('auth-service');
});

it('should not log when source is undefined and filter expects a source', () => {
const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.info('message without source');

expect(mockTransport.sentEntries).toHaveLength(0);
});
});

describe('include pattern filtering', () => {
it('should include messages matching string patterns', () => {
const filters: DebugLogFilter[] = [{ includePatterns: ['user', 'auth'] }];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.info('user login successful');
filteredLogger.info('auth token refreshed');
filteredLogger.info('database connection established');

expect(mockTransport.sentEntries).toHaveLength(2);
expect(mockTransport.sentEntries[0].message).toBe('user login successful');
expect(mockTransport.sentEntries[1].message).toBe('auth token refreshed');
});

it('should include messages matching RegExp patterns', () => {
const filters: DebugLogFilter[] = [{ includePatterns: [/user-.*/] }];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.info('user-123 logged in');
filteredLogger.info('user-456 logged out');
filteredLogger.info('admin panel accessed');

expect(mockTransport.sentEntries).toHaveLength(2);
expect(mockTransport.sentEntries[0].message).toBe('user-123 logged in');
expect(mockTransport.sentEntries[1].message).toBe('user-456 logged out');
});
});

describe('exclude pattern filtering', () => {
it('should exclude messages matching string patterns', () => {
const filters: DebugLogFilter[] = [{ excludePatterns: ['debug', 'test'] }];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.info('user login successful');
filteredLogger.info('debug information logged');
filteredLogger.info('test data generated');

expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].message).toBe('user login successful');
});

it('should exclude messages matching RegExp patterns', () => {
const filters: DebugLogFilter[] = [{ excludePatterns: [/test-.*/] }];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.info('user login successful');
filteredLogger.info('test-123 created');
filteredLogger.info('test-456 deleted');

expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].message).toBe('user login successful');
});
expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].context).toBeUndefined();
});

// Note: userId and sessionId filtering are defined in types but not yet implemented
// These tests are commented out until the feature is implemented
/*
describe('userId filtering', () => {
it('should filter by specific userId', () => {
const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.info('message 1', { userId: 'user-123' });
filteredLogger.info('message 2', { userId: 'user-456' });
filteredLogger.info('message 3', { userId: 'user-123' });

expect(mockTransport.sentEntries).toHaveLength(2);
expect(mockTransport.sentEntries[0].context?.userId).toBe('user-123');
expect(mockTransport.sentEntries[1].context?.userId).toBe('user-123');
});
it('should handle undefined source', () => {
logger.info('message with undefined source', {}, undefined);

it('should not log when userId is undefined and filter expects a userId', () => {
const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.info('message without userId');

expect(mockTransport.sentEntries).toHaveLength(0);
});
expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].source).toBeUndefined();
});

describe('sessionId filtering', () => {
it('should filter by specific sessionId', () => {
const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
it('should handle empty context object', () => {
logger.info('message with empty context', {});

filteredLogger.info('message 1', { sessionId: 'session-abc' });
filteredLogger.info('message 2', { sessionId: 'session-xyz' });
filteredLogger.info('message 3', { sessionId: 'session-abc' });

expect(mockTransport.sentEntries).toHaveLength(2);
expect(mockTransport.sentEntries[0].context?.sessionId).toBe('session-abc');
expect(mockTransport.sentEntries[1].context?.sessionId).toBe('session-abc');
});

it('should not log when sessionId is undefined and filter expects a sessionId', () => {
const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.info('message without sessionId');

expect(mockTransport.sentEntries).toHaveLength(0);
});
expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].context).toEqual({});
});
*/

describe('combined filtering', () => {
it('should apply multiple filters with AND logic', () => {
const filters: DebugLogFilter[] = [
{ level: 'error' },
{ source: 'auth-module' },
{ includePatterns: ['failed'] },
];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.error('login failed', undefined, 'auth-module');
filteredLogger.error('login successful', undefined, 'auth-module');
filteredLogger.warn('login failed', undefined, 'auth-module');
filteredLogger.error('login failed', undefined, 'other-module');

expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].message).toBe('login failed');
expect(mockTransport.sentEntries[0].level).toBe('error');
expect(mockTransport.sentEntries[0].source).toBe('auth-module');
});
it('should handle empty source string', () => {
logger.info('message with empty source', {}, '');

it('should handle empty filters array', () => {
const filters: DebugLogFilter[] = [];
const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

filteredLogger.info('message 1');
filteredLogger.warn('message 2');
filteredLogger.error('message 3');

expect(mockTransport.sentEntries).toHaveLength(3);
});
expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].source).toBe('');
});
});

describe('edge cases', () => {
it('should handle undefined context', () => {
logger.info('message with undefined context', undefined);

expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].context).toBeUndefined();
});

it('should handle undefined source', () => {
logger.info('message with undefined source', {}, undefined);

expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].source).toBeUndefined();
});
describe('transport integration', () => {
it('should call transport.send for each log entry', async () => {
let sendCallCount = 0;
const countingTransport = {
async send(_entry: DebugLogEntry): Promise<void> {
sendCallCount++;
},
};

it('should handle empty context object', () => {
logger.info('message with empty context', {});
const testLogger = new DebugLogger(countingTransport, 'info');

expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].context).toEqual({});
});
testLogger.info('message 1');
testLogger.warn('message 2');
testLogger.error('message 3');

it('should handle empty source string', () => {
logger.info('message with empty source', {}, '');
await new Promise(resolve => setTimeout(resolve, 0));

expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].source).toBe('');
});
expect(sendCallCount).toBe(3);
});

describe('transport integration', () => {
it('should call transport.send for each log entry', async () => {
let sendCallCount = 0;
const countingTransport = {
async send(_entry: DebugLogEntry): Promise<void> {
sendCallCount++;
},
};
it('should include timestamp in log entries', () => {
const beforeTime = Date.now();
logger.info('test message');
const afterTime = Date.now();

const testLogger = new DebugLogger(countingTransport, 'info');

testLogger.info('message 1');
testLogger.warn('message 2');
testLogger.error('message 3');

// Allow async operations to complete
await new Promise(resolve => setTimeout(resolve, 0));

expect(sendCallCount).toBe(3);
});

it('should include timestamp in log entries', () => {
const beforeTime = Date.now();
logger.info('test message');
const afterTime = Date.now();

expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
});
expect(mockTransport.sentEntries).toHaveLength(1);
expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
});
});
});
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
refactor(clerk-js): Remove unused debugLogger functionality#6615

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

jacekradko
merged 5 commits into

from

Aug 24, 2025
 Merged


refactor(clerk-js): Remove unused debugLogger functionality
#6615
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


5 commits


Select commit
Hold shift + click to select a range
d0f2476

refactor(clerk-js): Remove unused functionality


jacekradko Aug 23, 2025
e0d444d

additional removal


jacekradko Aug 23, 2025
3bb114d

remove unused utility types


jacekradko Aug 23, 2025
9b3e657

changeset


jacekradko Aug 23, 2025
3c13778

pr feedback


jacekradko Aug 23, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


5 changes: 5 additions & 0 deletions
.changeset/dull-rules-dance.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
---
'@clerk/clerk-js': patch
---

Removing unused debugLogger functionality

8 changes: 0 additions & 8 deletions
packages/clerk-js/src/core/clerk.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -85,7 +85,6 @@ import type {
 Web3Provider,
} from '@clerk/types';

import type { DebugLoggerInterface } from '@/utils/debug';
import { debugLogger, initDebugLogger } from '@/utils/debug';

import type { MountComponentRenderer } from '../ui/Components';
Expand DownExpand Up@@ -163,11 +162,6 @@ type SetActiveHook = (intent?: 'sign-out') => void | Promise<void>;

export type ClerkCoreBroadcastChannelEvent = { type: 'signout' };

/**
 * Interface for the debug logger with all available logging methods
 */
// DebugLoggerInterface imported from '@/utils/debug'

declare global {
 interface Window {
 Clerk?: Clerk;
Expand DownExpand Up@@ -219,8 +213,6 @@ export class Clerk implements ClerkInterface {
 public __internal_country?: string | null;
 public telemetry: TelemetryCollector | undefined;
 public readonly __internal_state: State = new State();
 // Deprecated: use global singleton from `@/utils/debug`
 public debugLogger?: DebugLoggerInterface;

 protected internal_last_error: ClerkAPIError | null = null;
 // converted to protected environment to support `updateEnvironment` type assertion
Expand Down

291 changes: 42 additions & 249 deletions
packages/clerk-js/src/core/modules/debug/__tests__/logger.spec.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
import { afterEach, beforeEach, describe, expect, it } from 'vitest';

import { DebugLogger } from '../logger';
import type { DebugLogEntry, DebugLogFilter } from '../types';
import type { DebugLogEntry } from '../types';

// Mock transport for testing
class MockTransport {
 public sentEntries: DebugLogEntry[] = [];

Expand All@@ -22,7 +21,7 @@ describe('DebugLogger', () => {

 beforeEach(() => {
 mockTransport = new MockTransport();
 logger = new DebugLogger(mockTransport, 'trace');
 logger = new DebugLogger(mockTransport, 'debug');
 });

 afterEach(() => {
Expand All@@ -35,14 +34,12 @@ describe('DebugLogger', () => {
 logger.warn('warn message');
 logger.info('info message');
 logger.debug('debug message');
 logger.trace('trace message');

 expect(mockTransport.sentEntries).toHaveLength(5);
 expect(mockTransport.sentEntries).toHaveLength(4);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[1].level).toBe('warn');
 expect(mockTransport.sentEntries[2].level).toBe('info');
 expect(mockTransport.sentEntries[3].level).toBe('debug');
 expect(mockTransport.sentEntries[4].level).toBe('trace');
 });

 it('should include context and source in log entries', () => {
Expand All@@ -59,7 +56,6 @@ describe('DebugLogger', () => {
 it('should respect log level filtering', () => {
 const infoLogger = new DebugLogger(mockTransport, 'info');

 infoLogger.trace('trace message');
 infoLogger.debug('debug message');
 infoLogger.info('info message');
 infoLogger.warn('warn message');
Expand All@@ -70,267 +66,64 @@ describe('DebugLogger', () => {
 });
 });

 describe('filter functionality', () => {
 describe('level filtering', () => {
 it('should filter by specific log level', () => {
 const filters: DebugLogFilter[] = [{ level: 'error' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 });

 it('should allow all levels when no level filter is specified', () => {
 const filters: DebugLogFilter[] = [{}];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 });

 describe('source filtering', () => {
 it('should filter by exact string source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'other-module');
 filteredLogger.info('message 3', undefined, 'auth-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-module');
 });

 it('should filter by RegExp source pattern', () => {
 const filters: DebugLogFilter[] = [{ source: /auth-.*/ }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'auth-service');
 filteredLogger.info('message 3', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-service');
 });

 it('should not log when source is undefined and filter expects a source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without source');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 });

 describe('include pattern filtering', () => {
 it('should include messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: ['user', 'auth'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('auth token refreshed');
 filteredLogger.info('database connection established');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 expect(mockTransport.sentEntries[1].message).toBe('auth token refreshed');
 });

 it('should include messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: [/user-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user-123 logged in');
 filteredLogger.info('user-456 logged out');
 filteredLogger.info('admin panel accessed');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user-123 logged in');
 expect(mockTransport.sentEntries[1].message).toBe('user-456 logged out');
 });
 });

 describe('exclude pattern filtering', () => {
 it('should exclude messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: ['debug', 'test'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('debug information logged');
 filteredLogger.info('test data generated');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });

 it('should exclude messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: [/test-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('test-123 created');
 filteredLogger.info('test-456 deleted');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 // Note: userId and sessionId filtering are defined in types but not yet implemented
 // These tests are commented out until the feature is implemented
 /*
 describe('userId filtering', () => {
 it('should filter by specific userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', { userId: 'user-123' });
 filteredLogger.info('message 2', { userId: 'user-456' });
 filteredLogger.info('message 3', { userId: 'user-123' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.userId).toBe('user-123');
 expect(mockTransport.sentEntries[1].context?.userId).toBe('user-123');
 });
 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 it('should not log when userId is undefined and filter expects a userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without userId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });

 describe('sessionId filtering', () => {
 it('should filter by specific sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 it('should handle empty context object', () => {
 logger.info('message with empty context', {});

 filteredLogger.info('message 1', { sessionId: 'session-abc' });
 filteredLogger.info('message 2', { sessionId: 'session-xyz' });
 filteredLogger.info('message 3', { sessionId: 'session-abc' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.sessionId).toBe('session-abc');
 expect(mockTransport.sentEntries[1].context?.sessionId).toBe('session-abc');
 });

 it('should not log when sessionId is undefined and filter expects a sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without sessionId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
 });
 */

 describe('combined filtering', () => {
 it('should apply multiple filters with AND logic', () => {
 const filters: DebugLogFilter[] = [
 { level: 'error' },
 { source: 'auth-module' },
 { includePatterns: ['failed'] },
 ];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.error('login failed', undefined, 'auth-module');
 filteredLogger.error('login successful', undefined, 'auth-module');
 filteredLogger.warn('login failed', undefined, 'auth-module');
 filteredLogger.error('login failed', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('login failed');
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 });
 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');

 it('should handle empty filters array', () => {
 const filters: DebugLogFilter[] = [];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1');
 filteredLogger.warn('message 2');
 filteredLogger.error('message 3');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 });

 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });
 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };

 it('should handle empty context object', () => {
 logger.info('message with empty context', {});
 const testLogger = new DebugLogger(countingTransport, 'info');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
});
testLogger.info('message 1');
testLogger.warn('message 2');
testLogger.error('message 3');

 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 expect(sendCallCount).toBe(3);
 });

 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };
 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 const testLogger = new DebugLogger(countingTransport, 'info');

 testLogger.info('message 1');
 testLogger.warn('message 2');
 testLogger.error('message 3');

 // Allow async operations to complete
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(sendCallCount).toBe(3);
 });

 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 });
});
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
refactor(clerk-js): Remove unused debugLogger functionality#6615

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

jacekradko
merged 5 commits into

from

Aug 24, 2025
 Merged


refactor(clerk-js): Remove unused debugLogger functionality
#6615
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


5 commits


Select commit
Hold shift + click to select a range
d0f2476

refactor(clerk-js): Remove unused functionality


jacekradko Aug 23, 2025
e0d444d

additional removal


jacekradko Aug 23, 2025
3bb114d

remove unused utility types


jacekradko Aug 23, 2025
9b3e657

changeset


jacekradko Aug 23, 2025
3c13778

pr feedback


jacekradko Aug 23, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


5 changes: 5 additions & 0 deletions
.changeset/dull-rules-dance.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
---
'@clerk/clerk-js': patch
---

Removing unused debugLogger functionality

8 changes: 0 additions & 8 deletions
packages/clerk-js/src/core/clerk.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -85,7 +85,6 @@ import type {
 Web3Provider,
} from '@clerk/types';

import type { DebugLoggerInterface } from '@/utils/debug';
import { debugLogger, initDebugLogger } from '@/utils/debug';

import type { MountComponentRenderer } from '../ui/Components';
Expand DownExpand Up@@ -163,11 +162,6 @@ type SetActiveHook = (intent?: 'sign-out') => void | Promise<void>;

export type ClerkCoreBroadcastChannelEvent = { type: 'signout' };

/**
 * Interface for the debug logger with all available logging methods
 */
// DebugLoggerInterface imported from '@/utils/debug'

declare global {
 interface Window {
 Clerk?: Clerk;
Expand DownExpand Up@@ -219,8 +213,6 @@ export class Clerk implements ClerkInterface {
 public __internal_country?: string | null;
 public telemetry: TelemetryCollector | undefined;
 public readonly __internal_state: State = new State();
 // Deprecated: use global singleton from `@/utils/debug`
 public debugLogger?: DebugLoggerInterface;

 protected internal_last_error: ClerkAPIError | null = null;
 // converted to protected environment to support `updateEnvironment` type assertion
Expand Down

291 changes: 42 additions & 249 deletions
packages/clerk-js/src/core/modules/debug/__tests__/logger.spec.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
import { afterEach, beforeEach, describe, expect, it } from 'vitest';

import { DebugLogger } from '../logger';
import type { DebugLogEntry, DebugLogFilter } from '../types';
import type { DebugLogEntry } from '../types';

// Mock transport for testing
class MockTransport {
 public sentEntries: DebugLogEntry[] = [];

Expand All@@ -22,7 +21,7 @@ describe('DebugLogger', () => {

 beforeEach(() => {
 mockTransport = new MockTransport();
 logger = new DebugLogger(mockTransport, 'trace');
 logger = new DebugLogger(mockTransport, 'debug');
 });

 afterEach(() => {
Expand All@@ -35,14 +34,12 @@ describe('DebugLogger', () => {
 logger.warn('warn message');
 logger.info('info message');
 logger.debug('debug message');
 logger.trace('trace message');

 expect(mockTransport.sentEntries).toHaveLength(5);
 expect(mockTransport.sentEntries).toHaveLength(4);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[1].level).toBe('warn');
 expect(mockTransport.sentEntries[2].level).toBe('info');
 expect(mockTransport.sentEntries[3].level).toBe('debug');
 expect(mockTransport.sentEntries[4].level).toBe('trace');
 });

 it('should include context and source in log entries', () => {
Expand All@@ -59,7 +56,6 @@ describe('DebugLogger', () => {
 it('should respect log level filtering', () => {
 const infoLogger = new DebugLogger(mockTransport, 'info');

 infoLogger.trace('trace message');
 infoLogger.debug('debug message');
 infoLogger.info('info message');
 infoLogger.warn('warn message');
Expand All@@ -70,267 +66,64 @@ describe('DebugLogger', () => {
 });
 });

 describe('filter functionality', () => {
 describe('level filtering', () => {
 it('should filter by specific log level', () => {
 const filters: DebugLogFilter[] = [{ level: 'error' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 });

 it('should allow all levels when no level filter is specified', () => {
 const filters: DebugLogFilter[] = [{}];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 });

 describe('source filtering', () => {
 it('should filter by exact string source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'other-module');
 filteredLogger.info('message 3', undefined, 'auth-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-module');
 });

 it('should filter by RegExp source pattern', () => {
 const filters: DebugLogFilter[] = [{ source: /auth-.*/ }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'auth-service');
 filteredLogger.info('message 3', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-service');
 });

 it('should not log when source is undefined and filter expects a source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without source');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 });

 describe('include pattern filtering', () => {
 it('should include messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: ['user', 'auth'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('auth token refreshed');
 filteredLogger.info('database connection established');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 expect(mockTransport.sentEntries[1].message).toBe('auth token refreshed');
 });

 it('should include messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: [/user-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user-123 logged in');
 filteredLogger.info('user-456 logged out');
 filteredLogger.info('admin panel accessed');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user-123 logged in');
 expect(mockTransport.sentEntries[1].message).toBe('user-456 logged out');
 });
 });

 describe('exclude pattern filtering', () => {
 it('should exclude messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: ['debug', 'test'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('debug information logged');
 filteredLogger.info('test data generated');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });

 it('should exclude messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: [/test-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('test-123 created');
 filteredLogger.info('test-456 deleted');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 // Note: userId and sessionId filtering are defined in types but not yet implemented
 // These tests are commented out until the feature is implemented
 /*
 describe('userId filtering', () => {
 it('should filter by specific userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', { userId: 'user-123' });
 filteredLogger.info('message 2', { userId: 'user-456' });
 filteredLogger.info('message 3', { userId: 'user-123' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.userId).toBe('user-123');
 expect(mockTransport.sentEntries[1].context?.userId).toBe('user-123');
 });
 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 it('should not log when userId is undefined and filter expects a userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without userId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });

 describe('sessionId filtering', () => {
 it('should filter by specific sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 it('should handle empty context object', () => {
 logger.info('message with empty context', {});

 filteredLogger.info('message 1', { sessionId: 'session-abc' });
 filteredLogger.info('message 2', { sessionId: 'session-xyz' });
 filteredLogger.info('message 3', { sessionId: 'session-abc' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.sessionId).toBe('session-abc');
 expect(mockTransport.sentEntries[1].context?.sessionId).toBe('session-abc');
 });

 it('should not log when sessionId is undefined and filter expects a sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without sessionId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
 });
 */

 describe('combined filtering', () => {
 it('should apply multiple filters with AND logic', () => {
 const filters: DebugLogFilter[] = [
 { level: 'error' },
 { source: 'auth-module' },
 { includePatterns: ['failed'] },
 ];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.error('login failed', undefined, 'auth-module');
 filteredLogger.error('login successful', undefined, 'auth-module');
 filteredLogger.warn('login failed', undefined, 'auth-module');
 filteredLogger.error('login failed', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('login failed');
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 });
 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');

 it('should handle empty filters array', () => {
 const filters: DebugLogFilter[] = [];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1');
 filteredLogger.warn('message 2');
 filteredLogger.error('message 3');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 });

 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });
 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };

 it('should handle empty context object', () => {
 logger.info('message with empty context', {});
 const testLogger = new DebugLogger(countingTransport, 'info');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
});
testLogger.info('message 1');
testLogger.warn('message 2');
testLogger.error('message 3');

 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 expect(sendCallCount).toBe(3);
 });

 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };
 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 const testLogger = new DebugLogger(countingTransport, 'info');

 testLogger.info('message 1');
 testLogger.warn('message 2');
 testLogger.error('message 3');

 // Allow async operations to complete
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(sendCallCount).toBe(3);
 });

 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 });
});
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
refactor(clerk-js): Remove unused debugLogger functionality#6615

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

jacekradko
merged 5 commits into

from

Aug 24, 2025
 Merged


refactor(clerk-js): Remove unused debugLogger functionality
#6615
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


5 commits


Select commit
Hold shift + click to select a range
d0f2476

refactor(clerk-js): Remove unused functionality


jacekradko Aug 23, 2025
e0d444d

additional removal


jacekradko Aug 23, 2025
3bb114d

remove unused utility types


jacekradko Aug 23, 2025
9b3e657

changeset


jacekradko Aug 23, 2025
3c13778

pr feedback


jacekradko Aug 23, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


5 changes: 5 additions & 0 deletions
.changeset/dull-rules-dance.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
---
'@clerk/clerk-js': patch
---

Removing unused debugLogger functionality

8 changes: 0 additions & 8 deletions
packages/clerk-js/src/core/clerk.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -85,7 +85,6 @@ import type {
 Web3Provider,
} from '@clerk/types';

import type { DebugLoggerInterface } from '@/utils/debug';
import { debugLogger, initDebugLogger } from '@/utils/debug';

import type { MountComponentRenderer } from '../ui/Components';
Expand DownExpand Up@@ -163,11 +162,6 @@ type SetActiveHook = (intent?: 'sign-out') => void | Promise<void>;

export type ClerkCoreBroadcastChannelEvent = { type: 'signout' };

/**
 * Interface for the debug logger with all available logging methods
 */
// DebugLoggerInterface imported from '@/utils/debug'

declare global {
 interface Window {
 Clerk?: Clerk;
Expand DownExpand Up@@ -219,8 +213,6 @@ export class Clerk implements ClerkInterface {
 public __internal_country?: string | null;
 public telemetry: TelemetryCollector | undefined;
 public readonly __internal_state: State = new State();
 // Deprecated: use global singleton from `@/utils/debug`
 public debugLogger?: DebugLoggerInterface;

 protected internal_last_error: ClerkAPIError | null = null;
 // converted to protected environment to support `updateEnvironment` type assertion
Expand Down

291 changes: 42 additions & 249 deletions
packages/clerk-js/src/core/modules/debug/__tests__/logger.spec.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
import { afterEach, beforeEach, describe, expect, it } from 'vitest';

import { DebugLogger } from '../logger';
import type { DebugLogEntry, DebugLogFilter } from '../types';
import type { DebugLogEntry } from '../types';

// Mock transport for testing
class MockTransport {
 public sentEntries: DebugLogEntry[] = [];

Expand All@@ -22,7 +21,7 @@ describe('DebugLogger', () => {

 beforeEach(() => {
 mockTransport = new MockTransport();
 logger = new DebugLogger(mockTransport, 'trace');
 logger = new DebugLogger(mockTransport, 'debug');
 });

 afterEach(() => {
Expand All@@ -35,14 +34,12 @@ describe('DebugLogger', () => {
 logger.warn('warn message');
 logger.info('info message');
 logger.debug('debug message');
 logger.trace('trace message');

 expect(mockTransport.sentEntries).toHaveLength(5);
 expect(mockTransport.sentEntries).toHaveLength(4);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[1].level).toBe('warn');
 expect(mockTransport.sentEntries[2].level).toBe('info');
 expect(mockTransport.sentEntries[3].level).toBe('debug');
 expect(mockTransport.sentEntries[4].level).toBe('trace');
 });

 it('should include context and source in log entries', () => {
Expand All@@ -59,7 +56,6 @@ describe('DebugLogger', () => {
 it('should respect log level filtering', () => {
 const infoLogger = new DebugLogger(mockTransport, 'info');

 infoLogger.trace('trace message');
 infoLogger.debug('debug message');
 infoLogger.info('info message');
 infoLogger.warn('warn message');
Expand All@@ -70,267 +66,64 @@ describe('DebugLogger', () => {
 });
 });

 describe('filter functionality', () => {
 describe('level filtering', () => {
 it('should filter by specific log level', () => {
 const filters: DebugLogFilter[] = [{ level: 'error' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 });

 it('should allow all levels when no level filter is specified', () => {
 const filters: DebugLogFilter[] = [{}];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 });

 describe('source filtering', () => {
 it('should filter by exact string source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'other-module');
 filteredLogger.info('message 3', undefined, 'auth-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-module');
 });

 it('should filter by RegExp source pattern', () => {
 const filters: DebugLogFilter[] = [{ source: /auth-.*/ }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'auth-service');
 filteredLogger.info('message 3', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-service');
 });

 it('should not log when source is undefined and filter expects a source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without source');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 });

 describe('include pattern filtering', () => {
 it('should include messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: ['user', 'auth'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('auth token refreshed');
 filteredLogger.info('database connection established');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 expect(mockTransport.sentEntries[1].message).toBe('auth token refreshed');
 });

 it('should include messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: [/user-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user-123 logged in');
 filteredLogger.info('user-456 logged out');
 filteredLogger.info('admin panel accessed');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user-123 logged in');
 expect(mockTransport.sentEntries[1].message).toBe('user-456 logged out');
 });
 });

 describe('exclude pattern filtering', () => {
 it('should exclude messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: ['debug', 'test'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('debug information logged');
 filteredLogger.info('test data generated');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });

 it('should exclude messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: [/test-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('test-123 created');
 filteredLogger.info('test-456 deleted');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 // Note: userId and sessionId filtering are defined in types but not yet implemented
 // These tests are commented out until the feature is implemented
 /*
 describe('userId filtering', () => {
 it('should filter by specific userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', { userId: 'user-123' });
 filteredLogger.info('message 2', { userId: 'user-456' });
 filteredLogger.info('message 3', { userId: 'user-123' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.userId).toBe('user-123');
 expect(mockTransport.sentEntries[1].context?.userId).toBe('user-123');
 });
 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 it('should not log when userId is undefined and filter expects a userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without userId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });

 describe('sessionId filtering', () => {
 it('should filter by specific sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 it('should handle empty context object', () => {
 logger.info('message with empty context', {});

 filteredLogger.info('message 1', { sessionId: 'session-abc' });
 filteredLogger.info('message 2', { sessionId: 'session-xyz' });
 filteredLogger.info('message 3', { sessionId: 'session-abc' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.sessionId).toBe('session-abc');
 expect(mockTransport.sentEntries[1].context?.sessionId).toBe('session-abc');
 });

 it('should not log when sessionId is undefined and filter expects a sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without sessionId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
 });
 */

 describe('combined filtering', () => {
 it('should apply multiple filters with AND logic', () => {
 const filters: DebugLogFilter[] = [
 { level: 'error' },
 { source: 'auth-module' },
 { includePatterns: ['failed'] },
 ];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.error('login failed', undefined, 'auth-module');
 filteredLogger.error('login successful', undefined, 'auth-module');
 filteredLogger.warn('login failed', undefined, 'auth-module');
 filteredLogger.error('login failed', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('login failed');
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 });
 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');

 it('should handle empty filters array', () => {
 const filters: DebugLogFilter[] = [];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1');
 filteredLogger.warn('message 2');
 filteredLogger.error('message 3');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 });

 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });
 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };

 it('should handle empty context object', () => {
 logger.info('message with empty context', {});
 const testLogger = new DebugLogger(countingTransport, 'info');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
});
testLogger.info('message 1');
testLogger.warn('message 2');
testLogger.error('message 3');

 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 expect(sendCallCount).toBe(3);
 });

 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };
 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 const testLogger = new DebugLogger(countingTransport, 'info');

 testLogger.info('message 1');
 testLogger.warn('message 2');
 testLogger.error('message 3');

 // Allow async operations to complete
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(sendCallCount).toBe(3);
 });

 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 });
});
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
refactor(clerk-js): Remove unused debugLogger functionality#6615

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

jacekradko
merged 5 commits into

from

Aug 24, 2025
 Merged


refactor(clerk-js): Remove unused debugLogger functionality
#6615
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


5 commits


Select commit
Hold shift + click to select a range
d0f2476

refactor(clerk-js): Remove unused functionality


jacekradko Aug 23, 2025
e0d444d

additional removal


jacekradko Aug 23, 2025
3bb114d

remove unused utility types


jacekradko Aug 23, 2025
9b3e657

changeset


jacekradko Aug 23, 2025
3c13778

pr feedback


jacekradko Aug 23, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


5 changes: 5 additions & 0 deletions
.changeset/dull-rules-dance.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
---
'@clerk/clerk-js': patch
---

Removing unused debugLogger functionality

8 changes: 0 additions & 8 deletions
packages/clerk-js/src/core/clerk.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -85,7 +85,6 @@ import type {
 Web3Provider,
} from '@clerk/types';

import type { DebugLoggerInterface } from '@/utils/debug';
import { debugLogger, initDebugLogger } from '@/utils/debug';

import type { MountComponentRenderer } from '../ui/Components';
Expand DownExpand Up@@ -163,11 +162,6 @@ type SetActiveHook = (intent?: 'sign-out') => void | Promise<void>;

export type ClerkCoreBroadcastChannelEvent = { type: 'signout' };

/**
 * Interface for the debug logger with all available logging methods
 */
// DebugLoggerInterface imported from '@/utils/debug'

declare global {
 interface Window {
 Clerk?: Clerk;
Expand DownExpand Up@@ -219,8 +213,6 @@ export class Clerk implements ClerkInterface {
 public __internal_country?: string | null;
 public telemetry: TelemetryCollector | undefined;
 public readonly __internal_state: State = new State();
 // Deprecated: use global singleton from `@/utils/debug`
 public debugLogger?: DebugLoggerInterface;

 protected internal_last_error: ClerkAPIError | null = null;
 // converted to protected environment to support `updateEnvironment` type assertion
Expand Down

291 changes: 42 additions & 249 deletions
packages/clerk-js/src/core/modules/debug/__tests__/logger.spec.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
import { afterEach, beforeEach, describe, expect, it } from 'vitest';

import { DebugLogger } from '../logger';
import type { DebugLogEntry, DebugLogFilter } from '../types';
import type { DebugLogEntry } from '../types';

// Mock transport for testing
class MockTransport {
 public sentEntries: DebugLogEntry[] = [];

Expand All@@ -22,7 +21,7 @@ describe('DebugLogger', () => {

 beforeEach(() => {
 mockTransport = new MockTransport();
 logger = new DebugLogger(mockTransport, 'trace');
 logger = new DebugLogger(mockTransport, 'debug');
 });

 afterEach(() => {
Expand All@@ -35,14 +34,12 @@ describe('DebugLogger', () => {
 logger.warn('warn message');
 logger.info('info message');
 logger.debug('debug message');
 logger.trace('trace message');

 expect(mockTransport.sentEntries).toHaveLength(5);
 expect(mockTransport.sentEntries).toHaveLength(4);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[1].level).toBe('warn');
 expect(mockTransport.sentEntries[2].level).toBe('info');
 expect(mockTransport.sentEntries[3].level).toBe('debug');
 expect(mockTransport.sentEntries[4].level).toBe('trace');
 });

 it('should include context and source in log entries', () => {
Expand All@@ -59,7 +56,6 @@ describe('DebugLogger', () => {
 it('should respect log level filtering', () => {
 const infoLogger = new DebugLogger(mockTransport, 'info');

 infoLogger.trace('trace message');
 infoLogger.debug('debug message');
 infoLogger.info('info message');
 infoLogger.warn('warn message');
Expand All@@ -70,267 +66,64 @@ describe('DebugLogger', () => {
 });
 });

 describe('filter functionality', () => {
 describe('level filtering', () => {
 it('should filter by specific log level', () => {
 const filters: DebugLogFilter[] = [{ level: 'error' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 });

 it('should allow all levels when no level filter is specified', () => {
 const filters: DebugLogFilter[] = [{}];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 });

 describe('source filtering', () => {
 it('should filter by exact string source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'other-module');
 filteredLogger.info('message 3', undefined, 'auth-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-module');
 });

 it('should filter by RegExp source pattern', () => {
 const filters: DebugLogFilter[] = [{ source: /auth-.*/ }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'auth-service');
 filteredLogger.info('message 3', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-service');
 });

 it('should not log when source is undefined and filter expects a source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without source');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 });

 describe('include pattern filtering', () => {
 it('should include messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: ['user', 'auth'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('auth token refreshed');
 filteredLogger.info('database connection established');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 expect(mockTransport.sentEntries[1].message).toBe('auth token refreshed');
 });

 it('should include messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: [/user-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user-123 logged in');
 filteredLogger.info('user-456 logged out');
 filteredLogger.info('admin panel accessed');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user-123 logged in');
 expect(mockTransport.sentEntries[1].message).toBe('user-456 logged out');
 });
 });

 describe('exclude pattern filtering', () => {
 it('should exclude messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: ['debug', 'test'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('debug information logged');
 filteredLogger.info('test data generated');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });

 it('should exclude messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: [/test-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('test-123 created');
 filteredLogger.info('test-456 deleted');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 // Note: userId and sessionId filtering are defined in types but not yet implemented
 // These tests are commented out until the feature is implemented
 /*
 describe('userId filtering', () => {
 it('should filter by specific userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', { userId: 'user-123' });
 filteredLogger.info('message 2', { userId: 'user-456' });
 filteredLogger.info('message 3', { userId: 'user-123' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.userId).toBe('user-123');
 expect(mockTransport.sentEntries[1].context?.userId).toBe('user-123');
 });
 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 it('should not log when userId is undefined and filter expects a userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without userId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });

 describe('sessionId filtering', () => {
 it('should filter by specific sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 it('should handle empty context object', () => {
 logger.info('message with empty context', {});

 filteredLogger.info('message 1', { sessionId: 'session-abc' });
 filteredLogger.info('message 2', { sessionId: 'session-xyz' });
 filteredLogger.info('message 3', { sessionId: 'session-abc' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.sessionId).toBe('session-abc');
 expect(mockTransport.sentEntries[1].context?.sessionId).toBe('session-abc');
 });

 it('should not log when sessionId is undefined and filter expects a sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without sessionId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
 });
 */

 describe('combined filtering', () => {
 it('should apply multiple filters with AND logic', () => {
 const filters: DebugLogFilter[] = [
 { level: 'error' },
 { source: 'auth-module' },
 { includePatterns: ['failed'] },
 ];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.error('login failed', undefined, 'auth-module');
 filteredLogger.error('login successful', undefined, 'auth-module');
 filteredLogger.warn('login failed', undefined, 'auth-module');
 filteredLogger.error('login failed', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('login failed');
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 });
 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');

 it('should handle empty filters array', () => {
 const filters: DebugLogFilter[] = [];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1');
 filteredLogger.warn('message 2');
 filteredLogger.error('message 3');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 });

 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });
 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };

 it('should handle empty context object', () => {
 logger.info('message with empty context', {});
 const testLogger = new DebugLogger(countingTransport, 'info');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
});
testLogger.info('message 1');
testLogger.warn('message 2');
testLogger.error('message 3');

 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 expect(sendCallCount).toBe(3);
 });

 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };
 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 const testLogger = new DebugLogger(countingTransport, 'info');

 testLogger.info('message 1');
 testLogger.warn('message 2');
 testLogger.error('message 3');

 // Allow async operations to complete
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(sendCallCount).toBe(3);
 });

 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 });
});
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
refactor(clerk-js): Remove unused debugLogger functionality#6615

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

jacekradko
merged 5 commits into

from

Aug 24, 2025
 Merged


refactor(clerk-js): Remove unused debugLogger functionality
#6615
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


5 commits


Select commit
Hold shift + click to select a range
d0f2476

refactor(clerk-js): Remove unused functionality


jacekradko Aug 23, 2025
e0d444d

additional removal


jacekradko Aug 23, 2025
3bb114d

remove unused utility types


jacekradko Aug 23, 2025
9b3e657

changeset


jacekradko Aug 23, 2025
3c13778

pr feedback


jacekradko Aug 23, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


5 changes: 5 additions & 0 deletions
.changeset/dull-rules-dance.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
---
'@clerk/clerk-js': patch
---

Removing unused debugLogger functionality

8 changes: 0 additions & 8 deletions
packages/clerk-js/src/core/clerk.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -85,7 +85,6 @@ import type {
 Web3Provider,
} from '@clerk/types';

import type { DebugLoggerInterface } from '@/utils/debug';
import { debugLogger, initDebugLogger } from '@/utils/debug';

import type { MountComponentRenderer } from '../ui/Components';
Expand DownExpand Up@@ -163,11 +162,6 @@ type SetActiveHook = (intent?: 'sign-out') => void | Promise<void>;

export type ClerkCoreBroadcastChannelEvent = { type: 'signout' };

/**
 * Interface for the debug logger with all available logging methods
 */
// DebugLoggerInterface imported from '@/utils/debug'

declare global {
 interface Window {
 Clerk?: Clerk;
Expand DownExpand Up@@ -219,8 +213,6 @@ export class Clerk implements ClerkInterface {
 public __internal_country?: string | null;
 public telemetry: TelemetryCollector | undefined;
 public readonly __internal_state: State = new State();
 // Deprecated: use global singleton from `@/utils/debug`
 public debugLogger?: DebugLoggerInterface;

 protected internal_last_error: ClerkAPIError | null = null;
 // converted to protected environment to support `updateEnvironment` type assertion
Expand Down

291 changes: 42 additions & 249 deletions
packages/clerk-js/src/core/modules/debug/__tests__/logger.spec.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
import { afterEach, beforeEach, describe, expect, it } from 'vitest';

import { DebugLogger } from '../logger';
import type { DebugLogEntry, DebugLogFilter } from '../types';
import type { DebugLogEntry } from '../types';

// Mock transport for testing
class MockTransport {
 public sentEntries: DebugLogEntry[] = [];

Expand All@@ -22,7 +21,7 @@ describe('DebugLogger', () => {

 beforeEach(() => {
 mockTransport = new MockTransport();
 logger = new DebugLogger(mockTransport, 'trace');
 logger = new DebugLogger(mockTransport, 'debug');
 });

 afterEach(() => {
Expand All@@ -35,14 +34,12 @@ describe('DebugLogger', () => {
 logger.warn('warn message');
 logger.info('info message');
 logger.debug('debug message');
 logger.trace('trace message');

 expect(mockTransport.sentEntries).toHaveLength(5);
 expect(mockTransport.sentEntries).toHaveLength(4);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[1].level).toBe('warn');
 expect(mockTransport.sentEntries[2].level).toBe('info');
 expect(mockTransport.sentEntries[3].level).toBe('debug');
 expect(mockTransport.sentEntries[4].level).toBe('trace');
 });

 it('should include context and source in log entries', () => {
Expand All@@ -59,7 +56,6 @@ describe('DebugLogger', () => {
 it('should respect log level filtering', () => {
 const infoLogger = new DebugLogger(mockTransport, 'info');

 infoLogger.trace('trace message');
 infoLogger.debug('debug message');
 infoLogger.info('info message');
 infoLogger.warn('warn message');
Expand All@@ -70,267 +66,64 @@ describe('DebugLogger', () => {
 });
 });

 describe('filter functionality', () => {
 describe('level filtering', () => {
 it('should filter by specific log level', () => {
 const filters: DebugLogFilter[] = [{ level: 'error' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 });

 it('should allow all levels when no level filter is specified', () => {
 const filters: DebugLogFilter[] = [{}];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 });

 describe('source filtering', () => {
 it('should filter by exact string source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'other-module');
 filteredLogger.info('message 3', undefined, 'auth-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-module');
 });

 it('should filter by RegExp source pattern', () => {
 const filters: DebugLogFilter[] = [{ source: /auth-.*/ }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'auth-service');
 filteredLogger.info('message 3', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-service');
 });

 it('should not log when source is undefined and filter expects a source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without source');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 });

 describe('include pattern filtering', () => {
 it('should include messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: ['user', 'auth'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('auth token refreshed');
 filteredLogger.info('database connection established');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 expect(mockTransport.sentEntries[1].message).toBe('auth token refreshed');
 });

 it('should include messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: [/user-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user-123 logged in');
 filteredLogger.info('user-456 logged out');
 filteredLogger.info('admin panel accessed');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user-123 logged in');
 expect(mockTransport.sentEntries[1].message).toBe('user-456 logged out');
 });
 });

 describe('exclude pattern filtering', () => {
 it('should exclude messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: ['debug', 'test'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('debug information logged');
 filteredLogger.info('test data generated');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });

 it('should exclude messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: [/test-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('test-123 created');
 filteredLogger.info('test-456 deleted');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 // Note: userId and sessionId filtering are defined in types but not yet implemented
 // These tests are commented out until the feature is implemented
 /*
 describe('userId filtering', () => {
 it('should filter by specific userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', { userId: 'user-123' });
 filteredLogger.info('message 2', { userId: 'user-456' });
 filteredLogger.info('message 3', { userId: 'user-123' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.userId).toBe('user-123');
 expect(mockTransport.sentEntries[1].context?.userId).toBe('user-123');
 });
 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 it('should not log when userId is undefined and filter expects a userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without userId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });

 describe('sessionId filtering', () => {
 it('should filter by specific sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 it('should handle empty context object', () => {
 logger.info('message with empty context', {});

 filteredLogger.info('message 1', { sessionId: 'session-abc' });
 filteredLogger.info('message 2', { sessionId: 'session-xyz' });
 filteredLogger.info('message 3', { sessionId: 'session-abc' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.sessionId).toBe('session-abc');
 expect(mockTransport.sentEntries[1].context?.sessionId).toBe('session-abc');
 });

 it('should not log when sessionId is undefined and filter expects a sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without sessionId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
 });
 */

 describe('combined filtering', () => {
 it('should apply multiple filters with AND logic', () => {
 const filters: DebugLogFilter[] = [
 { level: 'error' },
 { source: 'auth-module' },
 { includePatterns: ['failed'] },
 ];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.error('login failed', undefined, 'auth-module');
 filteredLogger.error('login successful', undefined, 'auth-module');
 filteredLogger.warn('login failed', undefined, 'auth-module');
 filteredLogger.error('login failed', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('login failed');
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 });
 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');

 it('should handle empty filters array', () => {
 const filters: DebugLogFilter[] = [];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1');
 filteredLogger.warn('message 2');
 filteredLogger.error('message 3');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 });

 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });
 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };

 it('should handle empty context object', () => {
 logger.info('message with empty context', {});
 const testLogger = new DebugLogger(countingTransport, 'info');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
});
testLogger.info('message 1');
testLogger.warn('message 2');
testLogger.error('message 3');

 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 expect(sendCallCount).toBe(3);
 });

 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };
 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 const testLogger = new DebugLogger(countingTransport, 'info');

 testLogger.info('message 1');
 testLogger.warn('message 2');
 testLogger.error('message 3');

 // Allow async operations to complete
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(sendCallCount).toBe(3);
 });

 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 });
});
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
refactor(clerk-js): Remove unused debugLogger functionality#6615

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

jacekradko
merged 5 commits into

from

Aug 24, 2025
 Merged


refactor(clerk-js): Remove unused debugLogger functionality
#6615
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


5 commits


Select commit
Hold shift + click to select a range
d0f2476

refactor(clerk-js): Remove unused functionality


jacekradko Aug 23, 2025
e0d444d

additional removal


jacekradko Aug 23, 2025
3bb114d

remove unused utility types


jacekradko Aug 23, 2025
9b3e657

changeset


jacekradko Aug 23, 2025
3c13778

pr feedback


jacekradko Aug 23, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


5 changes: 5 additions & 0 deletions
.changeset/dull-rules-dance.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
---
'@clerk/clerk-js': patch
---

Removing unused debugLogger functionality

8 changes: 0 additions & 8 deletions
packages/clerk-js/src/core/clerk.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -85,7 +85,6 @@ import type {
 Web3Provider,
} from '@clerk/types';

import type { DebugLoggerInterface } from '@/utils/debug';
import { debugLogger, initDebugLogger } from '@/utils/debug';

import type { MountComponentRenderer } from '../ui/Components';
Expand DownExpand Up@@ -163,11 +162,6 @@ type SetActiveHook = (intent?: 'sign-out') => void | Promise<void>;

export type ClerkCoreBroadcastChannelEvent = { type: 'signout' };

/**
 * Interface for the debug logger with all available logging methods
 */
// DebugLoggerInterface imported from '@/utils/debug'

declare global {
 interface Window {
 Clerk?: Clerk;
Expand DownExpand Up@@ -219,8 +213,6 @@ export class Clerk implements ClerkInterface {
 public __internal_country?: string | null;
 public telemetry: TelemetryCollector | undefined;
 public readonly __internal_state: State = new State();
 // Deprecated: use global singleton from `@/utils/debug`
 public debugLogger?: DebugLoggerInterface;

 protected internal_last_error: ClerkAPIError | null = null;
 // converted to protected environment to support `updateEnvironment` type assertion
Expand Down

291 changes: 42 additions & 249 deletions
packages/clerk-js/src/core/modules/debug/__tests__/logger.spec.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
import { afterEach, beforeEach, describe, expect, it } from 'vitest';

import { DebugLogger } from '../logger';
import type { DebugLogEntry, DebugLogFilter } from '../types';
import type { DebugLogEntry } from '../types';

// Mock transport for testing
class MockTransport {
 public sentEntries: DebugLogEntry[] = [];

Expand All@@ -22,7 +21,7 @@ describe('DebugLogger', () => {

 beforeEach(() => {
 mockTransport = new MockTransport();
 logger = new DebugLogger(mockTransport, 'trace');
 logger = new DebugLogger(mockTransport, 'debug');
 });

 afterEach(() => {
Expand All@@ -35,14 +34,12 @@ describe('DebugLogger', () => {
 logger.warn('warn message');
 logger.info('info message');
 logger.debug('debug message');
 logger.trace('trace message');

 expect(mockTransport.sentEntries).toHaveLength(5);
 expect(mockTransport.sentEntries).toHaveLength(4);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[1].level).toBe('warn');
 expect(mockTransport.sentEntries[2].level).toBe('info');
 expect(mockTransport.sentEntries[3].level).toBe('debug');
 expect(mockTransport.sentEntries[4].level).toBe('trace');
 });

 it('should include context and source in log entries', () => {
Expand All@@ -59,7 +56,6 @@ describe('DebugLogger', () => {
 it('should respect log level filtering', () => {
 const infoLogger = new DebugLogger(mockTransport, 'info');

 infoLogger.trace('trace message');
 infoLogger.debug('debug message');
 infoLogger.info('info message');
 infoLogger.warn('warn message');
Expand All@@ -70,267 +66,64 @@ describe('DebugLogger', () => {
 });
 });

 describe('filter functionality', () => {
 describe('level filtering', () => {
 it('should filter by specific log level', () => {
 const filters: DebugLogFilter[] = [{ level: 'error' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 });

 it('should allow all levels when no level filter is specified', () => {
 const filters: DebugLogFilter[] = [{}];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 });

 describe('source filtering', () => {
 it('should filter by exact string source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'other-module');
 filteredLogger.info('message 3', undefined, 'auth-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-module');
 });

 it('should filter by RegExp source pattern', () => {
 const filters: DebugLogFilter[] = [{ source: /auth-.*/ }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'auth-service');
 filteredLogger.info('message 3', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-service');
 });

 it('should not log when source is undefined and filter expects a source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without source');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 });

 describe('include pattern filtering', () => {
 it('should include messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: ['user', 'auth'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('auth token refreshed');
 filteredLogger.info('database connection established');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 expect(mockTransport.sentEntries[1].message).toBe('auth token refreshed');
 });

 it('should include messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: [/user-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user-123 logged in');
 filteredLogger.info('user-456 logged out');
 filteredLogger.info('admin panel accessed');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user-123 logged in');
 expect(mockTransport.sentEntries[1].message).toBe('user-456 logged out');
 });
 });

 describe('exclude pattern filtering', () => {
 it('should exclude messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: ['debug', 'test'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('debug information logged');
 filteredLogger.info('test data generated');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });

 it('should exclude messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: [/test-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('test-123 created');
 filteredLogger.info('test-456 deleted');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 // Note: userId and sessionId filtering are defined in types but not yet implemented
 // These tests are commented out until the feature is implemented
 /*
 describe('userId filtering', () => {
 it('should filter by specific userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', { userId: 'user-123' });
 filteredLogger.info('message 2', { userId: 'user-456' });
 filteredLogger.info('message 3', { userId: 'user-123' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.userId).toBe('user-123');
 expect(mockTransport.sentEntries[1].context?.userId).toBe('user-123');
 });
 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 it('should not log when userId is undefined and filter expects a userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without userId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });

 describe('sessionId filtering', () => {
 it('should filter by specific sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 it('should handle empty context object', () => {
 logger.info('message with empty context', {});

 filteredLogger.info('message 1', { sessionId: 'session-abc' });
 filteredLogger.info('message 2', { sessionId: 'session-xyz' });
 filteredLogger.info('message 3', { sessionId: 'session-abc' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.sessionId).toBe('session-abc');
 expect(mockTransport.sentEntries[1].context?.sessionId).toBe('session-abc');
 });

 it('should not log when sessionId is undefined and filter expects a sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without sessionId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
 });
 */

 describe('combined filtering', () => {
 it('should apply multiple filters with AND logic', () => {
 const filters: DebugLogFilter[] = [
 { level: 'error' },
 { source: 'auth-module' },
 { includePatterns: ['failed'] },
 ];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.error('login failed', undefined, 'auth-module');
 filteredLogger.error('login successful', undefined, 'auth-module');
 filteredLogger.warn('login failed', undefined, 'auth-module');
 filteredLogger.error('login failed', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('login failed');
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 });
 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');

 it('should handle empty filters array', () => {
 const filters: DebugLogFilter[] = [];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1');
 filteredLogger.warn('message 2');
 filteredLogger.error('message 3');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 });

 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });
 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };

 it('should handle empty context object', () => {
 logger.info('message with empty context', {});
 const testLogger = new DebugLogger(countingTransport, 'info');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
});
testLogger.info('message 1');
testLogger.warn('message 2');
testLogger.error('message 3');

 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 expect(sendCallCount).toBe(3);
 });

 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };
 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 const testLogger = new DebugLogger(countingTransport, 'info');

 testLogger.info('message 1');
 testLogger.warn('message 2');
 testLogger.error('message 3');

 // Allow async operations to complete
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(sendCallCount).toBe(3);
 });

 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 });
});
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
refactor(clerk-js): Remove unused debugLogger functionality#6615

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

jacekradko
merged 5 commits into

from

Aug 24, 2025
 Merged


refactor(clerk-js): Remove unused debugLogger functionality
#6615
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


5 commits


Select commit
Hold shift + click to select a range
d0f2476

refactor(clerk-js): Remove unused functionality


jacekradko Aug 23, 2025
e0d444d

additional removal


jacekradko Aug 23, 2025
3bb114d

remove unused utility types


jacekradko Aug 23, 2025
9b3e657

changeset


jacekradko Aug 23, 2025
3c13778

pr feedback


jacekradko Aug 23, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


5 changes: 5 additions & 0 deletions
.changeset/dull-rules-dance.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
---
'@clerk/clerk-js': patch
---

Removing unused debugLogger functionality

8 changes: 0 additions & 8 deletions
packages/clerk-js/src/core/clerk.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -85,7 +85,6 @@ import type {
 Web3Provider,
} from '@clerk/types';

import type { DebugLoggerInterface } from '@/utils/debug';
import { debugLogger, initDebugLogger } from '@/utils/debug';

import type { MountComponentRenderer } from '../ui/Components';
Expand DownExpand Up@@ -163,11 +162,6 @@ type SetActiveHook = (intent?: 'sign-out') => void | Promise<void>;

export type ClerkCoreBroadcastChannelEvent = { type: 'signout' };

/**
 * Interface for the debug logger with all available logging methods
 */
// DebugLoggerInterface imported from '@/utils/debug'

declare global {
 interface Window {
 Clerk?: Clerk;
Expand DownExpand Up@@ -219,8 +213,6 @@ export class Clerk implements ClerkInterface {
 public __internal_country?: string | null;
 public telemetry: TelemetryCollector | undefined;
 public readonly __internal_state: State = new State();
 // Deprecated: use global singleton from `@/utils/debug`
 public debugLogger?: DebugLoggerInterface;

 protected internal_last_error: ClerkAPIError | null = null;
 // converted to protected environment to support `updateEnvironment` type assertion
Expand Down

291 changes: 42 additions & 249 deletions
packages/clerk-js/src/core/modules/debug/__tests__/logger.spec.ts

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
import { afterEach, beforeEach, describe, expect, it } from 'vitest';

import { DebugLogger } from '../logger';
import type { DebugLogEntry, DebugLogFilter } from '../types';
import type { DebugLogEntry } from '../types';

// Mock transport for testing
class MockTransport {
 public sentEntries: DebugLogEntry[] = [];

Expand All@@ -22,7 +21,7 @@ describe('DebugLogger', () => {

 beforeEach(() => {
 mockTransport = new MockTransport();
 logger = new DebugLogger(mockTransport, 'trace');
 logger = new DebugLogger(mockTransport, 'debug');
 });

 afterEach(() => {
Expand All@@ -35,14 +34,12 @@ describe('DebugLogger', () => {
 logger.warn('warn message');
 logger.info('info message');
 logger.debug('debug message');
 logger.trace('trace message');

 expect(mockTransport.sentEntries).toHaveLength(5);
 expect(mockTransport.sentEntries).toHaveLength(4);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[1].level).toBe('warn');
 expect(mockTransport.sentEntries[2].level).toBe('info');
 expect(mockTransport.sentEntries[3].level).toBe('debug');
 expect(mockTransport.sentEntries[4].level).toBe('trace');
 });

 it('should include context and source in log entries', () => {
Expand All@@ -59,7 +56,6 @@ describe('DebugLogger', () => {
 it('should respect log level filtering', () => {
 const infoLogger = new DebugLogger(mockTransport, 'info');

 infoLogger.trace('trace message');
 infoLogger.debug('debug message');
 infoLogger.info('info message');
 infoLogger.warn('warn message');
Expand All@@ -70,267 +66,64 @@ describe('DebugLogger', () => {
 });
 });

 describe('filter functionality', () => {
 describe('level filtering', () => {
 it('should filter by specific log level', () => {
 const filters: DebugLogFilter[] = [{ level: 'error' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].level).toBe('error');
 });

 it('should allow all levels when no level filter is specified', () => {
 const filters: DebugLogFilter[] = [{}];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('info message');
 filteredLogger.warn('warn message');
 filteredLogger.error('error message');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 });

 describe('source filtering', () => {
 it('should filter by exact string source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'other-module');
 filteredLogger.info('message 3', undefined, 'auth-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-module');
 });

 it('should filter by RegExp source pattern', () => {
 const filters: DebugLogFilter[] = [{ source: /auth-.*/ }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', undefined, 'auth-module');
 filteredLogger.info('message 2', undefined, 'auth-service');
 filteredLogger.info('message 3', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 expect(mockTransport.sentEntries[1].source).toBe('auth-service');
 });

 it('should not log when source is undefined and filter expects a source', () => {
 const filters: DebugLogFilter[] = [{ source: 'auth-module' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without source');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 });

 describe('include pattern filtering', () => {
 it('should include messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: ['user', 'auth'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('auth token refreshed');
 filteredLogger.info('database connection established');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 expect(mockTransport.sentEntries[1].message).toBe('auth token refreshed');
 });

 it('should include messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ includePatterns: [/user-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user-123 logged in');
 filteredLogger.info('user-456 logged out');
 filteredLogger.info('admin panel accessed');

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].message).toBe('user-123 logged in');
 expect(mockTransport.sentEntries[1].message).toBe('user-456 logged out');
 });
 });

 describe('exclude pattern filtering', () => {
 it('should exclude messages matching string patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: ['debug', 'test'] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('debug information logged');
 filteredLogger.info('test data generated');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });

 it('should exclude messages matching RegExp patterns', () => {
 const filters: DebugLogFilter[] = [{ excludePatterns: [/test-.*/] }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('user login successful');
 filteredLogger.info('test-123 created');
 filteredLogger.info('test-456 deleted');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('user login successful');
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 // Note: userId and sessionId filtering are defined in types but not yet implemented
 // These tests are commented out until the feature is implemented
 /*
 describe('userId filtering', () => {
 it('should filter by specific userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1', { userId: 'user-123' });
 filteredLogger.info('message 2', { userId: 'user-456' });
 filteredLogger.info('message 3', { userId: 'user-123' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.userId).toBe('user-123');
 expect(mockTransport.sentEntries[1].context?.userId).toBe('user-123');
 });
 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 it('should not log when userId is undefined and filter expects a userId', () => {
 const filters: DebugLogFilter[] = [{ userId: 'user-123' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without userId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });

 describe('sessionId filtering', () => {
 it('should filter by specific sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);
 it('should handle empty context object', () => {
 logger.info('message with empty context', {});

 filteredLogger.info('message 1', { sessionId: 'session-abc' });
 filteredLogger.info('message 2', { sessionId: 'session-xyz' });
 filteredLogger.info('message 3', { sessionId: 'session-abc' });

 expect(mockTransport.sentEntries).toHaveLength(2);
 expect(mockTransport.sentEntries[0].context?.sessionId).toBe('session-abc');
 expect(mockTransport.sentEntries[1].context?.sessionId).toBe('session-abc');
 });

 it('should not log when sessionId is undefined and filter expects a sessionId', () => {
 const filters: DebugLogFilter[] = [{ sessionId: 'session-abc' }];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message without sessionId');

 expect(mockTransport.sentEntries).toHaveLength(0);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
 });
 */

 describe('combined filtering', () => {
 it('should apply multiple filters with AND logic', () => {
 const filters: DebugLogFilter[] = [
 { level: 'error' },
 { source: 'auth-module' },
 { includePatterns: ['failed'] },
 ];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.error('login failed', undefined, 'auth-module');
 filteredLogger.error('login successful', undefined, 'auth-module');
 filteredLogger.warn('login failed', undefined, 'auth-module');
 filteredLogger.error('login failed', undefined, 'other-module');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].message).toBe('login failed');
 expect(mockTransport.sentEntries[0].level).toBe('error');
 expect(mockTransport.sentEntries[0].source).toBe('auth-module');
 });
 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');

 it('should handle empty filters array', () => {
 const filters: DebugLogFilter[] = [];
 const filteredLogger = new DebugLogger(mockTransport, 'debug', filters);

 filteredLogger.info('message 1');
 filteredLogger.warn('message 2');
 filteredLogger.error('message 3');

 expect(mockTransport.sentEntries).toHaveLength(3);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 });

 describe('edge cases', () => {
 it('should handle undefined context', () => {
 logger.info('message with undefined context', undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toBeUndefined();
 });

 it('should handle undefined source', () => {
 logger.info('message with undefined source', {}, undefined);

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBeUndefined();
 });
 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };

 it('should handle empty context object', () => {
 logger.info('message with empty context', {});
 const testLogger = new DebugLogger(countingTransport, 'info');

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].context).toEqual({});
});
testLogger.info('message 1');
testLogger.warn('message 2');
testLogger.error('message 3');

 it('should handle empty source string', () => {
 logger.info('message with empty source', {}, '');
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].source).toBe('');
 });
 expect(sendCallCount).toBe(3);
 });

 describe('transport integration', () => {
 it('should call transport.send for each log entry', async () => {
 let sendCallCount = 0;
 const countingTransport = {
 async send(_entry: DebugLogEntry): Promise<void> {
 sendCallCount++;
 },
 };
 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 const testLogger = new DebugLogger(countingTransport, 'info');

 testLogger.info('message 1');
 testLogger.warn('message 2');
 testLogger.error('message 3');

 // Allow async operations to complete
 await new Promise(resolve => setTimeout(resolve, 0));

 expect(sendCallCount).toBe(3);
 });

 it('should include timestamp in log entries', () => {
 const beforeTime = Date.now();
 logger.info('test message');
 const afterTime = Date.now();

 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 expect(mockTransport.sentEntries).toHaveLength(1);
 expect(mockTransport.sentEntries[0].timestamp).toBeGreaterThanOrEqual(beforeTime);
 expect(mockTransport.sentEntries[0].timestamp).toBeLessThanOrEqual(afterTime);
 });
 });
});
Loading
Loading