# reo-census

> Census - tracks npm package installations for Reo analytics

Latest version **1.2.10** (published 2026-08-05) · MIT license · 0 weekly downloads

## Install

```sh
npm install reo-census
pnpm add reo-census
yarn add reo-census
bun add reo-census
```

## Health

**Score 45/100 (D)** — status: active.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.2.10 |
| Published | 2026-08-05 |
| First published | 2026-02-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=12.0.0 |
| Dependencies | 0 |
| Unpacked size | 26.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | yes |
| Author | Saurabh |
| Maintainers | saurabhreo |
| Keywords | analytics, tracking, npm, package-analytics, telemetry |

## Links

- npm: https://www.npmjs.com/package/reo-census
- npm.io page: https://npm.io/package/reo-census

## Alternatives

- [@sentry/react-native](https://npm.io/package/@sentry/react-native.md) — 2.6M weekly downloads
- [@ardatan/aggregate-error](https://npm.io/package/@ardatan/aggregate-error.md) — 708.1K weekly downloads
- [custom-error-generator](https://npm.io/package/custom-error-generator.md) — 2.0K weekly downloads
- [@technik-sde/prosemirror-recreate-transform](https://npm.io/package/@technik-sde/prosemirror-recreate-transform.md) — 1.5K weekly downloads
- [@suchipi/error-utils](https://npm.io/package/@suchipi/error-utils.md) — 78 weekly downloads

## Recent versions

- 1.2.10 (latest) — 2026-08-05
- 1.2.9 — 2026-07-22
- 1.2.8 — 2026-03-04
- 1.2.6 — 2026-03-02
- 1.2.5 — 2026-03-02
- 1.2.4 — 2026-03-02
- 1.2.3 — 2026-03-02
- 1.2.2 — 2026-03-02
- 1.2.1 — 2026-02-27
- 1.2.0 — 2026-02-27

## README

# reo-census

Track installations of your npm package.

## Setup

Add `reo-census` to your `package.json` dependencies:

```json
{
  "name": "your-package",
  "version": "1.0.0",
  "dependencies": {
    "reo-census": "^1.2.9"
  }
}
```

That's it. Every time someone installs your package, installation data is collected and sent to your configured telemetry endpoint automatically.

## Optional Configuration

By default, tracking works out of the box with no configuration needed. You can optionally customize behavior by adding a `reoSettings` block to your `package.json`:

```json
{
  "name": "your-package",
  "version": "1.0.0",
  "reoSettings": {
    "defaultOptIn": true,
    "endpoint": "https://your-telemetry-endpoint.example.com/data",
    "dataMode": "partial"
  },
  "dependencies": {
    "reo-census": "^1.2.9"
  }
}
```

### Settings

- **`defaultOptIn`** (boolean, default: `true`)
  - `true` — tracking is enabled by default
  - `false` — tracking is disabled unless the end user opts in
- **`endpoint`** (string, optional)
  - The URL where tracking data is sent
  - Defaults to the built-in telemetry endpoint
- **`dataMode`** (string, default: `"partial"`)
  - `"partial"` — sends email domain only, no full email, no dependency list
  - `"full"` — sends full email and dependency list

## Data Collected

Each installation sends a JSON payload with:

- Package name and version
- OS platform, architecture, Node.js version
- Install timestamp
- Git username and email domain (partial mode) or full email (full mode)

## Opt-Out for End Users

End users can disable tracking by setting an environment variable before installing:

```bash
PACKAGE_TRACKER_ANALYTICS=false npm install
```

---
_Source: https://npm.io/package/reo-census · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
