# @forge/util

> `@forge/util` bundles private Atlassian packages into public modules for Forge CLI consumers. Expose only the names that consumers in this monorepo need.

Latest version **4.0.0** (published 2026-11-09) · SEE LICENSE IN LICENSE.txt license · 0 weekly downloads

## Install

```sh
npm install @forge/util
pnpm add @forge/util
yarn add @forge/util
bun add @forge/util
```

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 4.0.0 |
| Published | 2026-11-09 |
| First published | 2019-11-25 |
| Weekly downloads | 0 |
| License | SEE LICENSE IN LICENSE.txt |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 410.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Atlassian |
| Maintainers | atlassianartifactteam |

## Links

- npm: https://www.npmjs.com/package/@forge/util
- npm.io page: https://npm.io/package/@forge/util

## Recent versions

- 4.0.0 (latest) — 2026-11-09
- 4.1.0-next.1-experimental-ea0dc44 (experimental) — 2026-11-19
- 4.1.0-next.1 (next) — 2026-11-12
- 4.1.0-next.1-experimental-aab0b34 — 2026-11-19
- 4.1.0-next.1-experimental-f59888d — 2026-11-18
- 4.1.0-next.1-experimental-55abb77 — 2026-11-18
- 4.1.0-next.1-experimental-c04e853 — 2026-11-17
- 4.1.0-next.1-experimental-a5f8a43 — 2026-11-16
- 4.0.1-next.0 — 2026-11-11
- 4.0.0-next.2 — 2026-11-03
- 3.1.0-next.0-experimental-1e95696 — 2026-11-01
- 4.0.0-next.1 — 2026-11-01
- 3.1.0-next.0-experimental-65945d2 — 2026-10-28
- 3.1.0-next.0 — 2026-10-27
- 3.0.0 — 2026-06-22
- … 124 more at https://npm.io/package/@forge/util/versions

## README

# @forge/util

`@forge/util` bundles private Atlassian packages into public modules for Forge CLI consumers.
Expose only the names that consumers in this monorepo need.

## Build

For development, `bolt install` from the repository root builds util automatically.
The [build script](scripts/build.sh) uses [webpack](webpack.config.js) to bundle the exports in [src](src/) into CommonJS modules under `packages/`.
ARI declarations remain available to workspace consumers and are excluded from the published package.

## Add exports to an existing package

Find the package's entry file through [webpack.config.js](webpack.config.js).
Add the required named exports to that file under `src/`.
The ARI declaration entry uses the same export list, so it updates with the bundle.
Update the expected exports in the [package integration tests](__test__/bundle.integration.test.ts).

## Add another package

1. Add the package to util's `devDependencies` with `yarn bolt w @forge/util add --dev <package>`.
   Run the command from the repository root.
2. Add an entry file under `src/` that exports only the required names.
3. Connect the entry through `webpack.config.js` and expose its generated path through [package.json](package.json) `exports`.
4. If workspace consumers need types, extend `scripts/build.sh` to prepare declarations beside the bundle.
5. Extend the package integration tests to load the new module and assert its public exports.

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