@zernio/node 0.2.982 → 0.2.984

package/dist/index.d.mts

@@ -48579,6 +48579,10 @@ type UpdateTrackingTagData = {
         automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
         firstPartyCookieStatus?: 'empty' | 'first_party_cookie_disabled' | 'first_party_cookie_enabled';
         dataUseSetting?: 'advertising_and_analytics' | 'analytics_only' | 'empty';
+        /**
+         * First-party cookie on or off (TikTok, LinkedIn). Platform-neutral alternative to `firstPartyCookieStatus`.
+         */
+        enableFirstPartyCookies?: boolean;
         /**
          * Google Ads: turn gclid auto-tagging on or off for the ad account.
          */

package/dist/index.d.ts

@@ -48579,6 +48579,10 @@ type UpdateTrackingTagData = {
         automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
         firstPartyCookieStatus?: 'empty' | 'first_party_cookie_disabled' | 'first_party_cookie_enabled';
         dataUseSetting?: 'advertising_and_analytics' | 'analytics_only' | 'empty';
+        /**
+         * First-party cookie on or off (TikTok, LinkedIn). Platform-neutral alternative to `firstPartyCookieStatus`.
+         */
+        enableFirstPartyCookies?: boolean;
         /**
          * Google Ads: turn gclid auto-tagging on or off for the ad account.
          */

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.982",
+  version: "0.2.984",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.982",
+  version: "0.2.984",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.982",
+  "version": "0.2.984",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -13645,6 +13645,15 @@ export const startBusinessAgentEvalRun = <ThrowOnError extends boolean = false>(
  * connection can read (an ad account the user has no Business Access role on is skipped).
  * `id` equals `siteTagId`, the id the site loads with `pintrk('load', id)`.
  *
+ * TikTok (platform `tiktokads`): TikTok Pixels across the connection's advertisers, or one
+ * advertiser with `?adAccountId=<numeric advertiser_id>`. `id` is the numeric `pixel_id`,
+ * `siteTagId` the alphanumeric `pixel_code` from Events Manager. Connections authorized
+ * before the Pixel Management permission (about 2026-05-28) answer 403 until reconnected.
+ *
+ * X Ads (platform `xads`): one X Pixel per X ad account, so `TrackingTag.id` is the ad
+ * account id (base36, e.g. `18ce54d4x5t`) and `siteTagId` is the pixel id the site embeds.
+ * Ad accounts without a pixel are left out. `adAccountId` scopes the list to one ad account.
+ *
  */
 export const listTrackingTags = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListTrackingTagsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListTrackingTagsResponse, ListTrackingTagsError, ThrowOnError>({
@@ -13703,6 +13712,18 @@ export const listTrackingTags = <ThrowOnError extends boolean = false>(options:
  * created, which is what switches Google's conversion tracking on, and
  * the tag is returned with it as its first event.
  *
+ * TikTok: `POST /pixel/create/` on the advertiser in `adAccountId` (numeric). Names are at
+ * most 40 characters with no emoji and must be unique; TikTok refuses a duplicate name
+ * (400), which is its only retry guard. TikTok has no pixel delete API.
+ *
+ * Pinterest's `code` snippet. NOT idempotent and Pinterest has no dry-run and no delete for
+ * tags, so never retry blindly: list first.
+ *
+ * X Ads (platform `xads`): creates the ad account's X Pixel (its UNIVERSAL website tag) with
+ * first-party cookies on. `adAccountId` is the X ad account id; `name` is not stored (X
+ * pixels have no name). X allows one pixel per ad account and cannot delete one, so an
+ * account that already has a pixel answers 409 without writing anything.
+ *
  */
 export const createTrackingTag = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateTrackingTagData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateTrackingTagResponse, CreateTrackingTagError, ThrowOnError>({
@@ -13736,6 +13757,15 @@ export const createTrackingTag = <ThrowOnError extends boolean = false>(options:
  * and `lastFiredTime`. Without `adAccountId` Zernio finds the ad account that owns the tag
  * (404 when no readable ad account holds it).
  *
+ * TikTok: read from `/pixel/list/?pixel_id=`; `code` is TikTok's `pixel_script`, `events`
+ * the pixel events. `lastFiredTime` is not available on TikTok. Without `adAccountId` the
+ * connection's advertisers are searched.
+ *
+ * X Ads (platform `xads`): `tagId` is the X ad account id. Returns the pixel id as
+ * `siteTagId`, the X Pixel base code as `code`, and the conversion events the site can fire
+ * in `events` (each with `siteEventId` = `tw-<pixel>-<event>`, also the `event_id` of the X
+ * Conversions API). An ad account without a pixel answers 400.
+ *
  */
 export const getTrackingTag = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTrackingTagData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetTrackingTagResponse, GetTrackingTagError, ThrowOnError>({
@@ -13777,6 +13807,20 @@ export const getTrackingTag = <ThrowOnError extends boolean = false>(options: Op
  * PATCH or PUT on `conversion_tags/{id}` answer 405 "Method not allowed". Set enhanced match
  * at creation (`automaticMatchingFields`) or change it and the name in Pinterest Ads Manager.
  *
+ * TikTok: `name`, `enableAutomaticMatching` + `automaticMatchingFields` (folded onto
+ * TikTok's five switches: em, ph, fn/ln, ct/st/zp/country, external_id; ge and db answer
+ * 400), and first-party cookies via `enableFirstPartyCookies` or `firstPartyCookieStatus`
+ * (enabled or disabled). TikTok has no pixel delete: the endpoint is absent from its API and
+ * `POST /pixel/delete/` answers 404.
+ *
+ * Pinterest (platform `pinterestads`): 501. Pinterest API v5 only creates, lists and reads
+ * tags (no update endpoint); rename a tag or change its enhanced match settings in Pinterest
+ * Ads Manager.
+ *
+ * X Ads (platform `xads`): only `firstPartyCookieStatus` (`first_party_cookie_enabled` or
+ * `first_party_cookie_disabled`), which sets the pixel's first-party cookie setting. X has
+ * no API to rename or delete a pixel.
+ *
  */
 export const updateTrackingTag = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateTrackingTagData, ThrowOnError>) => {
     return (options?.client ?? client).patch<UpdateTrackingTagResponse, UpdateTrackingTagError, ThrowOnError>({
@@ -13793,6 +13837,9 @@ export const updateTrackingTag = <ThrowOnError extends boolean = false>(options:
  * Insight Tag; the role (`FULL` or `USE_ONLY`) is appended to `name`. LinkedIn exposes
  * permissions per ad account only, so accounts the connection cannot see are not listed.
  *
+ * TikTok (`tiktokads`): the advertisers linked to the pixel in its Business Center
+ * (`/bc/pixel/link/get/`); a pixel outside Business Center answers 400.
+ *
  */
 export const listTrackingTagSharedAccounts = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListTrackingTagSharedAccountsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListTrackingTagSharedAccountsResponse, ListTrackingTagSharedAccountsError, ThrowOnError>({
@@ -13814,6 +13861,11 @@ export const listTrackingTagSharedAccounts = <ThrowOnError extends boolean = fal
  * `adAccountId` is the numeric LinkedIn ad account id. An ad account uses one Insight Tag at
  * a time, so a target that already has one answers 400.
  *
+ * TikTok: links the pixel to an advertiser through Business Center
+ * (`/bc/pixel/link/update/`, `adAccountId` = numeric advertiser_id). Only a pixel that is an
+ * asset of a Business Center this connection manages can be shared; otherwise the answer is
+ * 400 asking to transfer it to Business Center first.
+ *
  */
 export const addTrackingTagSharedAccount = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<AddTrackingTagSharedAccountData, ThrowOnError>) => {
     return (options?.client ?? client).post<AddTrackingTagSharedAccountResponse, AddTrackingTagSharedAccountError, ThrowOnError>({
@@ -13832,6 +13884,8 @@ export const addTrackingTagSharedAccount = <ThrowOnError extends boolean = false
  * revoking the last ad account that holds the tag: LinkedIn accepts that call and the tag
  * is orphaned (verified live).
  *
+ * TikTok: unlinks through Business Center (`/bc/pixel/link/update/` with `UNLINK`).
+ *
  */
 export const removeTrackingTagSharedAccount = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RemoveTrackingTagSharedAccountData, ThrowOnError>) => {
     return (options?.client ?? client).delete<RemoveTrackingTagSharedAccountResponse, RemoveTrackingTagSharedAccountError, ThrowOnError>({
@@ -13993,6 +14047,14 @@ export const removeTrackingTagFromStore = <ThrowOnError extends boolean = false>
  * `event_name`. Standard events (`pagevisit`, `checkout`...) need no object and are not
  * listed.
  *
+ * TikTok: the pixel's events from `/pixel/list/`. TikTok refreshes this list every 2 to 4
+ * hours, so a just-created event can be missing. `siteEventId` is the `ttq.track()` name the
+ * site fires.
+ *
+ * X Ads (platform `xads`): the ad account's web event tags the site can fire. Events X
+ * auto-creates with the pixel (site visits, landing page views, one per standard type) share the
+ * pixel id, cannot be fired one by one and are left out; they still appear in stats.
+ *
  */
 export const listTrackingTagEvents = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListTrackingTagEventsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListTrackingTagEventsResponse, ListTrackingTagEventsError, ThrowOnError>({
@@ -14058,6 +14120,21 @@ export const listTrackingTagEvents = <ThrowOnError extends boolean = false>(opti
  * VIEW_CATEGORY, VIEW_CONTENT, SEARCH, WATCH_VIDEO) or `siteEvent`. A duplicate name answers
  * 400.
  *
+ * TikTok: `POST /pixel/event/create/`. `type` is a TikTok pixel event type (SHOPPING,
+ * ON_WEB_CART, ON_WEB_DETAIL, INITIATE_ORDER, ADD_BILLING, ON_WEB_SEARCH, PAGE_VIEW,
+ * ON_WEB_REGISTER, FORM, ...), or pass `siteEvent`. Stores `name` (at most 40 characters),
+ * `defaultValue` and `currency` (USD, JPY or INR only). TikTok returns no id: the new event
+ * is read back from the pixel, and while TikTok's listing has not refreshed the response
+ * carries an empty `id` and `status: pending`.
+ *
+ * X Ads (platform `xads`): creates a web event tag. Fields: `name`, `type` (X enum:
+ * ADDED_PAYMENT_INFO, ADD_TO_CART, ADD_TO_WISHLIST, CHECKOUT_INITIATED, CONTENT_VIEW,
+ * CUSTOM, DOWNLOAD, INSTALL, LANDING_PAGE_VIEW, LOGIN, PRODUCT_CUSTOMIZATION, PURCHASE,
+ * SEARCH, SESSION, SIGN_UP, SITE_VISIT, START_TRIAL, SUBSCRIBE) or `siteEvent`,
+ * `clickWindowDays` (1, 7, 14, 30, 60 or 90; default 30) and `viewWindowDays` (0, 1, 7, 14,
+ * 30, 60 or 90, at most the click window; default 1). Retargeting is enabled, as in Events
+ * Manager.
+ *
  */
 export const createTrackingTagEvent = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateTrackingTagEventData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateTrackingTagEventResponse, CreateTrackingTagEventError, ThrowOnError>({
@@ -14089,6 +14166,12 @@ export const createTrackingTagEvent = <ThrowOnError extends boolean = false>(opt
  * Pinterest identifies the event by its name, so `name` cannot change (400): create the new
  * name and delete the old one.
  *
+ * TikTok: `name`, `defaultValue` and `currency` (USD, JPY or INR); the type cannot change
+ * (delete and recreate).
+ *
+ * X Ads (platform `xads`): the same fields as create. Events X auto-created with the pixel
+ * cannot be changed (400).
+ *
  */
 export const updateTrackingTagEvent = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateTrackingTagEventData, ThrowOnError>) => {
     return (options?.client ?? client).patch<UpdateTrackingTagEventResponse, UpdateTrackingTagEventError, ThrowOnError>({
@@ -14120,6 +14203,13 @@ export const updateTrackingTagEvent = <ThrowOnError extends boolean = false>(opt
  * Pinterest (platform `pinterestads`): stops Pinterest tracking the event name (`state:
  * disabled`); Pinterest keeps the event's history.
  *
+ * TikTok: hard delete (`/pixel/event/delete/`); TikTok refuses events bound to an ad group
+ * (400).
+ *
+ * X Ads (platform `xads`): deletes the web event tag for good. Events X auto-created with
+ * the pixel cannot be deleted (400). X keeps the event's own website tag id on the account
+ * (it has no delete for website tags), left without a conversion event.
+ *
  */
 export const deleteTrackingTagEvent = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<DeleteTrackingTagEventData, ThrowOnError>) => {
     return (options?.client ?? client).delete<DeleteTrackingTagEventResponse, DeleteTrackingTagEventError, ThrowOnError>({
@@ -14240,6 +14330,16 @@ export const getTrackingTagDiagnostics = <ThrowOnError extends boolean = false>(
  * (ad-account level, not per tag; an account Pinterest cannot score yet carries `error`
  * instead). Pinterest has no time-bounded counts, so `startTime`/`endTime` answer 400.
  *
+ * TikTok: per-event counts from `/pixel/event/stats/` (`total_count`,
+ * `browser_event_total_count`, `server_event_total_count`, `attributed_count`,
+ * `preview_count`), bucketed by UTC day. Defaults to the last 7 days; at most 30 days per
+ * request. `aggregation` is not accepted.
+ *
+ * X Ads (platform `xads`): X has no event counts per pixel or event (only campaign-level
+ * conversion metrics). Each row is one web event tag with its `status` (TRACKING,
+ * UNVERIFIED, DORMANT), `lastTrackedTime` (unix seconds, null if never seen), `autoCreated`
+ * and, for events the site can fire, `siteEventId`.
+ *
  */
 export const getTrackingTagStats = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTrackingTagStatsData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetTrackingTagStatsResponse, GetTrackingTagStatsError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -49722,6 +49722,10 @@ export type UpdateTrackingTagData = {
         automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
         firstPartyCookieStatus?: 'empty' | 'first_party_cookie_disabled' | 'first_party_cookie_enabled';
         dataUseSetting?: 'advertising_and_analytics' | 'analytics_only' | 'empty';
+        /**
+         * First-party cookie on or off (TikTok, LinkedIn). Platform-neutral alternative to `firstPartyCookieStatus`.
+         */
+        enableFirstPartyCookies?: boolean;
         /**
          * Google Ads: turn gclid auto-tagging on or off for the ad account.
          */