@zkp2p/sdk 0.14.2 → 0.14.3

package/README.md

@@ -75,6 +75,45 @@ hosts and custom window handling with account-status polling at least ten second
 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).
 
+### Native app return
+
+SDK `0.14.3` adds optional `returnUrl` to the URL builder. Partners
+supply their callback directly; no callback registration with Peer or deployment
+setting is required. Deploy the hosted-page update before enabling this flow.
+
+```ts
+import { getVenmoGmailConnectUrl } from '@zkp2p/sdk';
+import * as WebBrowser from 'expo-web-browser';
+
+// Use a callback scheme registered in your app binary.
+const returnUrl = 'partner-app://venmo-linked';
+const connectUrl = getVenmoGmailConnectUrl({ payeeDetails, returnUrl });
+await WebBrowser.openAuthSessionAsync(connectUrl, returnUrl);
+// Re-check your backend's seller-credential/status after return or dismissal.
+```
+
+Use a scheme registered in your Expo app binary; Expo Go is not a substitute
+for testing your app's callback. See Expo's
+[`openAuthSessionAsync` documentation](https://docs.expo.dev/versions/latest/sdk/webbrowser/#webbrowseropenauthsessionasyncurl-redirecturl-options).
+The browser popup helper remains browser-only; native hosts use the URL builder.
+
+Peer keeps Google's OAuth callback on Peer and verifies the selected account
+before navigating to `returnUrl` unchanged. No Google 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` credential 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>`.
+The query parameter must precede the account hash fragment. Malformed URLs,
+unsafe schemes, embedded credentials, and duplicate parameters are rejected
+before consent or credential upload.
+
+Omit `returnUrl` or leave it empty to keep the existing behavior: Peer attempts
+`window.close()` after verification. Script-opened desktop popups can close;
+mobile browser tabs that disallow closure keep the success message visible.
+
 ### Popup customization
 
 Pass `appearance` to either hosted-link helper and `popup` to the browser opener:

package/dist/build-metadata.json

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

package/dist/{chunk-OP2REHNS.mjs → chunk-2NJU3MGV.mjs}

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