open-index/open-npm huggingface dataset:
npm package: @posthog/gitlab-release-tracking-plugin
Description: Track GitLab releases in PostHog.
Author: Yakko Majuri
Latest version: 0.0.7

# GitLab Release Tracking Plugin

Integrate PostHog with GitLab and get automatic graph annotations based on your repository's tags so you can analyze the impact of new releases on your key metrics. 

![Plugin Screenshot](readme-assets/release-tracker.png)

## Questions?

### [Join our Slack community.](https://join.slack.com/t/posthogusers/shared_invite/enQtOTY0MzU5NjAwMDY3LTc2MWQ0OTZlNjhkODk3ZDI3NDVjMDE1YjgxY2I4ZjI4MzJhZmVmNjJkN2NmMGJmMzc2N2U3Yjc3ZjI5NGFlZDQ)
npm package: @posthog/heartbeat-plugin
Description: [![License: MIT](https://img.shields.io/badge/License-MIT-red.svg?style=flat-square)](https://opensource.org/licenses/MIT) [![CI](https://github.com/PostHog/posthog-heartbeat-plugin/actions/workflows/main.yml/badge.svg?branch=main)](https://github.com/Pos
Author: PostHog
Latest version: 0.0.7
npm package: @posthog/hello-world-plugin
Description: [![License: MIT](https://img.shields.io/badge/License-MIT-red.svg?style=flat-square)](https://opensource.org/licenses/MIT)
Author: PostHog
Latest version: 0.0.7

# PostHog Plugin: Hello World Starter Kit

[![License: MIT](https://img.shields.io/badge/License-MIT-red.svg?style=flat-square)](https://opensource.org/licenses/MIT)

This is a basic exemplary PostHog plugin. It adds property `"greeting"` to every event, with a configurable value (default: `"Hello world!"`).

Feel free to use it as a base for your own plugins!

## How to develop

All of the plugin's code is located in the `index.js` file, which is JavaScript ran inside of PostHog.
To get yourself up to speed with this environment, we sincerely recommend checking out our [Plugins overview in PostHog Docs]([the Plugins Overview](https://posthog.com/docs/plugins/build/overview).
For a crash course, read our [plugin building tutorial in PostHog Docs](https://posthog.com/docs/plugins/build/tutorial).

## How to test

To test the plugin, you'll need to install a few `npm` dependencies already specified in `package.json`:
```bash
npm install
```

This will get you the testing library Jest and some our test helpers.
Then to run tests it's just:

```bash
npm test
```

## How to install

1. Open PostHog.
1. Open the Plugins page from the sidebar.
1. Head to the Advanced tab.
1. "Install from GitHub, GitLab or npm" using this repository's URL.

## Questions?

### [Join our Slack community.](https://join.slack.com/t/posthogusers/shared_invite/enQtOTY0MzU5NjAwMDY3LTc2MWQ0OTZlNjhkODk3ZDI3NDVjMDE1YjgxY2I4ZjI4MzJhZmVmNjJkN2NmMGJmMzc2N2U3Yjc3ZjI5NGFlZDQ)

We're here to help you with anything PostHog!
npm package: @posthog/hogql-parser
Description: WebAssembly HogQL Parser - Parse HogQL queries in JavaScript/TypeScript
Author: PostHog Inc.
Latest version: 1.3.37

# HogQL Parser

ANTLR4-based parser for [HogQL](https://posthog.com/docs/hogql) and [Hog](https://posthog.com/docs/hog),
available as both a Python C++ extension and a WebAssembly module for JavaScript/TypeScript.

## Packages

| Package                 | Runtime                          | Registry                                                   |
| ----------------------- | -------------------------------- | ---------------------------------------------------------- |
| `hogql_parser`          | CPython (native C++ extension)   | [PyPI](https://pypi.org/project/hogql-parser/)             |
| `@posthog/hogql-parser` | Any JS environment (WebAssembly) | [npm](https://www.npmjs.com/package/@posthog/hogql-parser) |

Both packages share the same C++ parser core and ANTLR4 grammar,
so they produce identical ASTs.

## npm package (`@posthog/hogql-parser`)

### Installation

```bash
npm install @posthog/hogql-parser
```

### Usage

```typescript
import createHogQLParser from '@posthog/hogql-parser'

const parser = await createHogQLParser()

// Parse a HogQL expression
const exprAST = JSON.parse(parser.parseExpr('1 + 2'))

// Parse a SELECT statement
const selectAST = JSON.parse(parser.parseSelect('SELECT event FROM events WHERE timestamp > now()'))

// Parse a Hog program
const programAST = JSON.parse(parser.parseProgram('let x := 42; return x;'))
```

All parse functions return JSON strings.
On failure they return a JSON error object instead of throwing:

```typescript
const result = JSON.parse(parser.parseExpr('!!!'))
if ('error' in result) {
  console.error(result.type, result.message) // e.g. "SyntaxError ..."
}
```

### API

| Method                                        | Description                        |
| --------------------------------------------- | ---------------------------------- |
| `parseExpr(input, isInternal?)`               | Parse a HogQL expression           |
| `parseSelect(input, isInternal?)`             | Parse a SELECT statement           |
| `parseOrderExpr(input, isInternal?)`          | Parse an ORDER BY expression       |
| `parseProgram(input, isInternal?)`            | Parse a Hog program                |
| `parseFullTemplateString(input, isInternal?)` | Parse a template string (`f'...'`) |
| `parseStringLiteralText(input)`               | Unquote a string literal           |

Setting `isInternal` to `true` omits position information from the AST.

## Python package (`hogql_parser`)

### Installation

```bash
pip install hogql_parser
```

The Python package is a native C++ extension and requires a platform with prebuilt wheels
(macOS and Linux, x86_64 and arm64).

### Local development

```bash
pip install ./common/hogql_parser
```

## Building from source

### Python

```bash
pip install ./common/hogql_parser
```

### WebAssembly

Requires the [Emscripten](https://emscripten.org/) toolchain and [Ninja](https://ninja-build.org/).

```bash
cd common/hogql_parser
npm run build
```

This compiles the parser to WASM and places the output in `dist/`.
npm package: @posthog/icons
Description: [![NPM](https://img.shields.io/npm/v/@posthog/icons.svg)](https://www.npmjs.com/package/@posthog/icons)
Author: PostHog
Latest version: 0.37.0

# @posthog/icons

[![NPM](https://img.shields.io/npm/v/@posthog/icons.svg)](https://www.npmjs.com/package/@posthog/icons)

→ [**Browse + search the icon library**](https://posthog-icons.vercel.app/)

Not sure an icon is right for your needs? Talk to Cory!

> Note: Don't share the link above as these icons are licensed from iconists.co/central

## Request another icons

1. [Browse the icon library](https://posthog-icons.vercel.app) to find what you need. Preface any icon name with `Icon`, ex: `<IconHeart />`.
1. React out to Cory if there is something you would like but can't find

## Icon details

- We use Central Icons Library and have an Enterprise license. (Since it's licenseed, we can't make the library public.)
- Icon specs: `1.5` stroke, `1.0` radius
- Icons are optimized with [SVGOMG](https://jakearchibald.github.io/svgomg/), then added to `Icons.tsx`, organized alphabetically

---

## Install

```bash
npm install --save @posthog/icons

# or

yarn add @posthog/icons
```

## Usage

```jsx
import { IconLogomark } from '@posthog/icons'

const Example = () => {
    return <IconLogomark className="size-4" />
}
```

## Development

`yarn dev`

## Publishing to NPM

1. Mark your PR with the appropriate label (e.g. `bump minor`)
2. When merged, it will trigger the bump, followed by publishing to npm
npm package: @posthog/lemon-ui
Description: [![npm package](https://img.shields.io/npm/v/@posthog/lemon-ui?style=flat-square)](https://www.npmjs.com/package/@posthog/lemon-ui) [![MIT License](https://img.shields.io/badge/License-MIT-red.svg?style=flat-square)](https://opensource.org/licenses/MIT)
Latest version: 0.0.0
npm package: @posthog/mailboxlayer-plugin
Description: Get email scores for PostHog users using the Mailboxlayer API.
Author: Yakko Majuri
Latest version: 0.0.7

# Email Scoring (Mailboxlayer) Plugin

Get email scores for users using the Mailboxlayer API and add them to PostHog user profiles. Suggested fixes will also be added if available.

![](readme-assets/email-validation.png)

## Installation

1. Visit 'Project Plugins' under 'Settings'
1. Enable plugins if you haven't already done so
1. Click the 'Repository' tab next to 'Installed'
1. Click 'Install' on this plugin
1. Sign up to [Mailboxlayer](https://mailboxlayer.com/)
1. Get an API key from Mailboxlayer
1. Click '+ Install new plugin' and use this URL to install: `https://github.com/PostHog/mailboxlayer-plugin`
1. Add the API key to the plugin config
1. Enable the plugin and watch the email scores come in!
npm package: @posthog/nextjs-config
Description: NextJS configuration helper for Posthog 🦔
Author: PostHog
Latest version: 1.9.2

# PostHog Next.js Config

This package handles sourcemap configuration and upload for the PostHog Error Tracking product.

Please see the main [PostHog Error Tracking docs](https://posthog.com/docs/error-tracking).

## Usage

```typescript
// next.config.ts
import { withPostHogConfig } from '@posthog/nextjs-config'

const nextConfig = {
  // Your Next.js configuration here
}

export default withPostHogConfig(nextConfig, {
  personalApiKey: process.env.POSTHOG_PERSONAL_API_KEY!, // Personal API key used for sourcemap uploads, see https://app.posthog.com/settings/user-api-keys
  projectId: process.env.POSTHOG_PROJECT_ID!, // Project ID, see https://app.posthog.com/settings/project#variables
  host: process.env.NEXT_PUBLIC_POSTHOG_HOST!, // (optional) Host URL, defaults to https://us.posthog.com
  sourcemaps: {
    // (optional)
    enabled: true, // (optional) Enable sourcemaps generation and upload, default to true on production builds
    releaseName: 'my-application', // (optional) Release name, defaults to repository name
    releaseVersion: '1.0.0', // (optional) Release version, defaults to current git commit
    deleteAfterUpload: true, // (optional) Delete sourcemaps after upload, defaults to true
  },
})
```

## Questions?

### [Check out our community page.](https://posthog.com/posts)