Skip to content

Package-name migration

leadmaps public packages now use the @leadmaps npm scope. Existing @syntarie installations keep working during a 60-day compatibility window, so you can migrate in a normal release rather than as an emergency.

The stable migration release shipped on July 31, 2026. Compatibility support for the final @syntarie releases ends on September 29, 2026. Published versions remain installable after that date.

Historical packageFinal compatible versionCanonical packageStable version
@syntarie/tracking0.14.3@leadmaps/tracking0.14.3
@syntarie/tracking-node0.0.4@leadmaps/tracking-node0.0.4
@syntarie/shared1.2.0@leadmaps/shared2.0.1
@syntarie/mcp0.3.1@leadmaps/mcp0.3.1

The browser SDK, Node SDK, and MCP package keep their existing public API and version line. @leadmaps/shared starts at 2.0.0 because it intentionally offers a smaller customer contract. Version 2.0.1 adds the public consent-banner configuration contract.

Terminal window
pnpm remove @syntarie/tracking
pnpm add @leadmaps/tracking

Replace the scope in imports:

import { init, track } from '@syntarie/tracking';
import { init, track } from '@leadmaps/tracking';

Subpaths keep the same name, including /replay, /experience, /consent-banner, /forms, /feature-flags, and /ecommerce.

If you load the SDK through a CDN, change the package name there too:

https://esm.sh/@syntarie/tracking
https://esm.sh/@leadmaps/tracking

Use the same package replacement for your server application or MCP client:

Terminal window
pnpm remove @syntarie/tracking-node @syntarie/mcp
pnpm add @leadmaps/tracking-node @leadmaps/mcp

MCP environment variables and tool names do not change.

@leadmaps/shared contains the supported customer-facing contracts for:

  • Events and the event JSON schema.
  • Brand, attribution, and identity types.
  • Feature-flag types and evaluation.
  • Insight and anomaly types.
  • Experience analytics types.
  • Consent-banner configuration types.
  • Tracking-plan parsing and schema.
  • License verification.

Historical subpaths for product billing policy, plan enforcement, cohort execution, lead-pipeline runtime, site-liveness policy, and storage gates are not part of the canonical public package. If your application imported one of those modules, keep the historical package during the compatibility window and move that behavior to the corresponding leadmaps API.

The final historical releases are supported through September 29, 2026. During that window, critical and security fixes are published under both scopes. New installation instructions and later feature releases use @leadmaps.

After the window, the historical package names are deprecated rather than unpublished, so existing lockfiles remain reproducible.

No browser console warning is added for the scope migration.