@zernio/node 0.2.967 → 0.2.969

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)>;
 };
 /**
@@ -21902,9 +21905,9 @@ type GrantBusinessPartnerData = {
          */
         businessId: string;
         /**
-         * Tasks granted on the Page. Defaults to ADVERTISE and ANALYZE.
+         * Tasks granted on the Page, Meta's permitted_tasks vocabulary. Defaults to ADVERTISE and ANALYZE. The bare names are what Business Settings shows; the PROFILE_PLUS_ names are the New Pages Experience tasks and the only way to grant FACEBOOK_ACCESS or REVENUE. Granting MANAGE also yields MANAGE_LEADS.
          */
-        permittedTasks?: Array<('MANAGE' | 'CREATE_CONTENT' | 'MODERATE' | 'MESSAGING' | 'ADVERTISE' | 'ANALYZE')>;
+        permittedTasks?: Array<('MANAGE' | 'CREATE_CONTENT' | 'MODERATE' | 'MESSAGING' | 'ADVERTISE' | 'ANALYZE' | 'MODERATE_COMMUNITY' | 'MANAGE_JOBS' | 'PAGES_MESSAGING' | 'PAGES_MESSAGING_SUBSCRIPTIONS' | 'READ_PAGE_MAILBOXES' | 'VIEW_MONETIZATION_INSIGHTS' | 'MANAGE_LEADS' | 'CASHIER_ROLE' | 'GLOBAL_STRUCTURE_MANAGEMENT' | 'PROFILE_PLUS_FULL_CONTROL' | 'PROFILE_PLUS_MANAGE' | 'PROFILE_PLUS_FACEBOOK_ACCESS' | 'PROFILE_PLUS_CREATE_CONTENT' | 'PROFILE_PLUS_MODERATE' | 'PROFILE_PLUS_MODERATE_DELEGATE_COMMUNITY' | 'PROFILE_PLUS_MESSAGING' | 'PROFILE_PLUS_ADVERTISE' | 'PROFILE_PLUS_ANALYZE' | 'PROFILE_PLUS_REVENUE' | 'PROFILE_PLUS_MANAGE_LEADS' | 'PROFILE_PLUS_CREATIVE_MANAGEMENT' | 'PROFILE_PLUS_CREATOR_MANAGEMENT' | 'PROFILE_PLUS_GLOBAL_STRUCTURE_MANAGEMENT')>;
     };
     path: {
         /**
@@ -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)>;
 };
 /**
@@ -21902,9 +21905,9 @@ type GrantBusinessPartnerData = {
          */
         businessId: string;
         /**
-         * Tasks granted on the Page. Defaults to ADVERTISE and ANALYZE.
+         * Tasks granted on the Page, Meta's permitted_tasks vocabulary. Defaults to ADVERTISE and ANALYZE. The bare names are what Business Settings shows; the PROFILE_PLUS_ names are the New Pages Experience tasks and the only way to grant FACEBOOK_ACCESS or REVENUE. Granting MANAGE also yields MANAGE_LEADS.
          */
-        permittedTasks?: Array<('MANAGE' | 'CREATE_CONTENT' | 'MODERATE' | 'MESSAGING' | 'ADVERTISE' | 'ANALYZE')>;
+        permittedTasks?: Array<('MANAGE' | 'CREATE_CONTENT' | 'MODERATE' | 'MESSAGING' | 'ADVERTISE' | 'ANALYZE' | 'MODERATE_COMMUNITY' | 'MANAGE_JOBS' | 'PAGES_MESSAGING' | 'PAGES_MESSAGING_SUBSCRIPTIONS' | 'READ_PAGE_MAILBOXES' | 'VIEW_MONETIZATION_INSIGHTS' | 'MANAGE_LEADS' | 'CASHIER_ROLE' | 'GLOBAL_STRUCTURE_MANAGEMENT' | 'PROFILE_PLUS_FULL_CONTROL' | 'PROFILE_PLUS_MANAGE' | 'PROFILE_PLUS_FACEBOOK_ACCESS' | 'PROFILE_PLUS_CREATE_CONTENT' | 'PROFILE_PLUS_MODERATE' | 'PROFILE_PLUS_MODERATE_DELEGATE_COMMUNITY' | 'PROFILE_PLUS_MESSAGING' | 'PROFILE_PLUS_ADVERTISE' | 'PROFILE_PLUS_ANALYZE' | 'PROFILE_PLUS_REVENUE' | 'PROFILE_PLUS_MANAGE_LEADS' | 'PROFILE_PLUS_CREATIVE_MANAGEMENT' | 'PROFILE_PLUS_CREATOR_MANAGEMENT' | 'PROFILE_PLUS_GLOBAL_STRUCTURE_MANAGEMENT')>;
     };
     path: {
         /**
@@ -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.967",
+  version: "0.2.969",
   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.967",
+  version: "0.2.969",
   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.967",
+  "version": "0.2.969",
   "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)>;
 };
 
@@ -21058,9 +21061,9 @@ export type GrantBusinessPartnerData = {
          */
         businessId: string;
         /**
-         * Tasks granted on the Page. Defaults to ADVERTISE and ANALYZE.
+         * Tasks granted on the Page, Meta's permitted_tasks vocabulary. Defaults to ADVERTISE and ANALYZE. The bare names are what Business Settings shows; the PROFILE_PLUS_ names are the New Pages Experience tasks and the only way to grant FACEBOOK_ACCESS or REVENUE. Granting MANAGE also yields MANAGE_LEADS.
          */
-        permittedTasks?: Array<('MANAGE' | 'CREATE_CONTENT' | 'MODERATE' | 'MESSAGING' | 'ADVERTISE' | 'ANALYZE')>;
+        permittedTasks?: Array<('MANAGE' | 'CREATE_CONTENT' | 'MODERATE' | 'MESSAGING' | 'ADVERTISE' | 'ANALYZE' | 'MODERATE_COMMUNITY' | 'MANAGE_JOBS' | 'PAGES_MESSAGING' | 'PAGES_MESSAGING_SUBSCRIPTIONS' | 'READ_PAGE_MAILBOXES' | 'VIEW_MONETIZATION_INSIGHTS' | 'MANAGE_LEADS' | 'CASHIER_ROLE' | 'GLOBAL_STRUCTURE_MANAGEMENT' | 'PROFILE_PLUS_FULL_CONTROL' | 'PROFILE_PLUS_MANAGE' | 'PROFILE_PLUS_FACEBOOK_ACCESS' | 'PROFILE_PLUS_CREATE_CONTENT' | 'PROFILE_PLUS_MODERATE' | 'PROFILE_PLUS_MODERATE_DELEGATE_COMMUNITY' | 'PROFILE_PLUS_MESSAGING' | 'PROFILE_PLUS_ADVERTISE' | 'PROFILE_PLUS_ANALYZE' | 'PROFILE_PLUS_REVENUE' | 'PROFILE_PLUS_MANAGE_LEADS' | 'PROFILE_PLUS_CREATIVE_MANAGEMENT' | 'PROFILE_PLUS_CREATOR_MANAGEMENT' | 'PROFILE_PLUS_GLOBAL_STRUCTURE_MANAGEMENT')>;
     };
     path: {
         /**
@@ -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;