@zkp2p/sdk 0.14.2-rc.3 → 0.14.2

package/README.md

@@ -33,6 +33,93 @@ 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
+
+For partner cash-out integrations, prefer stable `@zkp2p/cash@0.6.1` 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`.
+
+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).
+
+### Popup customization
+
+Pass `appearance` to either hosted-link helper and `popup` to the browser opener:
+
+```ts
+await openVenmoGmailConnect({
+  payeeDetails,
+  popup: { width: 500, height: 620 },
+  appearance: {
+    logoUrl: 'https://your-app.example/logo.png',
+    logoAlt: 'Your app',
+    backgroundColor: '#FFFFFF',
+    textColor: '#172033',
+    secondaryTextColor: '#636B7A',
+    buttonColor: '#6246EA',
+    buttonTextColor: '#FFFFFF',
+    buttonHoverColor: '#5035CC',
+    focusColor: '#6246EA',
+    fontFamily: 'Arial, sans-serif',
+    headingFontFamily: 'Arial, sans-serif',
+    headingTextTransform: 'none',
+    buttonTextTransform: 'none',
+    headingFontSize: 30,
+    buttonBorderRadius: 24,
+    buttonHeight: 52,
+    logoHeight: 44,
+  },
+});
+```
+
+The page centers your hosted logo and Venmo in equal circular frames with connection dots below the explanation, using Peer when no partner logo is supplied. `fontUrl` optionally loads a hosted WOFF/WOFF2 face (the font host must
+allow CORS); a failed font uses the fallback stack. Failed partner images show Peer. Asset URLs require HTTPS, with HTTP localhost allowed for development.
+
+`VenmoGmailAppearance` also exposes `cardBackgroundColor`, `cardBorderRadius`,
+`borderColor`, `contentWidth`, `padding`, `gap`, `fontSize`, `successColor` and
+`errorColor`. Colors use `#RGB` or `#RRGGBB`; sizes are pixels. Invalid options
+throw `ValidationError` before the popup opens. Arbitrary CSS/HTML is not accepted.
+Choose contrasting text, button and focus colors.
+
+Popup width supports 320–1200 px and height 480–1600 px. Mobile still requests a
+regular tab, whose size and presentation are controlled by the browser. Branding
+and styles survive the existing Google callback; account binding, consent copy,
+receipt verification and error codes remain unchanged. Google controls its own
+consent page's appearance.
+
 ## Installation
 
 ```bash

package/dist/build-metadata.json

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

package/dist/chunk-BVBHBKX7.mjs

@@ -0,0 +1,12 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// <define:__ZKP2P_SDK_BUILD_METADATA__>
+var define_ZKP2P_SDK_BUILD_METADATA_default = { schemaVersion: 2, source: { repository: "zkp2p/zkp2p-clients", commitSha: "a87f38c512f987fc3b9234b5aee31115bf840a18", kind: "github", distributable: true }, sdkPackageVersion: "0.14.2", contractsPackageVersion: "0.4.2-rc.2", indexerSchemaPackageVersion: "0.22.0", activeDisputeStack: { base: { version: 2, selectionHash: "ba40c2954b408d0c658881a8d28e5bfcc9bade5cc3d953fd17eae1eca69d841c" }, baseStaging: { version: 2, selectionHash: "6c49c1ce51eec594a22385c4efcab08aa9926b6b63a725e14a0027ec5d2f4fc9" } } };
+
+export { __export, define_ZKP2P_SDK_BUILD_METADATA_default };
+//# sourceMappingURL=chunk-BVBHBKX7.mjs.map
+//# sourceMappingURL=chunk-BVBHBKX7.mjs.map

package/dist/chunk-BVBHBKX7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["%3Cdefine:__ZKP2P_SDK_BUILD_METADATA__%3E"],"names":[],"mappings":";;;;;;;AAAA,IAAA,uCAAA,GAAA,EAAC,aAAA,EAAgB,CAAA,EAAE,MAAA,EAAS,EAAC,YAAa,qBAAA,EAAsB,SAAA,EAAY,0CAAA,EAA2C,IAAA,EAAO,UAAS,aAAA,EAAgB,IAAA,EAAI,EAAE,iBAAA,EAAoB,UAAS,uBAAA,EAA0B,YAAA,EAAa,2BAAA,EAA8B,QAAA,EAAS,oBAAqB,EAAC,IAAA,EAAO,EAAC,OAAA,EAAU,GAAE,aAAA,EAAgB,kEAAA,EAAkE,EAAE,WAAA,EAAc,EAAC,OAAA,EAAU,CAAA,EAAE,aAAA,EAAgB,kEAAA,IAAmE","file":"chunk-BVBHBKX7.mjs","sourcesContent":["{\"schemaVersion\":2,\"source\":{\"repository\":\"zkp2p/zkp2p-clients\",\"commitSha\":\"a87f38c512f987fc3b9234b5aee31115bf840a18\",\"kind\":\"github\",\"distributable\":true},\"sdkPackageVersion\":\"0.14.2\",\"contractsPackageVersion\":\"0.4.2-rc.2\",\"indexerSchemaPackageVersion\":\"0.22.0\",\"activeDisputeStack\":{\"base\":{\"version\":2,\"selectionHash\":\"ba40c2954b408d0c658881a8d28e5bfcc9bade5cc3d953fd17eae1eca69d841c\"},\"baseStaging\":{\"version\":2,\"selectionHash\":\"6c49c1ce51eec594a22385c4efcab08aa9926b6b63a725e14a0027ec5d2f4fc9\"}}}"]}

package/dist/{chunk-DNKX73LN.mjs → chunk-OP2REHNS.mjs}

@@ -1,5 +1,5 @@
 import { currencyKeccak256, getCurrencyInfoFromHash } from './chunk-ZB22BZLZ.mjs';
-import { __export } from './chunk-VGVHGGQU.mjs';
+import { __export } from './chunk-BVBHBKX7.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-OP2REHNS.mjs.map
+//# sourceMappingURL=chunk-OP2REHNS.mjs.map