@adcp/client

@adcp/client

This package has been renamed to @adcp/sdk.

@adcp/client continues to publish as a thin re-export of @adcp/sdk so existing installs keep working without code changes. New projects should install @adcp/sdk directly.

Migration

- npm install @adcp/client
+ npm install @adcp/sdk

- import { AdcpClient } from '@adcp/client';
+ import { AdcpClient } from '@adcp/sdk';

All subpaths (/client, /server, /compliance, /testing, /conformance, /signing, etc.) are available under the new name with identical APIs.

Why the rename

@adcp/client ships three distinct surfaces — a buyer-side client, a server builder, and a compliance harness. The new name and /client /server /compliance subpaths make that shape explicit.

Versioning

@adcp/client and @adcp/sdk are version-linked via the repo's changeset config — both packages release at the same number on every cut, and the shim's dependencies."@adcp/sdk" covers the published range so npm dedupes consumers' trees that pull both names.

Troubleshooting

@adcp/client could not locate @adcp/sdk — the CLI delegator calls require.resolve('@adcp/sdk/package.json') and fails when @adcp/sdk is missing from the install tree. Most common with npm install --legacy-peer-deps or Yarn classic with nohoist skipping the peer auto-install. Resolve by running npm install @adcp/sdk alongside, or by removing the --legacy-peer-deps flag if it's not load-bearing for the rest of your tree.

Deprecation timeline

• 5.x line (now): soft-deprecated. @adcp/client continues to publish as a re-export of @adcp/sdk. Every release is auto-deprecated on the npm registry so npm install shows the rename pointer; the package still works without code changes. New features ship to @adcp/sdk only — the shim never gains capability.
• 6.0 (next major): hard-deprecated. Final release of @adcp/client ships under 5.x; 6.0 publishes as @adcp/sdk only. Consumers who haven't migrated by then need to swap their imports before bumping major.
• Removal signal: @adcp/sdk weekly downloads sustained above @adcp/client for two consecutive months. We post the removal date 90 days in advance on the GitHub repo before stopping shim publishes.

The shim is intentionally minimal so this timeline can hold without surprise — there's nothing in packages/client-shim/ that diverges from @adcp/sdk semantically. If you're reading this and want the migration to take a long weekend, the change is s/@adcp\/client/@adcp\/sdk/g across imports plus a single dependency swap in package.json.