Research
Recent Trends in Malicious Packages Targeting Discord
The Socket research team breaks down a sampling of malicious packages that download and execute files, among other suspicious behaviors, targeting the popular Discord platform.
@getcircuit/analytics
Advanced tools
Readme
@getcircuit/analytics
A thin analytics abstraction layer for Circuit's applications. It implements a basic plugin system for integrating with different analytics services.
import {
Analytics,
googleAnalytics,
facebookPixel,
} from '@getcircuit/analytics'
export const analytics = Analytics({
/** Current environment. Accessed by plugins.*/
env: process.env.NODE_ENV,
/** If true, logs every track call that is being made. (default: false) */
debug: process.env.NODE_ENV === 'development',
/** If true, tracking requests are not sent */
dryRun: 'production',
/** List of service plugins */
plugins: [
googleAnalytics({
trackingId: 'UA-XXXXXX-X',
}),
facebookPixel({
pixelId: 'xxxxxxx',
}),
],
/**
* Optional map of hooks => plugin names.
* Any plugin listed here will need to be explicitly included to have the related hook executed.
* */
explicitUse: {
event: [...],
pageview: [...],
...,
}
})
After initializing, you can use the abstraction layer to send:
analytics.event(...)
analytics.pageview(...)
analytics.identify(...)
analytics.anonymize(...)
analytics.info(...)
analytics.warn(...)
analytics.error(...)
Only plugins that implement the hook will be executed. The load
of each plugin is deferred until one of its hooks are executed, which means that any analytics code will only be added to the DOM when sending a tracking request.
A plugin is just an object with a specific set of methods, which we call 'hooks' and a name
property. The only mandatory hook is the load()
, responsible for adding the service script to the DOM.
{
name: string
load: () => MaybePromise
unload?: () => MaybePromise
pageview?: (opts: PageviewOptions) => MaybePromise
event?: (opts: TrackEventOptions) => MaybePromise
identify?: (opts: IdentifyOptions) => MaybePromise
anonymize?: () => MaybePromise
info?: (opts: TraceOptions) => MaybePromise
warn?: (opts: TraceOptions) => MaybePromise
error?: (opts: TraceOptions) => MaybePromise
}
Apart from load
and unload
, each hook correspond to a method in the abstraction layer.
Every hook has access to a this
object which contains:
type PluginContext = {
/** Configs passed onto the library */
config: {
env: string
appName: string
appVersion: string
debug: boolean
}
/** Helper method to assert that an object has received certain props */
assertKeys: (object, requiredKeys) => void
/** Helper method to assert that every passed value is not undefined */
assertValues: (objectOfValues) => void
}
FAQs
Unknown package
We found that @getcircuit/analytics demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 19 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
The Socket research team breaks down a sampling of malicious packages that download and execute files, among other suspicious behaviors, targeting the popular Discord platform.
Security News
Socket CEO Feross Aboukhadijeh joins a16z partners to discuss how modern, sophisticated supply chain attacks require AI-driven defenses and explore the challenges and solutions in leveraging AI for threat detection early in the development life cycle.
Security News
NIST's new AI Risk Management Framework aims to enhance the security and reliability of generative AI systems and address the unique challenges of malicious AI exploits.