@zernio/node 0.2.43 → 0.2.45

package/dist/index.d.mts

@@ -198,7 +198,7 @@ declare class Zernio {
             selectFacebookPage: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<SelectFacebookPageData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SelectFacebookPageResponse, unknown, ThrowOnError>;
         };
         googleBusiness: {
-            listGoogleBusinessLocations: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ListGoogleBusinessLocationsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListGoogleBusinessLocationsResponse, unknown, ThrowOnError>;
+            listGoogleBusinessLocations: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<ListGoogleBusinessLocationsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListGoogleBusinessLocationsResponse, unknown, ThrowOnError>;
             selectGoogleBusinessLocation: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<SelectGoogleBusinessLocationData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SelectGoogleBusinessLocationResponse, unknown, ThrowOnError>;
         };
         linkedin: {
@@ -996,7 +996,8 @@ type permission = 'read-write' | 'read';
  */
 type BlueskyPlatformData = {
     /**
-     * Sequence of posts in a Bluesky thread (root then replies in order).
+     * Complete sequence of posts in a Bluesky thread. The first item becomes the root post, subsequent items are chained as replies. When threadItems is provided, the top-level content field is used only for display and search purposes, it is NOT published. You must include your first post as threadItems[0].
+     *
      */
     threadItems?: Array<{
         content?: string;
@@ -2165,7 +2166,8 @@ type ThreadsPlatformData = {
      */
     topic_tag?: string;
     /**
-     * Sequence of posts in a Threads thread (root then replies in order).
+     * Complete sequence of posts in a Threads thread. The first item becomes the root post, subsequent items are chained as replies. When threadItems is provided, the top-level content field is used only for display and search purposes, it is NOT published. You must include your first post as threadItems[0].
+     *
      */
     threadItems?: Array<{
         content?: string;
@@ -2263,7 +2265,8 @@ type TwitterPlatformData = {
      */
     replySettings?: 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
     /**
-     * Sequence of tweets in a thread. First item is the root tweet.
+     * Complete sequence of tweets in a thread. The first item becomes the root tweet, subsequent items are chained as replies. When threadItems is provided, the top-level content field is used only for display and search purposes, it is NOT published. You must include your first tweet as threadItems[0].
+     *
      */
     threadItems?: Array<{
         content?: string;
@@ -4699,15 +4702,19 @@ type SelectFacebookPageError = (unknown | {
     error?: string;
 });
 type ListGoogleBusinessLocationsData = {
-    query: {
+    query?: {
         /**
-         * Profile ID from your connection flow
+         * Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.
          */
-        profileId: string;
+        pendingDataToken?: string;
         /**
-         * Temporary Google access token from the OAuth callback redirect
+         * Profile ID from your connection flow. Required for auth validation when provided.
          */
-        tempToken: string;
+        profileId?: string;
+        /**
+         * Legacy. Direct Google access token. Use pendingDataToken instead when available.
+         */
+        tempToken?: string;
     };
 };
 type ListGoogleBusinessLocationsResponse = ({
@@ -4752,28 +4759,9 @@ type SelectGoogleBusinessLocationData = {
          */
         locationId: string;
         /**
-         * Temporary Google access token from OAuth
+         * Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.
          */
-        tempToken: string;
-        /**
-         * Decoded user profile from the OAuth callback. Contains the refresh token. Always include this field.
-         */
-        userProfile?: {
-            id?: string;
-            name?: string;
-            /**
-             * Google refresh token for long-lived access
-             */
-            refreshToken?: string;
-            /**
-             * Token expiration time in seconds
-             */
-            tokenExpiresIn?: number;
-            /**
-             * Granted OAuth scopes
-             */
-            scope?: string;
-        };
+        pendingDataToken: string;
         /**
          * Optional custom redirect URL to return to after selection
          */

package/dist/index.d.ts

@@ -198,7 +198,7 @@ declare class Zernio {
             selectFacebookPage: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<SelectFacebookPageData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SelectFacebookPageResponse, unknown, ThrowOnError>;
         };
         googleBusiness: {
-            listGoogleBusinessLocations: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ListGoogleBusinessLocationsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListGoogleBusinessLocationsResponse, unknown, ThrowOnError>;
+            listGoogleBusinessLocations: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<ListGoogleBusinessLocationsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListGoogleBusinessLocationsResponse, unknown, ThrowOnError>;
             selectGoogleBusinessLocation: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<SelectGoogleBusinessLocationData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SelectGoogleBusinessLocationResponse, unknown, ThrowOnError>;
         };
         linkedin: {
@@ -996,7 +996,8 @@ type permission = 'read-write' | 'read';
  */
 type BlueskyPlatformData = {
     /**
-     * Sequence of posts in a Bluesky thread (root then replies in order).
+     * Complete sequence of posts in a Bluesky thread. The first item becomes the root post, subsequent items are chained as replies. When threadItems is provided, the top-level content field is used only for display and search purposes, it is NOT published. You must include your first post as threadItems[0].
+     *
      */
     threadItems?: Array<{
         content?: string;
@@ -2165,7 +2166,8 @@ type ThreadsPlatformData = {
      */
     topic_tag?: string;
     /**
-     * Sequence of posts in a Threads thread (root then replies in order).
+     * Complete sequence of posts in a Threads thread. The first item becomes the root post, subsequent items are chained as replies. When threadItems is provided, the top-level content field is used only for display and search purposes, it is NOT published. You must include your first post as threadItems[0].
+     *
      */
     threadItems?: Array<{
         content?: string;
@@ -2263,7 +2265,8 @@ type TwitterPlatformData = {
      */
     replySettings?: 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
     /**
-     * Sequence of tweets in a thread. First item is the root tweet.
+     * Complete sequence of tweets in a thread. The first item becomes the root tweet, subsequent items are chained as replies. When threadItems is provided, the top-level content field is used only for display and search purposes, it is NOT published. You must include your first tweet as threadItems[0].
+     *
      */
     threadItems?: Array<{
         content?: string;
@@ -4699,15 +4702,19 @@ type SelectFacebookPageError = (unknown | {
     error?: string;
 });
 type ListGoogleBusinessLocationsData = {
-    query: {
+    query?: {
         /**
-         * Profile ID from your connection flow
+         * Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.
          */
-        profileId: string;
+        pendingDataToken?: string;
         /**
-         * Temporary Google access token from the OAuth callback redirect
+         * Profile ID from your connection flow. Required for auth validation when provided.
          */
-        tempToken: string;
+        profileId?: string;
+        /**
+         * Legacy. Direct Google access token. Use pendingDataToken instead when available.
+         */
+        tempToken?: string;
     };
 };
 type ListGoogleBusinessLocationsResponse = ({
@@ -4752,28 +4759,9 @@ type SelectGoogleBusinessLocationData = {
          */
         locationId: string;
         /**
-         * Temporary Google access token from OAuth
+         * Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.
          */
-        tempToken: string;
-        /**
-         * Decoded user profile from the OAuth callback. Contains the refresh token. Always include this field.
-         */
-        userProfile?: {
-            id?: string;
-            name?: string;
-            /**
-             * Google refresh token for long-lived access
-             */
-            refreshToken?: string;
-            /**
-             * Token expiration time in seconds
-             */
-            tokenExpiresIn?: number;
-            /**
-             * Granted OAuth scopes
-             */
-            scope?: string;
-        };
+        pendingDataToken: string;
         /**
          * Optional custom redirect URL to return to after selection
          */

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -719,9 +719,10 @@ export const selectFacebookPage = <ThrowOnError extends boolean = false>(options
 
 /**
  * List GBP locations
- * For headless flows. Returns the list of GBP locations the user can manage. Use X-Connect-Token if connecting via API key.
+ * For headless flows. Returns the list of GBP locations the user can manage. Use pendingDataToken (from the OAuth callback redirect) to list locations without consuming the token, so it remains available for select-location. Use X-Connect-Token header if connecting via API key.
+ *
  */
-export const listGoogleBusinessLocations = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListGoogleBusinessLocationsData, ThrowOnError>) => {
+export const listGoogleBusinessLocations = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<ListGoogleBusinessLocationsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListGoogleBusinessLocationsResponse, ListGoogleBusinessLocationsError, ThrowOnError>({
         ...options,
         url: '/v1/connect/googlebusiness/locations'
@@ -730,7 +731,8 @@ export const listGoogleBusinessLocations = <ThrowOnError extends boolean = false
 
 /**
  * Select GBP location
- * Complete the headless flow by saving the user's selected GBP location. Include userProfile from the OAuth redirect (contains refresh token). Use X-Connect-Token if connecting via API key.
+ * Complete the headless GBP flow by saving the user's selected location. The pendingDataToken is returned in your redirect URL after OAuth completes (step=select_location). Tokens and profile data are stored server-side, so only the pendingDataToken is needed here. Use X-Connect-Token header if connecting via API key.
+ *
  */
 export const selectGoogleBusinessLocation = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<SelectGoogleBusinessLocationData, ThrowOnError>) => {
     return (options?.client ?? client).post<SelectGoogleBusinessLocationResponse, SelectGoogleBusinessLocationError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -421,7 +421,8 @@ export type permission = 'read-write' | 'read';
  */
 export type BlueskyPlatformData = {
     /**
-     * Sequence of posts in a Bluesky thread (root then replies in order).
+     * Complete sequence of posts in a Bluesky thread. The first item becomes the root post, subsequent items are chained as replies. When threadItems is provided, the top-level content field is used only for display and search purposes, it is NOT published. You must include your first post as threadItems[0].
+     *
      */
     threadItems?: Array<{
         content?: string;
@@ -1670,7 +1671,8 @@ export type ThreadsPlatformData = {
      */
     topic_tag?: string;
     /**
-     * Sequence of posts in a Threads thread (root then replies in order).
+     * Complete sequence of posts in a Threads thread. The first item becomes the root post, subsequent items are chained as replies. When threadItems is provided, the top-level content field is used only for display and search purposes, it is NOT published. You must include your first post as threadItems[0].
+     *
      */
     threadItems?: Array<{
         content?: string;
@@ -1772,7 +1774,8 @@ export type TwitterPlatformData = {
      */
     replySettings?: 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
     /**
-     * Sequence of tweets in a thread. First item is the root tweet.
+     * Complete sequence of tweets in a thread. The first item becomes the root tweet, subsequent items are chained as replies. When threadItems is provided, the top-level content field is used only for display and search purposes, it is NOT published. You must include your first tweet as threadItems[0].
+     *
      */
     threadItems?: Array<{
         content?: string;
@@ -4418,15 +4421,19 @@ export type SelectFacebookPageError = (unknown | {
 });
 
 export type ListGoogleBusinessLocationsData = {
-    query: {
+    query?: {
         /**
-         * Profile ID from your connection flow
+         * Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.
          */
-        profileId: string;
+        pendingDataToken?: string;
         /**
-         * Temporary Google access token from the OAuth callback redirect
+         * Profile ID from your connection flow. Required for auth validation when provided.
          */
-        tempToken: string;
+        profileId?: string;
+        /**
+         * Legacy. Direct Google access token. Use pendingDataToken instead when available.
+         */
+        tempToken?: string;
     };
 };
 
@@ -4474,28 +4481,9 @@ export type SelectGoogleBusinessLocationData = {
          */
         locationId: string;
         /**
-         * Temporary Google access token from OAuth
+         * Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.
          */
-        tempToken: string;
-        /**
-         * Decoded user profile from the OAuth callback. Contains the refresh token. Always include this field.
-         */
-        userProfile?: {
-            id?: string;
-            name?: string;
-            /**
-             * Google refresh token for long-lived access
-             */
-            refreshToken?: string;
-            /**
-             * Token expiration time in seconds
-             */
-            tokenExpiresIn?: number;
-            /**
-             * Granted OAuth scopes
-             */
-            scope?: string;
-        };
+        pendingDataToken: string;
         /**
          * Optional custom redirect URL to return to after selection
          */