@zernio/node 0.2.966 → 0.2.968

package/dist/index.d.mts

@@ -8854,6 +8854,9 @@ type MetaPageOwnership = {
 type MetaPagePartner = {
     businessId?: string;
     name?: string;
+    /**
+     * Tasks the partner holds, in the bare spelling the grant takes (ADVERTISE, ANALYZE, MANAGE, ...). Meta reads them back with a PROFILE_PLUS_ prefix, which is stripped here; partners granted in Business Settings may hold tasks beyond the six the grant accepts, such as MANAGE_LEADS or REVENUE.
+     */
     permittedTasks?: Array<(string)>;
 };
 /**
@@ -18342,7 +18345,7 @@ type GetConnectUrlData = {
          */
         profileId: string;
         /**
-         * Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. Result params are appended with the URL API, so an existing query string is preserved. Standard mode appends connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
+         * Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. X (twitter) caps the OAuth `state` at 500 characters and the redirect is carried inside it, so the URL-encoded `redirect_url` must be at most 258 characters for API callers (310 for dashboard sessions; in headless mode the appended `headless=true` counts toward it); a longer one is rejected with 400 INVALID_REDIRECT_URL. Result params are appended with the URL API, so an existing query string is preserved. Standard mode appends connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
          *
          * On failure, the browser is sent to the same redirect_url with `error` and `platform` appended.
          * `error` and `platform` are always present. `error_message`, `is_user_fixable`, `reason`,
@@ -21914,6 +21917,19 @@ type GrantBusinessPartnerData = {
     };
 };
 type GrantBusinessPartnerResponse = ({
+    page?: MetaPageOwnership;
+    partner?: {
+        businessId?: string;
+        /**
+         * Tasks the partner currently holds.
+         */
+        permittedTasks?: Array<(string)>;
+    };
+    /**
+     * Always true on this response.
+     */
+    alreadyShared?: boolean;
+} | {
     page?: MetaPageOwnership;
     partner?: {
         businessId?: string;

package/dist/index.d.ts

@@ -8854,6 +8854,9 @@ type MetaPageOwnership = {
 type MetaPagePartner = {
     businessId?: string;
     name?: string;
+    /**
+     * Tasks the partner holds, in the bare spelling the grant takes (ADVERTISE, ANALYZE, MANAGE, ...). Meta reads them back with a PROFILE_PLUS_ prefix, which is stripped here; partners granted in Business Settings may hold tasks beyond the six the grant accepts, such as MANAGE_LEADS or REVENUE.
+     */
     permittedTasks?: Array<(string)>;
 };
 /**
@@ -18342,7 +18345,7 @@ type GetConnectUrlData = {
          */
         profileId: string;
         /**
-         * Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. Result params are appended with the URL API, so an existing query string is preserved. Standard mode appends connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
+         * Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. X (twitter) caps the OAuth `state` at 500 characters and the redirect is carried inside it, so the URL-encoded `redirect_url` must be at most 258 characters for API callers (310 for dashboard sessions; in headless mode the appended `headless=true` counts toward it); a longer one is rejected with 400 INVALID_REDIRECT_URL. Result params are appended with the URL API, so an existing query string is preserved. Standard mode appends connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
          *
          * On failure, the browser is sent to the same redirect_url with `error` and `platform` appended.
          * `error` and `platform` are always present. `error_message`, `is_user_fixable`, `reason`,
@@ -21914,6 +21917,19 @@ type GrantBusinessPartnerData = {
     };
 };
 type GrantBusinessPartnerResponse = ({
+    page?: MetaPageOwnership;
+    partner?: {
+        businessId?: string;
+        /**
+         * Tasks the partner currently holds.
+         */
+        permittedTasks?: Array<(string)>;
+    };
+    /**
+     * Always true on this response.
+     */
+    alreadyShared?: boolean;
+} | {
     page?: MetaPageOwnership;
     partner?: {
         businessId?: string;

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -2632,8 +2632,10 @@ export const listBusinessPartners = <ThrowOnError extends boolean = false>(optio
  *
  * Meta only lets a user token share a Page that a business portfolio owns. A Page
  * outside any portfolio must first be claimed into one at business.facebook.com; this
- * endpoint answers `422` until that is done. Granting to a portfolio that already has
- * access replaces its task set, so the call is safe to repeat.
+ * endpoint answers `422` until that is done. Meta refuses a second grant to a portfolio
+ * that already has access instead of replacing its tasks, so that case answers `200`
+ * with `alreadyShared: true` and the tasks the partner currently holds. To change a
+ * partner's tasks, revoke and grant again.
  *
  * After the grant, the partner assigns its own people to the Page with
  * `POST /v1/ads/page-users`; Meta does not assign partner admins automatically.

package/src/generated/types.gen.ts

@@ -7316,6 +7316,9 @@ export type MetaPageOwnership = {
 export type MetaPagePartner = {
     businessId?: string;
     name?: string;
+    /**
+     * Tasks the partner holds, in the bare spelling the grant takes (ADVERTISE, ANALYZE, MANAGE, ...). Meta reads them back with a PROFILE_PLUS_ prefix, which is stripped here; partners granted in Business Settings may hold tasks beyond the six the grant accepts, such as MANAGE_LEADS or REVENUE.
+     */
     permittedTasks?: Array<(string)>;
 };
 
@@ -17311,7 +17314,7 @@ export type GetConnectUrlData = {
          */
         profileId: string;
         /**
-         * Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. Result params are appended with the URL API, so an existing query string is preserved. Standard mode appends connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
+         * Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. X (twitter) caps the OAuth `state` at 500 characters and the redirect is carried inside it, so the URL-encoded `redirect_url` must be at most 258 characters for API callers (310 for dashboard sessions; in headless mode the appended `headless=true` counts toward it); a longer one is rejected with 400 INVALID_REDIRECT_URL. Result params are appended with the URL API, so an existing query string is preserved. Standard mode appends connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
          *
          * On failure, the browser is sent to the same redirect_url with `error` and `platform` appended.
          * `error` and `platform` are always present. `error_message`, `is_user_fixable`, `reason`,
@@ -21071,6 +21074,19 @@ export type GrantBusinessPartnerData = {
 };
 
 export type GrantBusinessPartnerResponse = ({
+    page?: MetaPageOwnership;
+    partner?: {
+        businessId?: string;
+        /**
+         * Tasks the partner currently holds.
+         */
+        permittedTasks?: Array<(string)>;
+    };
+    /**
+     * Always true on this response.
+     */
+    alreadyShared?: boolean;
+} | {
     page?: MetaPageOwnership;
     partner?: {
         businessId?: string;