@getlatedev/node 0.2.1273 → 0.2.1275

package/dist/index.d.mts

@@ -1051,7 +1051,7 @@ declare class Zernio {
         createAdInsightsReport: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreateAdInsightsReportData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreateAdInsightsReportResponse, unknown, ThrowOnError>;
         getAdInsightsReport: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdInsightsReportData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdInsightsReportResponse, unknown, ThrowOnError>;
         getAdAnalytics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdAnalyticsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdAnalyticsResponse, unknown, ThrowOnError>;
-        getTikTokSmartPlusMaterialReport: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTikTokSmartPlusMaterialReportData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTikTokSmartPlusMaterialReportResponse, ErrorResponse, ThrowOnError>;
+        getTikTokSmartPlusMaterialReport: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTikTokSmartPlusMaterialReportData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTikTokSmartPlusMaterialReportResponse, unknown, ThrowOnError>;
     };
     /**
      * adcreatives API
@@ -1831,7 +1831,7 @@ declare class Zernio {
         /** @deprecated Use `zernio.adinsights.getAdAnalytics` instead. */
         getAdAnalytics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdAnalyticsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdAnalyticsResponse, unknown, ThrowOnError>;
         /** @deprecated Use `zernio.adinsights.getTikTokSmartPlusMaterialReport` instead. */
-        getTikTokSmartPlusMaterialReport: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTikTokSmartPlusMaterialReportData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTikTokSmartPlusMaterialReportResponse, ErrorResponse, ThrowOnError>;
+        getTikTokSmartPlusMaterialReport: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTikTokSmartPlusMaterialReportData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTikTokSmartPlusMaterialReportResponse, unknown, ThrowOnError>;
         /** @deprecated Use `zernio.conversions.getConversionsQuality` instead. */
         getConversionsQuality: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetConversionsQualityData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetConversionsQualityResponse, unknown, ThrowOnError>;
         /** @deprecated Use `zernio.conversions.sendConversions` instead. */
@@ -45982,7 +45982,7 @@ type GetTikTokSmartPlusMaterialReportResponse = ({
         };
     }>;
 });
-type GetTikTokSmartPlusMaterialReportError = (ErrorResponse);
+type GetTikTokSmartPlusMaterialReportError = (ErrorResponse | unknown);
 type ListAdsInstagramAccountsData = {
     query: {
         /**

package/dist/index.d.ts

@@ -1051,7 +1051,7 @@ declare class Zernio {
         createAdInsightsReport: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreateAdInsightsReportData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreateAdInsightsReportResponse, unknown, ThrowOnError>;
         getAdInsightsReport: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdInsightsReportData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdInsightsReportResponse, unknown, ThrowOnError>;
         getAdAnalytics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdAnalyticsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdAnalyticsResponse, unknown, ThrowOnError>;
-        getTikTokSmartPlusMaterialReport: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTikTokSmartPlusMaterialReportData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTikTokSmartPlusMaterialReportResponse, ErrorResponse, ThrowOnError>;
+        getTikTokSmartPlusMaterialReport: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTikTokSmartPlusMaterialReportData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTikTokSmartPlusMaterialReportResponse, unknown, ThrowOnError>;
     };
     /**
      * adcreatives API
@@ -1831,7 +1831,7 @@ declare class Zernio {
         /** @deprecated Use `zernio.adinsights.getAdAnalytics` instead. */
         getAdAnalytics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdAnalyticsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdAnalyticsResponse, unknown, ThrowOnError>;
         /** @deprecated Use `zernio.adinsights.getTikTokSmartPlusMaterialReport` instead. */
-        getTikTokSmartPlusMaterialReport: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTikTokSmartPlusMaterialReportData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTikTokSmartPlusMaterialReportResponse, ErrorResponse, ThrowOnError>;
+        getTikTokSmartPlusMaterialReport: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTikTokSmartPlusMaterialReportData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTikTokSmartPlusMaterialReportResponse, unknown, ThrowOnError>;
         /** @deprecated Use `zernio.conversions.getConversionsQuality` instead. */
         getConversionsQuality: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetConversionsQualityData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetConversionsQualityResponse, unknown, ThrowOnError>;
         /** @deprecated Use `zernio.conversions.sendConversions` instead. */
@@ -45982,7 +45982,7 @@ type GetTikTokSmartPlusMaterialReportResponse = ({
         };
     }>;
 });
-type GetTikTokSmartPlusMaterialReportError = (ErrorResponse);
+type GetTikTokSmartPlusMaterialReportError = (ErrorResponse | unknown);
 type ListAdsInstagramAccountsData = {
     query: {
         /**

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1273",
+  version: "0.2.1275",
   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: "@getlatedev/node",
-  version: "0.2.1273",
+  version: "0.2.1275",
   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": "@getlatedev/node",
-  "version": "0.2.1273",
+  "version": "0.2.1275",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -11457,6 +11457,14 @@ export const getAdReview = <ThrowOnError extends boolean = false>(options: Optio
  * (creator content, authorized TikTok posts, Creative Library content) and lists each image of a
  * carousel under its own material id, so those entries come back with the review verdict and
  * null descriptive fields. TikTok returns no review timestamp; `readAt` is when Zernio read it.
+ *
+ * TikTok's review endpoint has a strict quota of its own. One TikTok call reads the review of
+ * every live Smart+ ad of the ad group (up to 100), and each review is cached for 10 minutes per
+ * connection, advertiser and Smart+ ad, so sibling ads are answered from the cache and `readAt`
+ * can be up to 10 minutes old. Read reviews when you need them instead of sweeping every ad on a
+ * loop. When TikTok answers over quota, Zernio returns 429 with `Retry-After: 60` and answers
+ * 429 for that advertiser and connection without calling TikTok until the minute is over; cached
+ * reviews are still served.
  */
 export const getTikTokSmartPlusAdReview = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTikTokSmartPlusAdReviewData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetTikTokSmartPlusAdReviewResponse, GetTikTokSmartPlusAdReviewError, ThrowOnError>({
@@ -11967,7 +11975,7 @@ export const listAdsTikTokIdentities = <ThrowOnError extends boolean = false>(op
 
 /**
  * Per-creative performance inside TikTok Smart+ ads
- * Breaks a Smart+ ad (or ad group) down by creative material, one row per Spark post, video or image, from TikTok's Smart+ material report. For a Spark post `tiktokItemId` is the TikTok post id. Conversion metrics are TikTok web (pixel) events. `purchases`, `purchaseValue` and `roas` come from Complete Payment, or from Place an Order (legacy ON_WEB_ORDER pixels) when that reports more; the two are never summed. TikTok allows two dimensions per report, so rows are keyed by the Smart+ ad (`level=ad`) or by the ad group (`level=adGroup`), not both. Metrics TikTok returns empty come back as null.
+ * Breaks a Smart+ ad (or ad group) down by creative material, one row per Spark post, video or image, from TikTok's Smart+ material report. For a Spark post `tiktokItemId` is the TikTok post id. Conversion metrics are TikTok web (pixel) events. `purchases`, `purchaseValue` and `roas` come from Complete Payment, or from Place an Order (legacy ON_WEB_ORDER pixels) when that reports more; the two are never summed. TikTok allows two dimensions per report, so rows are keyed by the Smart+ ad (`level=ad`) or by the ad group (`level=adGroup`), not both. A row is identified by `smartPlusAdId` + `materialId` at `level=ad` and by `adGroupId` + `materialId` at `level=adGroup`; each appears once across all pages. Rows are sorted by `spend` descending, then the Smart+ ad or ad group id, then `materialId`, and the full result is cached for 10 minutes per account, advertiser and query, so pages read within that window are consistent and `totalRows` counts distinct rows. When TikTok's slices do not add up to the row count it declares on two reads, the call answers 502 instead of a short result. Metrics TikTok returns empty come back as null.
  */
 export const getTikTokSmartPlusMaterialReport = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTikTokSmartPlusMaterialReportData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetTikTokSmartPlusMaterialReportResponse, GetTikTokSmartPlusMaterialReportError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -46631,7 +46631,7 @@ export type GetTikTokSmartPlusMaterialReportResponse = ({
     }>;
 });
 
-export type GetTikTokSmartPlusMaterialReportError = (ErrorResponse);
+export type GetTikTokSmartPlusMaterialReportError = (ErrorResponse | unknown);
 
 export type ListAdsInstagramAccountsData = {
     query: {