Developer

Migration notes

Move removed Apex SDK init aliases to the current InitConfig fields.

The legacy init aliases below are no longer supported. A stale key logs a one-time warning and is ignored, so migrate it to the current field.

Removed aliases

Removed fieldCurrent fieldRequired migration
deferTrackingtrackingStartReplace true with "idle" or false with "immediate".
antiFlickerantiFlickerModeReplace true with "full" or false with "off".
antiFlickerTimeoutantiFlickerTimeoutMsRename the timeout field.

Before

ts
import { init } from "@drip-apex/sdk";
 
init({
  shopId: "demo-shop",
  endpoint: "https://events.drip-apex.com",
  deferTracking: true,
  antiFlicker: true,
  antiFlickerTimeout: 1500
});

After

ts
import { init } from "@drip-apex/sdk";
 
init({
  shopId: "demo-shop",
  endpoint: "https://events.drip-apex.com",
  trackingStart: "idle",
  antiFlickerMode: "full",
  antiFlickerTimeoutMs: 1500
});

For most production installs, prefer antiFlickerMode: "scoped" over the legacy full-page hide behavior.

Config fetch naming

Use endpoint, not workerUrl, in SDK examples. The SDK normalizes the base endpoint and appends the correct path for /config, /events, /v1/handover/mint, and order identity calls.