@zernio/node 0.2.206 → 0.2.208

package/dist/index.d.mts

@@ -8198,6 +8198,11 @@ type SelectFacebookPageError = (unknown | {
 });
 type ListGoogleBusinessLocationsData = {
     query?: {
+        /**
+         * Raw Google Business Information API filter expression (advanced; takes precedence over search). Supports fields such as title, storeCode, storefront_address.postal_code, labels and categories, e.g. storeCode="LH279411". See Google's "Work with location data" guide.
+         *
+         */
+        filter?: string;
         /**
          * Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.
          */
@@ -8206,6 +8211,11 @@ type ListGoogleBusinessLocationsData = {
          * Profile ID from your connection flow. Required for auth validation when provided.
          */
         profileId?: string;
+        /**
+         * Free-text search on the business name, applied server-side by Google. Use this for accounts that own many locations (the response is bounded, see hasMore) so the user can find a specific location without loading the full list.
+         *
+         */
+        search?: string;
         /**
          * Legacy. Direct Google access token. Use pendingDataToken instead when available.
          */
@@ -8238,7 +8248,16 @@ type ListGoogleBusinessLocationsResponse = ({
          * Business category
          */
         category?: string;
+        /**
+         * Store code set on the location in Google Business Profile (if any)
+         */
+        storeCode?: string;
     }>;
+    /**
+     * True when more locations exist than were returned (the list is bounded). Prompt the user to narrow the result set with search.
+     *
+     */
+    hasMore?: boolean;
 });
 type ListGoogleBusinessLocationsError = (unknown | {
     error?: string;
@@ -8253,6 +8272,11 @@ type SelectGoogleBusinessLocationData = {
          * The Google Business location ID selected by the user
          */
         locationId: string;
+        /**
+         * Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the selected location (returned per-location by GET /v1/connect/googlebusiness/locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts that own many locations. Omit only for small accounts.
+         *
+         */
+        accountId?: string;
         /**
          * Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.
          */
@@ -10462,6 +10486,16 @@ type GetGmbLocationsData = {
     path: {
         accountId: string;
     };
+    query?: {
+        /**
+         * Raw Google Business Information API filter expression (advanced; takes precedence over search), e.g. storeCode="LH279411".
+         */
+        filter?: string;
+        /**
+         * Free-text search on the business name, applied server-side by Google. Use for accounts with many locations.
+         */
+        search?: string;
+    };
 };
 type GetGmbLocationsResponse = ({
     locations?: Array<{
@@ -10472,7 +10506,12 @@ type GetGmbLocationsResponse = ({
         address?: string;
         category?: string;
         websiteUrl?: string;
+        storeCode?: string;
     }>;
+    /**
+     * True when more locations exist than were returned (use search to narrow down).
+     */
+    hasMore?: boolean;
     selectedLocationId?: string;
     cached?: boolean;
 });
@@ -10482,6 +10521,11 @@ type GetGmbLocationsError = ({
 type UpdateGmbLocationData = {
     body: {
         selectedLocationId: string;
+        /**
+         * Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the new location (from GET gmb-locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts with many locations.
+         *
+         */
+        accountId?: string;
     };
     path: {
         accountId: string;
@@ -18044,36 +18088,53 @@ type CreateStandaloneAdData = {
             adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
         };
         /**
-         * Meta only. Placement asset customization: pin a SPECIFIC image to each placement
-         * group on a SINGLE ad (e.g. a 9:16 image on Stories/Reels and a 4:5 on Feed). This
-         * is the same thing Meta Ads Manager produces with "different creative per placement",
-         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. It is
-         * deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (the two are
-         * mutually exclusive, and it cannot be combined with `creatives[]` or `adSetId`). The
-         * shared copy (headline, body, link, CTA) comes from the top-level single-creative
-         * fields (`headline`, `body`, `linkUrl`, `callToAction`) since only the image varies by
+         * Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to
+         * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
+         * The same thing Meta Ads Manager produces with "different creative per placement",
+         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic
+         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive, and it
+         * cannot be combined with `creatives[]` or `adSetId`). Shared copy (headline, body, link,
+         * CTA) comes from the top-level single-creative fields since only the asset varies by
          * placement. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.
          *
+         * A block is all-image OR all-video, never mixed (Meta's asset_feed_spec carries one ad
+         * format). Image mode: `defaultImageUrl` + `rules[].imageUrl`. Video mode:
+         * `defaultVideoUrl` + `rules[].videoUrl` (optional `thumbnailUrl`/`defaultThumbnailUrl`
+         * posters; Meta auto-generates when omitted). Exactly one catch-all default is required.
+         *
          */
         placementAssets?: {
             /**
-             * Catch-all image for any placement not matched by a rule. REQUIRED — Meta mandates
-             * a default asset customization rule (empty placement spec, lowest priority) on every
-             * placement-customized creative.
-             *
+             * Image mode. Catch-all image for any placement no rule matches. Required in image mode (Meta mandates a default rule).
+             */
+            defaultImageUrl?: string;
+            /**
+             * Video mode. Catch-all video for any placement no rule matches. Required in video mode.
+             */
+            defaultVideoUrl?: string;
+            /**
+             * Video mode (optional). Poster image for the default video; Meta auto-generates one when omitted.
              */
-            defaultImageUrl: string;
+            defaultThumbnailUrl?: string;
             /**
-             * One entry per placement group you want to pin a specific image to.
+             * One entry per placement group you want to pin a specific asset to.
              */
             rules: Array<{
                 /**
-                 * The image to deliver for this rule's placements.
+                 * Image mode. The image to deliver for this rule's placements.
+                 */
+                imageUrl?: string;
+                /**
+                 * Video mode. The video to deliver for this rule's placements.
+                 */
+                videoUrl?: string;
+                /**
+                 * Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
                  */
-                imageUrl: string;
+                thumbnailUrl?: string;
                 /**
-                 * Placements this image is pinned to. At least one field must be set (an empty rule is invalid — that role is served by defaultImageUrl). Same enums as the top-level `placements` object.
+                 * Placements this asset is pinned to. At least one field must be set (an empty rule is invalid — that role is served by the default asset). Same enums as the top-level `placements` object.
                  */
                 placements: {
                     publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;

package/dist/index.d.ts

@@ -8198,6 +8198,11 @@ type SelectFacebookPageError = (unknown | {
 });
 type ListGoogleBusinessLocationsData = {
     query?: {
+        /**
+         * Raw Google Business Information API filter expression (advanced; takes precedence over search). Supports fields such as title, storeCode, storefront_address.postal_code, labels and categories, e.g. storeCode="LH279411". See Google's "Work with location data" guide.
+         *
+         */
+        filter?: string;
         /**
          * Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.
          */
@@ -8206,6 +8211,11 @@ type ListGoogleBusinessLocationsData = {
          * Profile ID from your connection flow. Required for auth validation when provided.
          */
         profileId?: string;
+        /**
+         * Free-text search on the business name, applied server-side by Google. Use this for accounts that own many locations (the response is bounded, see hasMore) so the user can find a specific location without loading the full list.
+         *
+         */
+        search?: string;
         /**
          * Legacy. Direct Google access token. Use pendingDataToken instead when available.
          */
@@ -8238,7 +8248,16 @@ type ListGoogleBusinessLocationsResponse = ({
          * Business category
          */
         category?: string;
+        /**
+         * Store code set on the location in Google Business Profile (if any)
+         */
+        storeCode?: string;
     }>;
+    /**
+     * True when more locations exist than were returned (the list is bounded). Prompt the user to narrow the result set with search.
+     *
+     */
+    hasMore?: boolean;
 });
 type ListGoogleBusinessLocationsError = (unknown | {
     error?: string;
@@ -8253,6 +8272,11 @@ type SelectGoogleBusinessLocationData = {
          * The Google Business location ID selected by the user
          */
         locationId: string;
+        /**
+         * Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the selected location (returned per-location by GET /v1/connect/googlebusiness/locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts that own many locations. Omit only for small accounts.
+         *
+         */
+        accountId?: string;
         /**
          * Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.
          */
@@ -10462,6 +10486,16 @@ type GetGmbLocationsData = {
     path: {
         accountId: string;
     };
+    query?: {
+        /**
+         * Raw Google Business Information API filter expression (advanced; takes precedence over search), e.g. storeCode="LH279411".
+         */
+        filter?: string;
+        /**
+         * Free-text search on the business name, applied server-side by Google. Use for accounts with many locations.
+         */
+        search?: string;
+    };
 };
 type GetGmbLocationsResponse = ({
     locations?: Array<{
@@ -10472,7 +10506,12 @@ type GetGmbLocationsResponse = ({
         address?: string;
         category?: string;
         websiteUrl?: string;
+        storeCode?: string;
     }>;
+    /**
+     * True when more locations exist than were returned (use search to narrow down).
+     */
+    hasMore?: boolean;
     selectedLocationId?: string;
     cached?: boolean;
 });
@@ -10482,6 +10521,11 @@ type GetGmbLocationsError = ({
 type UpdateGmbLocationData = {
     body: {
         selectedLocationId: string;
+        /**
+         * Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the new location (from GET gmb-locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts with many locations.
+         *
+         */
+        accountId?: string;
     };
     path: {
         accountId: string;
@@ -18044,36 +18088,53 @@ type CreateStandaloneAdData = {
             adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
         };
         /**
-         * Meta only. Placement asset customization: pin a SPECIFIC image to each placement
-         * group on a SINGLE ad (e.g. a 9:16 image on Stories/Reels and a 4:5 on Feed). This
-         * is the same thing Meta Ads Manager produces with "different creative per placement",
-         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. It is
-         * deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (the two are
-         * mutually exclusive, and it cannot be combined with `creatives[]` or `adSetId`). The
-         * shared copy (headline, body, link, CTA) comes from the top-level single-creative
-         * fields (`headline`, `body`, `linkUrl`, `callToAction`) since only the image varies by
+         * Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to
+         * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
+         * The same thing Meta Ads Manager produces with "different creative per placement",
+         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic
+         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive, and it
+         * cannot be combined with `creatives[]` or `adSetId`). Shared copy (headline, body, link,
+         * CTA) comes from the top-level single-creative fields since only the asset varies by
          * placement. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.
          *
+         * A block is all-image OR all-video, never mixed (Meta's asset_feed_spec carries one ad
+         * format). Image mode: `defaultImageUrl` + `rules[].imageUrl`. Video mode:
+         * `defaultVideoUrl` + `rules[].videoUrl` (optional `thumbnailUrl`/`defaultThumbnailUrl`
+         * posters; Meta auto-generates when omitted). Exactly one catch-all default is required.
+         *
          */
         placementAssets?: {
             /**
-             * Catch-all image for any placement not matched by a rule. REQUIRED — Meta mandates
-             * a default asset customization rule (empty placement spec, lowest priority) on every
-             * placement-customized creative.
-             *
+             * Image mode. Catch-all image for any placement no rule matches. Required in image mode (Meta mandates a default rule).
+             */
+            defaultImageUrl?: string;
+            /**
+             * Video mode. Catch-all video for any placement no rule matches. Required in video mode.
+             */
+            defaultVideoUrl?: string;
+            /**
+             * Video mode (optional). Poster image for the default video; Meta auto-generates one when omitted.
              */
-            defaultImageUrl: string;
+            defaultThumbnailUrl?: string;
             /**
-             * One entry per placement group you want to pin a specific image to.
+             * One entry per placement group you want to pin a specific asset to.
              */
             rules: Array<{
                 /**
-                 * The image to deliver for this rule's placements.
+                 * Image mode. The image to deliver for this rule's placements.
+                 */
+                imageUrl?: string;
+                /**
+                 * Video mode. The video to deliver for this rule's placements.
+                 */
+                videoUrl?: string;
+                /**
+                 * Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
                  */
-                imageUrl: string;
+                thumbnailUrl?: string;
                 /**
-                 * Placements this image is pinned to. At least one field must be set (an empty rule is invalid — that role is served by defaultImageUrl). Same enums as the top-level `placements` object.
+                 * Placements this asset is pinned to. At least one field must be set (an empty rule is invalid — that role is served by the default asset). Same enums as the top-level `placements` object.
                  */
                 placements: {
                     publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -1672,7 +1672,8 @@ export const updateYoutubeDefaultPlaylist = <ThrowOnError extends boolean = fals
 
 /**
  * List GBP locations
- * Returns all Google Business Profile locations the connected account has access to, including the currently selected location.
+ * Returns Google Business Profile locations the connected account can access, plus the currently selected location. The list is bounded (see hasMore); for accounts that own many locations, use the search or filter query params to find a specific one instead of loading them all.
+ *
  */
 export const getGmbLocations = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetGmbLocationsData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetGmbLocationsResponse, GetGmbLocationsError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -7892,6 +7892,11 @@ export type SelectFacebookPageError = (unknown | {
 
 export type ListGoogleBusinessLocationsData = {
     query?: {
+        /**
+         * Raw Google Business Information API filter expression (advanced; takes precedence over search). Supports fields such as title, storeCode, storefront_address.postal_code, labels and categories, e.g. storeCode="LH279411". See Google's "Work with location data" guide.
+         *
+         */
+        filter?: string;
         /**
          * Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.
          */
@@ -7900,6 +7905,11 @@ export type ListGoogleBusinessLocationsData = {
          * Profile ID from your connection flow. Required for auth validation when provided.
          */
         profileId?: string;
+        /**
+         * Free-text search on the business name, applied server-side by Google. Use this for accounts that own many locations (the response is bounded, see hasMore) so the user can find a specific location without loading the full list.
+         *
+         */
+        search?: string;
         /**
          * Legacy. Direct Google access token. Use pendingDataToken instead when available.
          */
@@ -7933,7 +7943,16 @@ export type ListGoogleBusinessLocationsResponse = ({
          * Business category
          */
         category?: string;
+        /**
+         * Store code set on the location in Google Business Profile (if any)
+         */
+        storeCode?: string;
     }>;
+    /**
+     * True when more locations exist than were returned (the list is bounded). Prompt the user to narrow the result set with search.
+     *
+     */
+    hasMore?: boolean;
 });
 
 export type ListGoogleBusinessLocationsError = (unknown | {
@@ -7950,6 +7969,11 @@ export type SelectGoogleBusinessLocationData = {
          * The Google Business location ID selected by the user
          */
         locationId: string;
+        /**
+         * Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the selected location (returned per-location by GET /v1/connect/googlebusiness/locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts that own many locations. Omit only for small accounts.
+         *
+         */
+        accountId?: string;
         /**
          * Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.
          */
@@ -10315,6 +10339,16 @@ export type GetGmbLocationsData = {
     path: {
         accountId: string;
     };
+    query?: {
+        /**
+         * Raw Google Business Information API filter expression (advanced; takes precedence over search), e.g. storeCode="LH279411".
+         */
+        filter?: string;
+        /**
+         * Free-text search on the business name, applied server-side by Google. Use for accounts with many locations.
+         */
+        search?: string;
+    };
 };
 
 export type GetGmbLocationsResponse = ({
@@ -10326,7 +10360,12 @@ export type GetGmbLocationsResponse = ({
         address?: string;
         category?: string;
         websiteUrl?: string;
+        storeCode?: string;
     }>;
+    /**
+     * True when more locations exist than were returned (use search to narrow down).
+     */
+    hasMore?: boolean;
     selectedLocationId?: string;
     cached?: boolean;
 });
@@ -10338,6 +10377,11 @@ export type GetGmbLocationsError = ({
 export type UpdateGmbLocationData = {
     body: {
         selectedLocationId: string;
+        /**
+         * Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the new location (from GET gmb-locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts with many locations.
+         *
+         */
+        accountId?: string;
     };
     path: {
         accountId: string;
@@ -18509,36 +18553,53 @@ export type CreateStandaloneAdData = {
             adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
         };
         /**
-         * Meta only. Placement asset customization: pin a SPECIFIC image to each placement
-         * group on a SINGLE ad (e.g. a 9:16 image on Stories/Reels and a 4:5 on Feed). This
-         * is the same thing Meta Ads Manager produces with "different creative per placement",
-         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. It is
-         * deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (the two are
-         * mutually exclusive, and it cannot be combined with `creatives[]` or `adSetId`). The
-         * shared copy (headline, body, link, CTA) comes from the top-level single-creative
-         * fields (`headline`, `body`, `linkUrl`, `callToAction`) since only the image varies by
+         * Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to
+         * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
+         * The same thing Meta Ads Manager produces with "different creative per placement",
+         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic
+         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive, and it
+         * cannot be combined with `creatives[]` or `adSetId`). Shared copy (headline, body, link,
+         * CTA) comes from the top-level single-creative fields since only the asset varies by
          * placement. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.
          *
+         * A block is all-image OR all-video, never mixed (Meta's asset_feed_spec carries one ad
+         * format). Image mode: `defaultImageUrl` + `rules[].imageUrl`. Video mode:
+         * `defaultVideoUrl` + `rules[].videoUrl` (optional `thumbnailUrl`/`defaultThumbnailUrl`
+         * posters; Meta auto-generates when omitted). Exactly one catch-all default is required.
+         *
          */
         placementAssets?: {
             /**
-             * Catch-all image for any placement not matched by a rule. REQUIRED — Meta mandates
-             * a default asset customization rule (empty placement spec, lowest priority) on every
-             * placement-customized creative.
-             *
+             * Image mode. Catch-all image for any placement no rule matches. Required in image mode (Meta mandates a default rule).
+             */
+            defaultImageUrl?: string;
+            /**
+             * Video mode. Catch-all video for any placement no rule matches. Required in video mode.
+             */
+            defaultVideoUrl?: string;
+            /**
+             * Video mode (optional). Poster image for the default video; Meta auto-generates one when omitted.
              */
-            defaultImageUrl: string;
+            defaultThumbnailUrl?: string;
             /**
-             * One entry per placement group you want to pin a specific image to.
+             * One entry per placement group you want to pin a specific asset to.
              */
             rules: Array<{
                 /**
-                 * The image to deliver for this rule's placements.
+                 * Image mode. The image to deliver for this rule's placements.
+                 */
+                imageUrl?: string;
+                /**
+                 * Video mode. The video to deliver for this rule's placements.
+                 */
+                videoUrl?: string;
+                /**
+                 * Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
                  */
-                imageUrl: string;
+                thumbnailUrl?: string;
                 /**
-                 * Placements this image is pinned to. At least one field must be set (an empty rule is invalid — that role is served by defaultImageUrl). Same enums as the top-level `placements` object.
+                 * Placements this asset is pinned to. At least one field must be set (an empty rule is invalid — that role is served by the default asset). Same enums as the top-level `placements` object.
                  */
                 placements: {
                     publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;