@zkp2p/sdk 0.14.6 → 0.14.7

package/README.md

@@ -35,14 +35,15 @@ and chargeback-risk surface. The workspace version lives in `package.json`.
 
 ## Optional Venmo Gmail connection
 
-For partner cash-out integrations, prefer stable `@zkp2p/cash@0.6.2` and its
+For partner cash-out integrations, prefer stable `@zkp2p/cash@0.7.2` and its
 [prepare/open/status flow](https://docs.peer.xyz/developer/peer-cash/guide#optional-venmo-receipt-linking).
 It selects the matching environment and keeps linking separate from cash-out.
 The direct SDK helpers below require `@zkp2p/sdk@0.14.2` or later.
 
 Open Peer's **Link your Venmo** popup for an already-registered account.
-The host passes the selected account hash; the user selects Connect Gmail or
-Connect Outlook, then chooses their receipt inbox with that provider.
+The host passes the selected account hash; the user picks Gmail or Outlook,
+which opens that provider's consent, or iCloud Mail, which takes an Apple
+app-specific password on the Peer page.
 
 ```ts
 import { openVenmoGmailConnect, VenmoGmailConnectError } from '@zkp2p/sdk';
@@ -54,8 +55,8 @@ try {
 } catch (error) {
   if (error instanceof VenmoGmailConnectError) {
     // Preserve error.code for host UI handling and display error.message.
-    // Missing receipts: venmo_google_oauth_receipt_not_found or
-    // VENMO_MICROSOFT_OAUTH_RECEIPT_NOT_FOUND.
+    // Missing receipts: venmo_google_oauth_receipt_not_found,
+    // VENMO_MICROSOFT_OAUTH_RECEIPT_NOT_FOUND or icloud_receipt_not_found.
   }
 }
 ```
@@ -67,9 +68,9 @@ Mobile widths request a normal browser tab; desktop requests a popup. The SDK
 also reports blocked popups, closure, and a ten-minute timeout. Browser
 opener isolation or a lost response can interrupt notification; reconcile with
 `client.getSellerCredentialStatus()` or `apiGetSellerCredentialStatus()` before
-retrying. Only `active` with `credentialType` `'google_oauth'` or
-`'microsoft_oauth'` means an inbox is linked. An already-linked inbox needs no
-reconnect. Linking is optional and never gates deposits.
+retrying. Only `active` with a mailbox `credentialType`
+(`isMailboxSellerCredentialType`, 0.14.7+: Gmail, Outlook or iCloud Mail) means
+an inbox is linked. An already-linked inbox needs no reconnect. Linking is optional and never gates deposits.
 
 Use matching Peer/Curator environments and configure Curator CORS for your host.
 `peerOrigin` accepts HTTPS origins or HTTP localhost for development; Google must
@@ -105,8 +106,8 @@ before navigating to `returnUrl` unchanged. No OAuth codes, tokens, email,
 account hash, or success flag are appended. If automatic navigation is blocked,
 select **Return to your app**. Consent or verification errors stay visible and
 also offer a manual return. A return, dismissal, or cancellation is not proof of
-linking: only an active `google_oauth` or `microsoft_oauth` credential from the
-status API is linked.
+linking: only an active mailbox credential (`isMailboxSellerCredentialType`)
+from the status API is linked.
 
 Apps that need no SDK can build the same URL themselves:
 `https://app.peer.xyz/connect/venmo?returnUrl=<URL-encoded-callback>#<payeeDetails>`.
@@ -550,7 +551,7 @@ For table-style liquidity UIs, the low-level `apiGetOrderbookTable()` adapter ex
 
 ## Seller Credential Status
 
-Venmo and PayPal Seller Autopilot connections use `uploadGoogleOAuthSellerCredential` for Gmail or `uploadMicrosoftOAuthSellerCredential` for personal Outlook accounts. The normal `uploadSellerCredential` and extension seller-capture paths support Cash App, Wise (token upload only), and Amazon Pay UPI. Existing backend Venmo cookie bundles remain usable through status/verification and low-level encrypted-bundle APIs.
+Venmo and PayPal Seller Autopilot connections use `uploadGoogleOAuthSellerCredential` for Gmail, `uploadMicrosoftOAuthSellerCredential` for personal Outlook accounts, or `uploadICloudMailSellerCredential` for iCloud Mail. The normal `uploadSellerCredential` and extension seller-capture paths support Cash App, Wise (token upload only), and Amazon Pay UPI. Existing backend Venmo cookie bundles remain usable through status/verification and low-level encrypted-bundle APIs.
 
 ```ts
 await client.uploadGoogleOAuthSellerCredential({
@@ -576,6 +577,19 @@ await client.uploadMicrosoftOAuthSellerCredential({
 
 Validate OAuth state in the initiating browser tab before uploading. `redirectUri` must exactly match the one in the authorization request. Both methods exchange a one-time code without retrying; start fresh consent if the response is lost. The Microsoft client secret stays server-side. See [email connection setup](../../docs/email-oauth.md).
 
+iCloud Mail has no OAuth. Pass the seller's Apple app-specific password with the registered maker hash; PayPal also passes its receiving email. For Venmo, the SDK fetches the maker's account ID from Curator (`GET /v2/makers/venmo/{payeeDetails}/payee-id`) and checks it against `payeeDetails` before any mailbox work, so sellers never enter it.
+
+```ts
+await client.uploadICloudMailSellerCredential({
+  platform: 'venmo',
+  payeeDetails: registeredMaker.hashedOnchainId,
+  mailboxEmail: 'seller@icloud.com',
+  appSpecificPassword,
+});
+```
+
+The password is encrypted to the attested enclave and posted directly to the attestor paired with `baseApiUrl`. The returned bundle is verified against the pinned enclave signer, platform and maker before it is stored unchanged; the maker is not re-registered. React Native callers pass `{ attestationRuntime: { subtle, getRandomValues } }`. Failures reject with `ICloudMailCredentialError`, whose `reason` names the condition (`payee_mismatch`, `payee_not_found`, `receipt_not_found`, `app_password_rejected`, `rate_limited` with `retryAfterMs`, and so on). The method never retries; one connection per mailbox runs at a time. `isMailboxSellerCredentialType` recognizes Gmail, Outlook and iCloud Mail credentials.
+
 ```ts
 const status = await client.getSellerCredentialStatus({
   processorName: 'venmo',

package/dist/build-metadata.json

@@ -2,11 +2,11 @@
   "schemaVersion": 2,
   "source": {
     "repository": "zkp2p/zkp2p-clients",
-    "commitSha": "fd02009b2fcfda2e4ee8decaa6bd572181ffdb4a",
+    "commitSha": "b2eb8395983f34f42ecbfecda99efa0fe3fba75a",
     "kind": "github",
     "distributable": true
   },
-  "sdkPackageVersion": "0.14.6",
+  "sdkPackageVersion": "0.14.7",
   "contractsPackageVersion": "0.4.4-rc.2",
   "indexerSchemaPackageVersion": "0.22.0",
   "activeDisputeStack": {

package/dist/{chunk-PT56GEQ4.mjs → chunk-ANDZNB7X.mjs}

@@ -1,5 +1,5 @@
 import { currencyKeccak256, getCurrencyInfoFromHash } from './chunk-WDEEWFEU.mjs';
-import { __export } from './chunk-BBPE3X6U.mjs';
+import { __export } from './chunk-SWQCAVQR.mjs';
 import { hexToBytes, keccak256, toBytes, bytesToHex } from 'viem';
 
 // src/utils/bigint.ts
@@ -100446,5 +100446,5 @@ function enrichPvIntentView(view, chainId, env = "production") {
 }
 
 export { DISPUTE_PROTECTION_POLICY_ABI, DISPUTE_PROTECTION_POLICY_ABI2, DisputeNullifierRegistry_default3 as DisputeNullifierRegistry_default, DisputeProtectionPolicy_default3 as DisputeProtectionPolicy_default, DisputeVerifier_default3 as DisputeVerifier_default, IntentLifecycleHookV1_default3 as IntentLifecycleHookV1_default, METHOD_NAME_TO_HASH, MultiAttestationVerifier_default3 as MultiAttestationVerifier_default, ORCHESTRATOR_V3_ABI2 as ORCHESTRATOR_V3_ABI, OrchestratorRegistry_default3 as OrchestratorRegistry_default, OrchestratorV3_default3 as OrchestratorV3_default, PAYMENT_PLATFORMS, STAKE_VAULT_ABI2 as STAKE_VAULT_ABI, SUPPORTED_PAYMENT_METHOD_HASHES, StakeVault_default3 as StakeVault_default, WhitelistPolicy_default3 as WhitelistPolicy_default, asciiToBytes32, enrichPvDepositView, enrichPvIntentView, ensureBytes32, getContracts, getDisputeProtectionPolicyContract, getGatingServiceAddress, getIntentGuardianContract, getOrchestratorV3Contract, getPaymentMethodsCatalog, getRateManagerContracts, getStakeVaultContract, hasIntentGuardian, matchesPaymentMethodNameAndHash, matchesQuotePaymentMethod, parseBigIntLike, parseDepositView, parseIntentView, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash };
-//# sourceMappingURL=chunk-PT56GEQ4.mjs.map
-//# sourceMappingURL=chunk-PT56GEQ4.mjs.map
+//# sourceMappingURL=chunk-ANDZNB7X.mjs.map
+//# sourceMappingURL=chunk-ANDZNB7X.mjs.map