# @atlaskit/link-provider

> Contains provider with react context for anything link related and the link http client

Latest version **6.3.0** (published 2026-11-17) · Apache-2.0 license · 26.3K weekly downloads

## Install

```sh
npm install @atlaskit/link-provider
pnpm add @atlaskit/link-provider
yarn add @atlaskit/link-provider
bun add @atlaskit/link-provider
```

## Health

**Score 75/100 (B)** — status: active.

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

## Facts

| | |
|---|---|
| Version | 6.3.0 |
| Published | 2026-11-17 |
| First published | 2022-04-06 |
| Weekly downloads | 26.3K |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 12 |
| Unpacked size | 292.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Atlassian Pty Ltd |
| Maintainers | atlassianartifactteam |

## Links

- npm: https://www.npmjs.com/package/@atlaskit/link-provider
- Repository: https://bitbucket.org/atlassian/atlassian-frontend-mirror
- Homepage: https://bitbucket.org/atlassian/atlassian-frontend-mirror#readme
- Issues: https://bitbucket.org/atlassian/atlassian-frontend-mirror/issues
- npm.io page: https://npm.io/package/@atlaskit/link-provider

## Dependencies (12)

- [redux](https://npm.io/package/redux.md) ^3.7.2
- [lodash](https://npm.io/package/lodash.md) ^4.17.21
- [lru_map](https://npm.io/package/lru_map.md) ^0.4.1
- [dataloader](https://npm.io/package/dataloader.md) ^2.1.0
- [p-throttle](https://npm.io/package/p-throttle.md) ^4.1.1
- [async-retry](https://npm.io/package/async-retry.md) ^1.2.3
- [@babel/runtime](https://npm.io/package/@babel/runtime.md) ^7.0.0
- [@atlaskit/json-ld-types](https://npm.io/package/@atlaskit/json-ld-types.md) ^2.1.0
- [@atlaskit/linking-common](https://npm.io/package/@atlaskit/linking-common.md) ^13.0.0
- [@atlaskit/link-extractors](https://npm.io/package/@atlaskit/link-extractors.md) ^5.0.0
- [@atlaskit/react-compiler-gating](https://npm.io/package/@atlaskit/react-compiler-gating.md) ^0.2.0
- [@atlaskit/platform-feature-flags](https://npm.io/package/@atlaskit/platform-feature-flags.md) ^2.2.0

## Recent versions

- 6.3.0 (latest) — 2026-11-17
- 1.6.2 (next) — 2023-05-17
- 6.2.0 — 2026-11-16
- 6.1.1 — 2026-11-14
- 6.1.0 — 2026-11-04
- 6.0.1 — 2026-09-30
- 6.0.0 — 2026-09-24
- 5.7.1 — 2026-09-18
- 5.7.0 — 2026-09-16
- 5.6.2 — 2026-09-16
- 5.6.1 — 2026-09-15
- 5.6.0 — 2026-09-09
- 5.5.1 — 2026-09-07
- 5.5.0 — 2026-08-29
- 5.4.0 — 2026-08-20
- … 137 more at https://npm.io/package/@atlaskit/link-provider/versions

## README

# @atlaskit/link-provider

>

## Usage

```
import { SmartCardProvider, CardClient } from '@atlaskit/link-provider'
import { Card } from '@atlaskit/smart-card'

<SmartCardProvider client={new CardClient()}>
  <Card />
</SmartCardProvider>
```

### Choreographing Smart Card experiments

Products supply a stable `choreographer` component to `SmartCardProvider`. Create it once at module
scope with `createChoreographedContent` and the product's existing `useChoreographer` hook:

```tsx
import { createChoreographedContent } from '@atlaskit/link-provider/create-choreographed-content';

const SmartCardChoreographer = createChoreographedContent(useChoreographer);
```

If the product obtains its choreographer from React context, pass a module-level custom hook that
reads that context and calls the native hook. Do not create the adapter during rendering. A nested
provider inherits the outer provider's component. The public package has no runtime dependency on
Post Office.

Experiments can use `ChoreographedContent` from `@atlaskit/link-provider/choreographed-content`:

```tsx
<ChoreographedContent
	messageId="my-smart-card-experiment"
	isActive={isEligible}
	onUnavailable={cancelOpportunity}
>
	{({ hasPermission }) => <MyPopup isOpen={hasPermission} trigger={normalAction} />}
</ChoreographedContent>
```

Keep the normal action rendered while permission is pending or unavailable. Close the opportunity
(`isActive={false}`) on action, dismissal, or loss of eligibility; unmounting also releases it. Use
a distinct message ID for each experiment. Concurrent instances receive distinct registration IDs.
Missing host integration, rejected delivery, and choreographer revocation fail closed. A blocked
request is not automatically retried. The adapter requests no automatic expiry. The current native
choreographer may apply its default five-minute expiry to queued requests; any expiry or host stop
hides the UI. Closing the opportunity or unmounting releases the claim.

This only coordinates participating in-app messages. The experiment still owns feature gates,
assignment, audience checks, impressions, dismissal history, and analytics. No portal message or
headless API is required.

Pass `shouldClaim` to `ChoreographedContent` when eligibility or experiment assignment must be
checked at slot offer. Returning false or throwing declines the offer. It is not called for blocked
or canceled attempts. The current predicate is used without restarting a pending request.

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