Skip to content

feat(shared): Add opt-out support for SDK telemetry - #2099

Merged
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out
Nov 13, 2023
Merged

feat(shared): Add opt-out support for SDK telemetry#2099
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out

Conversation

@brkalow

@brkalowbrkalow commented Nov 9, 2023

Copy link
Copy Markdown
Member

Description

Adds opt-out support to the TelemetryCollector by way of the disabled option. We also moved the initialization of TelemetryCollector to Clerk.load instead of its constructor to make it easier to pass options.

fixes SDK-915

Checklist

  • npm test runs as expected.
  • npm run build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Packages affected

  • @clerk/backend
  • @clerk/chrome-extension
  • @clerk/clerk-js
  • @clerk/clerk-expo
  • @clerk/fastify
  • gatsby-plugin-clerk
  • @clerk/localizations
  • @clerk/nextjs
  • @clerk/clerk-react
  • @clerk/remix
  • @clerk/clerk-sdk-node
  • @clerk/shared
  • @clerk/themes
  • @clerk/types
  • build/tooling/chore

…ialization to Clerk.load, implement opt-out for Next
@changeset-bot

changeset-botBot commented Nov 9, 2023

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 2f72334

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Comment on lines +328 to +339
if (this.#options.sdkMetadata) {
Clerk.sdkMetadata = this.#options.sdkMetadata;
}

this.#telemetry = new TelemetryCollector({
clerkVersion: Clerk.version,
verbose: true,
samplingRate: 1,
// @ts-expect-error -- in v5 this will always be defined
publishableKey: this.publishableKey,
...this.#options.telemetry,
});

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved the TelemetryCollector instantiation into Clerk.load() instead of the constructor. It's much easier to pass options this way.

domain: this.domain,
} as any);

c.sdkMetadata = this.options.sdkMetadata ?? SDK_METADATA;

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cleaning up this metadata thing by handling it in Clerk.load().

},
})
.catch(err => console.error(err))
.catch(() => void 0)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Swallowing errors here to ensure we don't create noise as a result of our telemetry.


jest.useFakeTimers();

describe('TelemetryCollector', () => {

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added some high-level tests for the collector. Most importantly, validating that events aren't sent when disabled or debug are true.

@brkalow
brkalow marked this pull request as ready for review November 9, 2023 23:56
@brkalow
brkalow requested a review from a team as a code ownerNovember 9, 2023 23:56
Comment threadpackages/shared/src/__tests__/telemetry.test.ts
@brkalow
brkalow merged commit 85c5a45 into brk.feat/telemetry-spikeNov 13, 2023
@brkalow
brkalow deleted the brk.feat/telemetry-opt-out branch November 13, 2023 18:40
github-merge-queueBot pushed a commit that referenced this pull request Nov 22, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
desiprisg pushed a commit that referenced this pull request Nov 23, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

@brkalow@tmilewski@LekoArts@clerk-cookie
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
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;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
feat(shared): Add opt-out support for SDK telemetry by brkalow · Pull Request #2099 · clerk/javascript · GitHub
Skip to content

feat(shared): Add opt-out support for SDK telemetry - #2099

Merged
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out
Nov 13, 2023
Merged

feat(shared): Add opt-out support for SDK telemetry#2099
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out

Conversation

@brkalow

@brkalowbrkalow commented Nov 9, 2023

Copy link
Copy Markdown
Member

Description

Adds opt-out support to the TelemetryCollector by way of the disabled option. We also moved the initialization of TelemetryCollector to Clerk.load instead of its constructor to make it easier to pass options.

fixes SDK-915

Checklist

  • npm test runs as expected.
  • npm run build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Packages affected

  • @clerk/backend
  • @clerk/chrome-extension
  • @clerk/clerk-js
  • @clerk/clerk-expo
  • @clerk/fastify
  • gatsby-plugin-clerk
  • @clerk/localizations
  • @clerk/nextjs
  • @clerk/clerk-react
  • @clerk/remix
  • @clerk/clerk-sdk-node
  • @clerk/shared
  • @clerk/themes
  • @clerk/types
  • build/tooling/chore

…ialization to Clerk.load, implement opt-out for Next
@changeset-bot

changeset-botBot commented Nov 9, 2023

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 2f72334

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Comment on lines +328 to +339
if (this.#options.sdkMetadata) {
Clerk.sdkMetadata = this.#options.sdkMetadata;
}

this.#telemetry = new TelemetryCollector({
clerkVersion: Clerk.version,
verbose: true,
samplingRate: 1,
// @ts-expect-error -- in v5 this will always be defined
publishableKey: this.publishableKey,
...this.#options.telemetry,
});

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved the TelemetryCollector instantiation into Clerk.load() instead of the constructor. It's much easier to pass options this way.

domain: this.domain,
} as any);

c.sdkMetadata = this.options.sdkMetadata ?? SDK_METADATA;

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cleaning up this metadata thing by handling it in Clerk.load().

},
})
.catch(err => console.error(err))
.catch(() => void 0)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Swallowing errors here to ensure we don't create noise as a result of our telemetry.


jest.useFakeTimers();

describe('TelemetryCollector', () => {

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added some high-level tests for the collector. Most importantly, validating that events aren't sent when disabled or debug are true.

@brkalow
brkalow marked this pull request as ready for review November 9, 2023 23:56
@brkalow
brkalow requested a review from a team as a code ownerNovember 9, 2023 23:56
Comment threadpackages/shared/src/__tests__/telemetry.test.ts
@brkalow
brkalow merged commit 85c5a45 into brk.feat/telemetry-spikeNov 13, 2023
@brkalow
brkalow deleted the brk.feat/telemetry-opt-out branch November 13, 2023 18:40
github-merge-queueBot pushed a commit that referenced this pull request Nov 22, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
desiprisg pushed a commit that referenced this pull request Nov 23, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

@brkalow@tmilewski@LekoArts@clerk-cookie
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat(shared): Add opt-out support for SDK telemetry by brkalow · Pull Request #2099 · clerk/javascript · GitHub
Skip to content

feat(shared): Add opt-out support for SDK telemetry - #2099

Merged
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out
Nov 13, 2023
Merged

feat(shared): Add opt-out support for SDK telemetry#2099
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out

Conversation

@brkalow

@brkalowbrkalow commented Nov 9, 2023

Copy link
Copy Markdown
Member

Description

Adds opt-out support to the TelemetryCollector by way of the disabled option. We also moved the initialization of TelemetryCollector to Clerk.load instead of its constructor to make it easier to pass options.

fixes SDK-915

Checklist

  • npm test runs as expected.
  • npm run build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Packages affected

  • @clerk/backend
  • @clerk/chrome-extension
  • @clerk/clerk-js
  • @clerk/clerk-expo
  • @clerk/fastify
  • gatsby-plugin-clerk
  • @clerk/localizations
  • @clerk/nextjs
  • @clerk/clerk-react
  • @clerk/remix
  • @clerk/clerk-sdk-node
  • @clerk/shared
  • @clerk/themes
  • @clerk/types
  • build/tooling/chore

…ialization to Clerk.load, implement opt-out for Next
@changeset-bot

changeset-botBot commented Nov 9, 2023

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 2f72334

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Comment on lines +328 to +339
if (this.#options.sdkMetadata) {
Clerk.sdkMetadata = this.#options.sdkMetadata;
}

this.#telemetry = new TelemetryCollector({
clerkVersion: Clerk.version,
verbose: true,
samplingRate: 1,
// @ts-expect-error -- in v5 this will always be defined
publishableKey: this.publishableKey,
...this.#options.telemetry,
});

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved the TelemetryCollector instantiation into Clerk.load() instead of the constructor. It's much easier to pass options this way.

domain: this.domain,
} as any);

c.sdkMetadata = this.options.sdkMetadata ?? SDK_METADATA;

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cleaning up this metadata thing by handling it in Clerk.load().

},
})
.catch(err => console.error(err))
.catch(() => void 0)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Swallowing errors here to ensure we don't create noise as a result of our telemetry.


jest.useFakeTimers();

describe('TelemetryCollector', () => {

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added some high-level tests for the collector. Most importantly, validating that events aren't sent when disabled or debug are true.

@brkalow
brkalow marked this pull request as ready for review November 9, 2023 23:56
@brkalow
brkalow requested a review from a team as a code ownerNovember 9, 2023 23:56
Comment threadpackages/shared/src/__tests__/telemetry.test.ts
@brkalow
brkalow merged commit 85c5a45 into brk.feat/telemetry-spikeNov 13, 2023
@brkalow
brkalow deleted the brk.feat/telemetry-opt-out branch November 13, 2023 18:40
github-merge-queueBot pushed a commit that referenced this pull request Nov 22, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
desiprisg pushed a commit that referenced this pull request Nov 23, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

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

feat(shared): Add opt-out support for SDK telemetry - #2099

Merged
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out
Nov 13, 2023
Merged

feat(shared): Add opt-out support for SDK telemetry#2099
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out

Conversation

@brkalow

@brkalowbrkalow commented Nov 9, 2023

Copy link
Copy Markdown
Member

Description

Adds opt-out support to the TelemetryCollector by way of the disabled option. We also moved the initialization of TelemetryCollector to Clerk.load instead of its constructor to make it easier to pass options.

fixes SDK-915

Checklist

  • npm test runs as expected.
  • npm run build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Packages affected

  • @clerk/backend
  • @clerk/chrome-extension
  • @clerk/clerk-js
  • @clerk/clerk-expo
  • @clerk/fastify
  • gatsby-plugin-clerk
  • @clerk/localizations
  • @clerk/nextjs
  • @clerk/clerk-react
  • @clerk/remix
  • @clerk/clerk-sdk-node
  • @clerk/shared
  • @clerk/themes
  • @clerk/types
  • build/tooling/chore

…ialization to Clerk.load, implement opt-out for Next
@changeset-bot

changeset-botBot commented Nov 9, 2023

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 2f72334

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Comment on lines +328 to +339
if (this.#options.sdkMetadata) {
Clerk.sdkMetadata = this.#options.sdkMetadata;
}

this.#telemetry = new TelemetryCollector({
clerkVersion: Clerk.version,
verbose: true,
samplingRate: 1,
// @ts-expect-error -- in v5 this will always be defined
publishableKey: this.publishableKey,
...this.#options.telemetry,
});

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved the TelemetryCollector instantiation into Clerk.load() instead of the constructor. It's much easier to pass options this way.

domain: this.domain,
} as any);

c.sdkMetadata = this.options.sdkMetadata ?? SDK_METADATA;

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cleaning up this metadata thing by handling it in Clerk.load().

},
})
.catch(err => console.error(err))
.catch(() => void 0)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Swallowing errors here to ensure we don't create noise as a result of our telemetry.


jest.useFakeTimers();

describe('TelemetryCollector', () => {

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added some high-level tests for the collector. Most importantly, validating that events aren't sent when disabled or debug are true.

@brkalow
brkalow marked this pull request as ready for review November 9, 2023 23:56
@brkalow
brkalow requested a review from a team as a code ownerNovember 9, 2023 23:56
Comment threadpackages/shared/src/__tests__/telemetry.test.ts
@brkalow
brkalow merged commit 85c5a45 into brk.feat/telemetry-spikeNov 13, 2023
@brkalow
brkalow deleted the brk.feat/telemetry-opt-out branch November 13, 2023 18:40
github-merge-queueBot pushed a commit that referenced this pull request Nov 22, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
desiprisg pushed a commit that referenced this pull request Nov 23, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

@brkalow@tmilewski@LekoArts@clerk-cookie
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' feat(shared): Add opt-out support for SDK telemetry by brkalow · Pull Request #2099 · clerk/javascript · GitHub
Skip to content

feat(shared): Add opt-out support for SDK telemetry - #2099

Merged
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out
Nov 13, 2023
Merged

feat(shared): Add opt-out support for SDK telemetry#2099
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out

Conversation

@brkalow

@brkalowbrkalow commented Nov 9, 2023

Copy link
Copy Markdown
Member

Description

Adds opt-out support to the TelemetryCollector by way of the disabled option. We also moved the initialization of TelemetryCollector to Clerk.load instead of its constructor to make it easier to pass options.

fixes SDK-915

Checklist

  • npm test runs as expected.
  • npm run build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Packages affected

  • @clerk/backend
  • @clerk/chrome-extension
  • @clerk/clerk-js
  • @clerk/clerk-expo
  • @clerk/fastify
  • gatsby-plugin-clerk
  • @clerk/localizations
  • @clerk/nextjs
  • @clerk/clerk-react
  • @clerk/remix
  • @clerk/clerk-sdk-node
  • @clerk/shared
  • @clerk/themes
  • @clerk/types
  • build/tooling/chore

…ialization to Clerk.load, implement opt-out for Next
@changeset-bot

changeset-botBot commented Nov 9, 2023

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 2f72334

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Comment on lines +328 to +339
if (this.#options.sdkMetadata) {
Clerk.sdkMetadata = this.#options.sdkMetadata;
}

this.#telemetry = new TelemetryCollector({
clerkVersion: Clerk.version,
verbose: true,
samplingRate: 1,
// @ts-expect-error -- in v5 this will always be defined
publishableKey: this.publishableKey,
...this.#options.telemetry,
});

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved the TelemetryCollector instantiation into Clerk.load() instead of the constructor. It's much easier to pass options this way.

domain: this.domain,
} as any);

c.sdkMetadata = this.options.sdkMetadata ?? SDK_METADATA;

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cleaning up this metadata thing by handling it in Clerk.load().

},
})
.catch(err => console.error(err))
.catch(() => void 0)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Swallowing errors here to ensure we don't create noise as a result of our telemetry.


jest.useFakeTimers();

describe('TelemetryCollector', () => {

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added some high-level tests for the collector. Most importantly, validating that events aren't sent when disabled or debug are true.

@brkalow
brkalow marked this pull request as ready for review November 9, 2023 23:56
@brkalow
brkalow requested a review from a team as a code ownerNovember 9, 2023 23:56
Comment threadpackages/shared/src/__tests__/telemetry.test.ts
@brkalow
brkalow merged commit 85c5a45 into brk.feat/telemetry-spikeNov 13, 2023
@brkalow
brkalow deleted the brk.feat/telemetry-opt-out branch November 13, 2023 18:40
github-merge-queueBot pushed a commit that referenced this pull request Nov 22, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
desiprisg pushed a commit that referenced this pull request Nov 23, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

@brkalow@tmilewski@LekoArts@clerk-cookie
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat(shared): Add opt-out support for SDK telemetry by brkalow · Pull Request #2099 · clerk/javascript · GitHub
Skip to content

feat(shared): Add opt-out support for SDK telemetry - #2099

Merged
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out
Nov 13, 2023
Merged

feat(shared): Add opt-out support for SDK telemetry#2099
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out

Conversation

@brkalow

@brkalowbrkalow commented Nov 9, 2023

Copy link
Copy Markdown
Member

Description

Adds opt-out support to the TelemetryCollector by way of the disabled option. We also moved the initialization of TelemetryCollector to Clerk.load instead of its constructor to make it easier to pass options.

fixes SDK-915

Checklist

  • npm test runs as expected.
  • npm run build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Packages affected

  • @clerk/backend
  • @clerk/chrome-extension
  • @clerk/clerk-js
  • @clerk/clerk-expo
  • @clerk/fastify
  • gatsby-plugin-clerk
  • @clerk/localizations
  • @clerk/nextjs
  • @clerk/clerk-react
  • @clerk/remix
  • @clerk/clerk-sdk-node
  • @clerk/shared
  • @clerk/themes
  • @clerk/types
  • build/tooling/chore

…ialization to Clerk.load, implement opt-out for Next
@changeset-bot

changeset-botBot commented Nov 9, 2023

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 2f72334

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Comment on lines +328 to +339
if (this.#options.sdkMetadata) {
Clerk.sdkMetadata = this.#options.sdkMetadata;
}

this.#telemetry = new TelemetryCollector({
clerkVersion: Clerk.version,
verbose: true,
samplingRate: 1,
// @ts-expect-error -- in v5 this will always be defined
publishableKey: this.publishableKey,
...this.#options.telemetry,
});

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved the TelemetryCollector instantiation into Clerk.load() instead of the constructor. It's much easier to pass options this way.

domain: this.domain,
} as any);

c.sdkMetadata = this.options.sdkMetadata ?? SDK_METADATA;

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cleaning up this metadata thing by handling it in Clerk.load().

},
})
.catch(err => console.error(err))
.catch(() => void 0)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Swallowing errors here to ensure we don't create noise as a result of our telemetry.


jest.useFakeTimers();

describe('TelemetryCollector', () => {

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added some high-level tests for the collector. Most importantly, validating that events aren't sent when disabled or debug are true.

@brkalow
brkalow marked this pull request as ready for review November 9, 2023 23:56
@brkalow
brkalow requested a review from a team as a code ownerNovember 9, 2023 23:56
Comment threadpackages/shared/src/__tests__/telemetry.test.ts
@brkalow
brkalow merged commit 85c5a45 into brk.feat/telemetry-spikeNov 13, 2023
@brkalow
brkalow deleted the brk.feat/telemetry-opt-out branch November 13, 2023 18:40
github-merge-queueBot pushed a commit that referenced this pull request Nov 22, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
desiprisg pushed a commit that referenced this pull request Nov 23, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

@brkalow@tmilewski@LekoArts@clerk-cookie
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat(shared): Add opt-out support for SDK telemetry by brkalow · Pull Request #2099 · clerk/javascript · GitHub
Skip to content

feat(shared): Add opt-out support for SDK telemetry - #2099

Merged
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out
Nov 13, 2023
Merged

feat(shared): Add opt-out support for SDK telemetry#2099
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out

Conversation

@brkalow

@brkalowbrkalow commented Nov 9, 2023

Copy link
Copy Markdown
Member

Description

Adds opt-out support to the TelemetryCollector by way of the disabled option. We also moved the initialization of TelemetryCollector to Clerk.load instead of its constructor to make it easier to pass options.

fixes SDK-915

Checklist

  • npm test runs as expected.
  • npm run build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Packages affected

  • @clerk/backend
  • @clerk/chrome-extension
  • @clerk/clerk-js
  • @clerk/clerk-expo
  • @clerk/fastify
  • gatsby-plugin-clerk
  • @clerk/localizations
  • @clerk/nextjs
  • @clerk/clerk-react
  • @clerk/remix
  • @clerk/clerk-sdk-node
  • @clerk/shared
  • @clerk/themes
  • @clerk/types
  • build/tooling/chore

…ialization to Clerk.load, implement opt-out for Next
@changeset-bot

changeset-botBot commented Nov 9, 2023

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 2f72334

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Comment on lines +328 to +339
if (this.#options.sdkMetadata) {
Clerk.sdkMetadata = this.#options.sdkMetadata;
}

this.#telemetry = new TelemetryCollector({
clerkVersion: Clerk.version,
verbose: true,
samplingRate: 1,
// @ts-expect-error -- in v5 this will always be defined
publishableKey: this.publishableKey,
...this.#options.telemetry,
});

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved the TelemetryCollector instantiation into Clerk.load() instead of the constructor. It's much easier to pass options this way.

domain: this.domain,
} as any);

c.sdkMetadata = this.options.sdkMetadata ?? SDK_METADATA;

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cleaning up this metadata thing by handling it in Clerk.load().

},
})
.catch(err => console.error(err))
.catch(() => void 0)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Swallowing errors here to ensure we don't create noise as a result of our telemetry.


jest.useFakeTimers();

describe('TelemetryCollector', () => {

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added some high-level tests for the collector. Most importantly, validating that events aren't sent when disabled or debug are true.

@brkalow
brkalow marked this pull request as ready for review November 9, 2023 23:56
@brkalow
brkalow requested a review from a team as a code ownerNovember 9, 2023 23:56
Comment threadpackages/shared/src/__tests__/telemetry.test.ts
@brkalow
brkalow merged commit 85c5a45 into brk.feat/telemetry-spikeNov 13, 2023
@brkalow
brkalow deleted the brk.feat/telemetry-opt-out branch November 13, 2023 18:40
github-merge-queueBot pushed a commit that referenced this pull request Nov 22, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
desiprisg pushed a commit that referenced this pull request Nov 23, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

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

feat(shared): Add opt-out support for SDK telemetry - #2099

Merged
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out
Nov 13, 2023
Merged

feat(shared): Add opt-out support for SDK telemetry#2099
brkalow merged 7 commits into
brk.feat/telemetry-spikefrom
brk.feat/telemetry-opt-out

Conversation

@brkalow

@brkalowbrkalow commented Nov 9, 2023

Copy link
Copy Markdown
Member

Description

Adds opt-out support to the TelemetryCollector by way of the disabled option. We also moved the initialization of TelemetryCollector to Clerk.load instead of its constructor to make it easier to pass options.

fixes SDK-915

Checklist

  • npm test runs as expected.
  • npm run build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Packages affected

  • @clerk/backend
  • @clerk/chrome-extension
  • @clerk/clerk-js
  • @clerk/clerk-expo
  • @clerk/fastify
  • gatsby-plugin-clerk
  • @clerk/localizations
  • @clerk/nextjs
  • @clerk/clerk-react
  • @clerk/remix
  • @clerk/clerk-sdk-node
  • @clerk/shared
  • @clerk/themes
  • @clerk/types
  • build/tooling/chore

…ialization to Clerk.load, implement opt-out for Next
@changeset-bot

changeset-botBot commented Nov 9, 2023

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 2f72334

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Comment on lines +328 to +339
if (this.#options.sdkMetadata) {
Clerk.sdkMetadata = this.#options.sdkMetadata;
}

this.#telemetry = new TelemetryCollector({
clerkVersion: Clerk.version,
verbose: true,
samplingRate: 1,
// @ts-expect-error -- in v5 this will always be defined
publishableKey: this.publishableKey,
...this.#options.telemetry,
});

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved the TelemetryCollector instantiation into Clerk.load() instead of the constructor. It's much easier to pass options this way.

domain: this.domain,
} as any);

c.sdkMetadata = this.options.sdkMetadata ?? SDK_METADATA;

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cleaning up this metadata thing by handling it in Clerk.load().

},
})
.catch(err => console.error(err))
.catch(() => void 0)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Swallowing errors here to ensure we don't create noise as a result of our telemetry.


jest.useFakeTimers();

describe('TelemetryCollector', () => {

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added some high-level tests for the collector. Most importantly, validating that events aren't sent when disabled or debug are true.

@brkalow
brkalow marked this pull request as ready for review November 9, 2023 23:56
@brkalow
brkalow requested a review from a team as a code ownerNovember 9, 2023 23:56
Comment threadpackages/shared/src/__tests__/telemetry.test.ts
@brkalow
brkalow merged commit 85c5a45 into brk.feat/telemetry-spikeNov 13, 2023
@brkalow
brkalow deleted the brk.feat/telemetry-opt-out branch November 13, 2023 18:40
github-merge-queueBot pushed a commit that referenced this pull request Nov 22, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
desiprisg pushed a commit that referenced this pull request Nov 23, 2023
* feat(clerk-js): Spike out telemetry collection
* feat(clerk-js): Add sampling rate and verbose option
* feat(shared): Move TelemtryCollector into shared, make it isomorphic
* feat(nextjs): Add telemtry collection for authMiddleware
* feat(shared): Support passing multiple events to the telemetry endpoint
* feat(shared): Abstract fetch into sendEvent
* feat(shared): Refactor SDK metadata handling to get accurate value
* feat(shared): Update endpoint, don't use no-cors
* fix(nextjs): Fix merge conflict
* feat(shared): Add batching to the telemetry collector
* feat(shared): Add opt-out support for SDK telemetry (#2099)
* feat(clerk-js): Add TelemetryCollector instance to backend client (#2134)
* chore(repo): Add changeset
* fix(shared): Fix tests that rely on fetch
* feat(shared): Set production endpoint
* feat(clerk-js): Make telemtry public, expose via isomorphicClerk
* feat(shared): Add doc on the TelemetryCollector
* feat(clerk-js): Support telemetry: false as a way to disable telemetry
* chore(shared): Tweak comment
* chore(shared): Tweak comment
* fix(clerk-sdk-node): Add PACKAGE_ constants for tests
* fix(fastify): Define PACKAGE_ constants in test environment
* feat(shared): Refactor telemetry instrumentation to rely on helpers
* feat(shared): Add telemetry notice
* feat(shared): Add postinstall script
* chore(shared): Add word
* chore(shared): Swallow errors in postinstall
* chore(repo): Allow scripts directory in subpaths-workaround
* feat(shared): Adjust types to enforce the event structure from event factory methods
* chore(shared): Simplify telemetry.record() API
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

@brkalow@tmilewski@LekoArts@clerk-cookie