# @mnrendra/asu

[![version](https://img.shields.io/npm/v/@mnrendra/asu?logo=nodedotjs)](https://www.npmjs.com/package/@mnrendra/asu?activeTab=versions)
[![downloads](https://img.shields.io/npm/dm/@mnrendra/asu)](https://npm-stat.com/charts.html?package=@mnrendra/asu)
[![size](https://packagephobia.now.sh/badge?p=@mnrendra/asu)](https://packagephobia.com/result?p=%40mnrendra%2Fasu)
[![coverage](https://codecov.io/github/mnrendra/asu/graph/badge.svg?token=LSNMMJVQ77)](https://app.codecov.io/gh/mnrendra/asu)
[![scorecard](https://api.securityscorecards.dev/projects/github.com/mnrendra/asu/badge)](https://securityscorecards.dev/viewer/?uri=github.com/mnrendra/asu)
[![release](https://github.com/mnrendra/asu/actions/workflows/release.yml/badge.svg)](https://github.com/mnrendra/asu/actions/workflows/release.yml)
[![semantic](https://img.shields.io/badge/semantic--release-angular-e10079?logo=semantic-release)](https://github.com/mnrendra/asu/commits/main)
[![license](https://img.shields.io/npm/l/@mnrendra/asu)](https://github.com/mnrendra/asu/blob/main/LICENSE)

A lightweight [stack trace](https://v8.dev/docs/asu-api) utility to retrieve `CallSite` objects from a specific caller.

*Useful for debugging, logging, or building tools that need to trace call origins at runtime.*

## Features
- ✅ Supports both **ES Modules** and **CommonJS** from a single source - see [package](https://www.npmjs.com/package/@mnrendra/asu?activeTab=code)
- ✅ Minified and cleansed of unnecessary dependencies, files, and attributes - see [contents](https://www.npmjs.com/package/@mnrendra/asu?activeTab=code)
- ✅ Tiny package - see [size](https://bundlephobia.com/package/@mnrendra/asu)
- ✅ Well tested - see [coverage](https://app.codecov.io/gh/mnrendra/asu)
- ✅ Security checked - see [scorecard](https://securityscorecards.dev/viewer/?uri=github.com/mnrendra/asu)
- ✅ Verified all commits - see [signatures](https://github.com/mnrendra/asu/commits/main)
- ✅ Semantic versioning - see [commits](https://github.com/mnrendra/asu/commits/main)
- ✅ Actively maintained - [pull requests](https://github.com/mnrendra/asu/pulls), [issues](https://github.com/mnrendra/asu/issues), [discussions](https://github.com/mnrendra/asu/discussions), and [contributions](https://github.com/mnrendra/asu/blob/HEAD/CONTRIBUTING.md) are welcome!

## Install
```bash
npm i @mnrendra/asu
```

## Security

We take security seriously in this project. If you discover a **vulnerability**, we strongly encourage you to report it in a responsible manner.

Please open a [Security Advisory](https://github.com/mnrendra/asu/security/advisories/new) to report any vulnerabilities.

For more information, please refer to our [Security Policy](https://github.com/mnrendra/asu/blob/HEAD/SECURITY.md).

## Contributing

We appreciate your help in making this project better. Please follow the [guidelines](https://github.com/mnrendra/asu/blob/HEAD/CONTRIBUTING.md) to ensure that your contributions are smoothly integrated.

## License
[MIT](https://github.com/mnrendra/asu/blob/HEAD/LICENSE)

## Author
[@mnrendra](https://github.com/mnrendra)