docs: add bulkOnly parameter to getGrantedAccess and fix documentation inconsistencies

- Add bulkOnly parameter to getGrantedAccess method documentation
- Fix onStatusUpdate type in prepareBulkRequest (PrepareBulkRequestStatuses)
- Fix workerpoolAddressOrEns type in sendEmailCampaign (AddressOrENS)
- Fix tasks array property order in sendEmailCampaign response (taskId, dealId, bulkIndex)
- Remove unnecessary code in sendEmailCampaign examples
- Ensure all parameter types and return values match SDK implementations

Author: abbesBenayache

package-lock.json

@@ -23,7 +23,7 @@
     "@wagmi/vue": "^0.1.24",
     "clsx": "^2.1.1",
     "figlet": "^1.8.2",
-    "iexec": "^8.22.0",
+    "iexec": "^8.22.2",
     "pinia": "^3.0.3",
     "reka-ui": "^2.4.1",
     "tailwind-merge": "^3.3.1",

package.json

@@ -191,6 +191,30 @@ const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
 });
 ```
 
+### bulkOnly <OptionalBadge />
+
+**Type:** `boolean`  
+**Default:** `false`
+
+Filter to retrieve only bulk orders. When set to `true`, only granted accesses
+that have been created with `allowBulk: true` in
+[`grantAccess`](/references/dataProtector/methods/grantAccess) will be returned.
+This is useful when preparing bulk requests using
+[`prepareBulkRequest`](/references/dataProtector/methods/prepareBulkRequest).
+
+**Usage example:**
+
+```ts twoslash
+import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
+// ---cut---
+const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
+  bulkOnly: true, // [!code focus]
+});
+```
+
 ## Return Value
 
 ```ts twoslash

src/references/dataProtector/methods/getGrantedAccess.md

@@ -213,16 +213,10 @@ const grantedAccess = await dataProtectorCore.grantAccess({
 **Default:** `false`
 
 When set to `true`, enables bulk processing for this access grant. This allows
-multiple protected data items to be processed together in a single task, which
-is more efficient for bulk operations like sending campaigns to multiple
-recipients.
+multiple protected data items to be processed together.
 
-When `allowBulk: true` is set, the following parameters are automatically
-configured:
-
-- **Price per access**: Set to `0` (no price per access)
-- **Number of accesses**: Set to `Number.MAX_SAFE_INTEGER` (maximum number of
-  accesses)
+When `allowBulk: true` is set, the price per access is automatically set to `0`
+and the number of accesses is unlimited.
 
 ```ts twoslash
 import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';

src/references/dataProtector/methods/grantAccess.md

@@ -9,8 +9,8 @@ description:
 # prepareBulkRequest
 
 This method prepares a bulk request by grouping multiple protected data items
-that can be processed together in a single task. The prepared bulk request can
-then be processed using the
+that can be processed together efficiently. The prepared bulk request can then
+be processed using the
 [`processBulkRequest`](/references/dataProtector/methods/processBulkRequest)
 method.
 
@@ -93,17 +93,7 @@ obtain bulk accesses. Each `GrantedAccess` must have been created with
 [`grantAccess`](/references/dataProtector/methods/grantAccess).
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-// First, get granted accesses with bulk capability
-const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
-  bulkOnly: true,
-});
-
-// Then prepare the bulk request
+// @errors: 2304 7034 7005
 const { bulkRequest } = await dataProtectorCore.prepareBulkRequest({
   bulkAccesses: grantedAccess, // [!code focus]
   app: '0x456def...',
@@ -118,15 +108,7 @@ The ETH address or Ethereum Name Service (ENS) address for the iExec application
 that will process the protected data items in the bulk request.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
-  bulkOnly: true,
-});
-
+// @errors: 2304 7034 7005
 const { bulkRequest } = await dataProtectorCore.prepareBulkRequest({
   bulkAccesses: grantedAccess,
   app: '0x456def...', // [!code focus]
@@ -143,15 +125,7 @@ Limits the number of protected data items processed per task. If you have more
 protected data items than this limit, multiple tasks will be created.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
-  bulkOnly: true,
-});
-
+// @errors: 2304 7034 7005
 const { bulkRequest } = await dataProtectorCore.prepareBulkRequest({
   bulkAccesses: grantedAccess,
   app: '0x456def...',
@@ -177,15 +151,7 @@ confidential computations on the iExec platform.
 You can specify this during preparation or when processing the bulk request.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
-  bulkOnly: true,
-});
-
+// @errors: 2304 7034 7005
 const { bulkRequest } = await dataProtectorCore.prepareBulkRequest({
   bulkAccesses: grantedAccess,
   app: '0x456def...',
@@ -204,15 +170,7 @@ using their infrastructure to run the application. You can specify this during
 preparation or when processing the bulk request.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
-  bulkOnly: true,
-});
-
+// @errors: 2304 7034 7005
 const { bulkRequest } = await dataProtectorCore.prepareBulkRequest({
   bulkAccesses: grantedAccess,
   app: '0x456def...',
@@ -230,15 +188,7 @@ The maximum amount (in nRLC) you are willing to pay the application provider for
 using the application.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
-  bulkOnly: true,
-});
-
+// @errors: 2304 7034 7005
 const { bulkRequest } = await dataProtectorCore.prepareBulkRequest({
   bulkAccesses: grantedAccess,
   app: '0x456def...',
@@ -254,15 +204,7 @@ Set of execution arguments for the application that will be used for all tasks
 in the bulk request.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
-  bulkOnly: true,
-});
-
+// @errors: 2304 7034 7005
 const { bulkRequest } = await dataProtectorCore.prepareBulkRequest({
   bulkAccesses: grantedAccess,
   app: '0x456def...',
@@ -286,15 +228,7 @@ A set of URLs representing the input files required for application execution.
 These files will be used for all tasks in the bulk request.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
-  bulkOnly: true,
-});
-
+// @errors: 2304 7034 7005
 const { bulkRequest } = await dataProtectorCore.prepareBulkRequest({
   bulkAccesses: grantedAccess,
   app: '0x456def...',
@@ -315,15 +249,7 @@ variables. For more details, see
 [Access requester secrets](/guides/build-iapp/advanced/access-confidential-assets).
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
-  bulkOnly: true,
-});
-
+// @errors: 2304 7034 7005
 const { bulkRequest } = await dataProtectorCore.prepareBulkRequest({
   bulkAccesses: grantedAccess,
   app: '0x456def...',
@@ -346,15 +272,7 @@ provide the `pemPrivateKey` when processing the bulk request to decrypt the
 results.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
-  bulkOnly: true,
-});
-
+// @errors: 2304 7034 7005
 const { bulkRequest, pemPrivateKey } =
   await dataProtectorCore.prepareBulkRequest({
     bulkAccesses: grantedAccess,
@@ -372,15 +290,7 @@ Private key in PEM format for result encryption/decryption. If not provided and
 response.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
-  bulkOnly: true,
-});
-
+// @errors: 2304 7034 7005
 const { bulkRequest, pemPrivateKey } =
   await dataProtectorCore.prepareBulkRequest({
     bulkAccesses: grantedAccess,
@@ -393,9 +303,11 @@ const { bulkRequest, pemPrivateKey } =
 
 ### onStatusUpdate <OptionalBadge />
 
-**Type:** `OnStatusUpdateFn<ProcessBulkRequestStatuses>` Callback function to be
-notified at intermediate steps during bulk request preparation. You can expect
-this callback function to be called with the following titles:
+**Type:** `OnStatusUpdateFn<PrepareBulkRequestStatuses>`
+
+Callback function to be notified at intermediate steps during bulk request
+preparation. You can expect this callback function to be called with the
+following titles:
 
 - `'PUSH_REQUESTER_SECRET'` - Pushing requester secrets to the SMS
 - `'GENERATE_ENCRYPTION_KEY'` - Generating encryption key pair (if
@@ -408,15 +320,7 @@ this callback function to be called with the following titles:
 Each status is called once with `isDone: false`, and then with `isDone: true`.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-const { grantedAccess } = await dataProtectorCore.getGrantedAccess({
-  bulkOnly: true,
-});
-
+// @errors: 2304 7034 7005 7031
 const { bulkRequest } = await dataProtectorCore.prepareBulkRequest({
   bulkAccesses: grantedAccess,
   app: '0x456def...',