@zernio/node 0.2.42 → 0.2.44

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: {
@@ -4699,15 +4699,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 +4756,9 @@ type SelectGoogleBusinessLocationData = {
          */
         locationId: string;
         /**
-         * Temporary Google access token from OAuth
-         */
-        tempToken: string;
-        /**
-         * Decoded user profile from the OAuth callback. Contains the refresh token. Always include this field.
+         * Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.
          */
-        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: {
@@ -4699,15 +4699,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 +4756,9 @@ type SelectGoogleBusinessLocationData = {
          */
         locationId: string;
         /**
-         * Temporary Google access token from OAuth
-         */
-        tempToken: string;
-        /**
-         * Decoded user profile from the OAuth callback. Contains the refresh token. Always include this field.
+         * Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.
          */
-        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.42",
+  "version": "0.2.44",
   "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>({
@@ -1145,9 +1147,10 @@ export const updateLinkedInOrganization = <ThrowOnError extends boolean = false>
  * **Important:** The `mentions` array field in POST /v1/posts is stored for reference only and does NOT trigger @mentions on LinkedIn. You must embed the mention format directly in the content text.
  *
  * **Requirements:**
- * - Person mentions require the LinkedIn account to be admin of at least one organization.
- * - Organization mentions (e.g. @Microsoft) work without this requirement.
+ * - **Person mentions** require the LinkedIn account to be admin of at least one organization. This is a LinkedIn API limitation: the only endpoints that resolve profile URLs to member URNs (`vanityUrl`, `peopleTypeahead`) are scoped to organization followers. There is no public LinkedIn API to resolve a vanity URL without organization context.
+ * - **Organization mentions** (e.g. @Microsoft) work without this requirement.
  * - For person mentions to be clickable, the `displayName` parameter must exactly match the name shown on their LinkedIn profile.
+ * - Person mentions DO work when published from personal profiles (the URN just needs to be valid). The limitation is only in the resolution step (URL to URN), not in publishing.
  *
  */
 export const getLinkedInMentions = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetLinkedInMentionsData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -4418,15 +4418,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 +4478,9 @@ export type SelectGoogleBusinessLocationData = {
          */
         locationId: string;
         /**
-         * Temporary Google access token from OAuth
-         */
-        tempToken: string;
-        /**
-         * Decoded user profile from the OAuth callback. Contains the refresh token. Always include this field.
+         * Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.
          */
-        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
          */