@zkp2p/sdk 0.14.2-rc.3 → 0.14.2-rc.4

package/README.md

@@ -33,6 +33,43 @@ and chargeback-risk surface. The workspace version lives in `package.json`.
 - Modular internals: intent, guardian, access-policy, staking, vault, and ProtocolViewer logic are extracted from `Zkp2pClient`, keeping the main client focused on orchestration.
 - App-level rollout control: the SDK is capability-based. Product gating and phase flags belong in your app layer, not inside transaction helpers.
 
+## Optional Venmo Gmail connection
+
+Open Peer's **Link your Venmo** popup for an already-registered account.
+The host passes the selected account hash; the user selects Connect Gmail,
+then chooses their receipt inbox through Google.
+
+```ts
+import { openVenmoGmailConnect, VenmoGmailConnectError } from '@zkp2p/sdk';
+
+// Call directly from your button's click handler.
+try {
+  await openVenmoGmailConnect({ payeeDetails });
+  // Refresh the account's credential status.
+} 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.
+  }
+}
+```
+
+Google-hosted school and custom domains can attempt verification; no email
+suffix check runs. Missing receipts produce a recoverable verification error.
+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'` means Gmail is linked.
+Already-active Gmail 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
+have the exact callback origin registered. `getVenmoGmailConnectUrl` supports native
+hosts and custom window handling with account-status polling at least ten seconds
+apart. Deploy the hosted page before using the SDK helper. See the
+[flow specification](https://github.com/zkp2p/zkp2p-clients/blob/main/docs/venmo-gmail-connect.md).
+
 ## Installation
 
 ```bash

package/dist/build-metadata.json

@@ -2,11 +2,11 @@
   "schemaVersion": 2,
   "source": {
     "repository": "zkp2p/zkp2p-clients",
-    "commitSha": "aaeaeda52c93c46337bd6f3e6d7a49535622fbd2",
+    "commitSha": "8f8238e57dadbf8c2dddc5e6a1db1bfaf2d21df2",
     "kind": "github",
     "distributable": true
   },
-  "sdkPackageVersion": "0.14.2-rc.3",
+  "sdkPackageVersion": "0.14.2-rc.4",
   "contractsPackageVersion": "0.4.2-rc.2",
   "indexerSchemaPackageVersion": "0.22.0",
   "activeDisputeStack": {

package/dist/{chunk-DNKX73LN.mjs → chunk-4SDRVKB5.mjs}

@@ -1,5 +1,5 @@
 import { currencyKeccak256, getCurrencyInfoFromHash } from './chunk-ZB22BZLZ.mjs';
-import { __export } from './chunk-VGVHGGQU.mjs';
+import { __export } from './chunk-U555K2CU.mjs';
 import { hexToBytes, keccak256, toBytes, bytesToHex } from 'viem';
 
 // src/utils/bigint.ts
@@ -97848,5 +97848,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-DNKX73LN.mjs.map
-//# sourceMappingURL=chunk-DNKX73LN.mjs.map
+//# sourceMappingURL=chunk-4SDRVKB5.mjs.map
+//# sourceMappingURL=chunk-4SDRVKB5.mjs.map