@zernio/node 0.2.720 → 0.2.721

package/dist/index.d.mts

@@ -980,7 +980,7 @@ declare class Zernio {
      * adlibrary API
      */
     adlibrary: {
-        searchAdLibrary: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<SearchAdLibraryData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SearchAdLibraryResponse, unknown, ThrowOnError>;
+        searchAdLibrary: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<SearchAdLibraryData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SearchAdLibraryResponse, unknown, ThrowOnError>;
     };
     /**
      * adaudiences API
@@ -35563,11 +35563,11 @@ type SearchAdTargetingError = (unknown | {
     error?: string;
 });
 type SearchAdLibraryData = {
-    query: {
+    query?: {
         /**
-         * Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+         * Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform.
          */
-        accountId: string;
+        accountId?: string;
         /**
          * Meta only.
          */
@@ -35604,6 +35604,10 @@ type SearchAdLibraryData = {
          * Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
          */
         pageIds?: string;
+        /**
+         * Which archive to search. `meta` needs no accountId. Required unless accountId is given.
+         */
+        platform?: 'meta' | 'linkedin';
         /**
          * Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
          */

package/dist/index.d.ts

@@ -980,7 +980,7 @@ declare class Zernio {
      * adlibrary API
      */
     adlibrary: {
-        searchAdLibrary: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<SearchAdLibraryData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SearchAdLibraryResponse, unknown, ThrowOnError>;
+        searchAdLibrary: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<SearchAdLibraryData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SearchAdLibraryResponse, unknown, ThrowOnError>;
     };
     /**
      * adaudiences API
@@ -35563,11 +35563,11 @@ type SearchAdTargetingError = (unknown | {
     error?: string;
 });
 type SearchAdLibraryData = {
-    query: {
+    query?: {
         /**
-         * Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+         * Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform.
          */
-        accountId: string;
+        accountId?: string;
         /**
          * Meta only.
          */
@@ -35604,6 +35604,10 @@ type SearchAdLibraryData = {
          * Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
          */
         pageIds?: string;
+        /**
+         * Which archive to search. `meta` needs no accountId. Required unless accountId is given.
+         */
+        platform?: 'meta' | 'linkedin';
         /**
          * Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
          */

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -9563,19 +9563,18 @@ export const searchAdTargeting = <ThrowOnError extends boolean = false>(options:
 
 /**
  * Search the public Ad Library
- * Competitor and market research over the platform's public ad archive, searched with the
- * customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for
- * a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`)
- * for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under
- * `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).
+ * Competitor and market research over the public ad archives. Meta's Ad Library
+ * (`GET /ads_archive`) is searched with Zernio's own developer access, so `platform=meta` needs
+ * no connected account at all. LinkedIn's Ad Library (`GET /rest/adLibrary`) runs on a connected
+ * `linkedin` / `linkedinads` account, passed as `accountId`. Passing a Meta account as `accountId`
+ * also selects Meta. Rows are returned in the platform's raw shape under `data`; `paging.after`
+ * is an opaque cursor on both (`null` when exhausted).
  *
  * **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is
  * in the archive only if it was delivered to the EU or UK within the last year, so a US-only
  * commercial advertiser is invisible. Spend, impressions and demographics are political-only
- * fields and are left out of the default projection; request them via `fields`. Meta serves the
- * archive only to people who confirmed their identity and location at facebook.com/ID: until the
- * Facebook user behind the connection has done so, the call fails with
- * `meta_identity_confirmation_required` (403).
+ * fields and are left out of the default projection; request them via `fields`. All customers
+ * share Zernio's Meta quota, so a `429` means back off for a minute.
  *
  * **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their
  * last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets.
@@ -9586,7 +9585,7 @@ export const searchAdTargeting = <ThrowOnError extends boolean = false>(options:
  * `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400
  * naming the param.
  */
-export const searchAdLibrary = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<SearchAdLibraryData, ThrowOnError>) => {
+export const searchAdLibrary = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<SearchAdLibraryData, ThrowOnError>) => {
     return (options?.client ?? client).get<SearchAdLibraryResponse, SearchAdLibraryError, ThrowOnError>({
         ...options,
         url: '/v1/ads/library'

package/src/generated/types.gen.ts

@@ -36220,11 +36220,11 @@ export type SearchAdTargetingError = (unknown | {
 });
 
 export type SearchAdLibraryData = {
-    query: {
+    query?: {
         /**
-         * Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+         * Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform.
          */
-        accountId: string;
+        accountId?: string;
         /**
          * Meta only.
          */
@@ -36261,6 +36261,10 @@ export type SearchAdLibraryData = {
          * Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
          */
         pageIds?: string;
+        /**
+         * Which archive to search. `meta` needs no accountId. Required unless accountId is given.
+         */
+        platform?: 'meta' | 'linkedin';
         /**
          * Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
          */