@getpara/core-sdk 2.24.0 → 3.0.0-alpha.0

package/dist/types/state/types/auth.d.ts

@@ -1,4 +1,4 @@
-import type { ServerAuthState } from '@getpara/user-management-client';
+import type { ServerAuthState, TOAuthMethod } from '@getpara/user-management-client';
 import type { AuthState, WithCustomTheme, WithUseShortUrls } from '../../types/index.js';
 import type { createAuthStateMachine } from '../machines/authStateMachine.js';
 import type { CoreActor, ServerAuthStateResult } from './core.js';
@@ -75,6 +75,8 @@ export type AuthEvents = {
     type: 'COMPLETE';
 } | {
     type: 'CANCEL';
+} | {
+    type: 'LOGOUT';
 } | {
     type: 'INITIALIZE_GUEST_MODE';
 } | {
@@ -96,6 +98,7 @@ export interface AuthContext {
     externalWalletInfo?: PerformConnectExternalWalletResponse;
     externalWalletSignVerification?: BaseVerifyExternalWalletParams;
     isLegacy: boolean;
+    selectedOAuthMethod: TOAuthMethod | null;
     retryAttempts?: {
         externalWalletVerification?: number;
         newAccountVerification?: number;

package/dist/types/state/types/core.d.ts

@@ -1,4 +1,4 @@
-import type { BiometricLocationHint, CurrentWalletIds, ServerAuthState } from '@getpara/user-management-client';
+import type { BiometricLocationHint, CurrentWalletIds, ServerAuthState, TOAuthMethod } from '@getpara/user-management-client';
 import type { AuthState, Wallet, WithCustomTheme, WithUseShortUrls } from '../../types/index.js';
 import { AuthMachine, AuthPhase } from './auth.js';
 import { WalletMachine, WalletPhase } from './wallet.js';
@@ -55,6 +55,7 @@ export interface CoreState {
     } | null;
     needsWallet: boolean;
     externalWalletSignVerification?: BaseVerifyExternalWalletParams;
+    selectedOAuthMethod: TOAuthMethod | null;
     guestWallets: Wallet[] | null;
 }
 /**
@@ -77,16 +78,24 @@ export type AuthStateInfo = {
     hasPin: boolean;
     /** Portal URL for passkey login/signup */
     passkeyUrl: string | null;
+    /** Full (unshortened) portal URL for passkey login/signup */
+    passkeyFullUrl: string | null;
     /** Portal URL for authorizing from a known device with passkey */
     passkeyKnownDeviceUrl: string | null;
     /** Portal URL for password login/signup */
     passwordUrl: string | null;
     /** Portal URL for PIN login/signup */
     pinUrl: string | null;
+    /** Full (unshortened) portal URL for password login/signup */
+    passwordFullUrl: string | null;
+    /** Full (unshortened) portal URL for PIN login/signup */
+    pinFullUrl: string | null;
     /** The Para system ID for the user's passkey credential (signup only) */
     passkeyId: string | null;
     /** Verification URL for email/phone verification in SLO */
     verificationUrl: string | null;
+    /** Full (unshortened) verification URL. Used by preloaded iframe. */
+    verificationFullUrl: string | null;
     /** External wallet verification data when signature is needed */
     externalWalletVerification: {
         signatureVerificationMessage: string;
@@ -103,6 +112,7 @@ export type StateSnapshot = {
     authPhase: AuthPhase;
     walletPhase: WalletPhase;
     authStateInfo: AuthStateInfo;
+    selectedOAuthMethod: TOAuthMethod | null;
     error: Error | null;
     isReady: boolean;
 };

package/dist/types/types/authState.d.ts

@@ -4,6 +4,7 @@ export type CoreAuthInfo = PrimaryAuthInfo & AuthExtras;
 export type AuthStateBaseParams = WithCustomTheme & WithUseShortUrls;
 export type AuthStateVerify = ServerAuthStateVerify & {
     loginUrl?: string;
+    loginFullUrl?: string;
 };
 export type AuthStateLogin = Omit<ServerAuthStateLogin, 'loginAuthMethods'> & WithIsPasskeySupported & {
     /**
@@ -22,6 +23,18 @@ export type AuthStateLogin = Omit<ServerAuthStateLogin, 'loginAuthMethods'> & Wi
      * A Para Portal URL for logging in via a PIN.
      */
     pinUrl?: string;
+    /**
+     * Full (unshortened) portal URL for passkey login.
+     */
+    passkeyFullUrl?: string;
+    /**
+     * Full (unshortened) portal URL for password login.
+     */
+    passwordFullUrl?: string;
+    /**
+     * Full (unshortened) portal URL for PIN login.
+     */
+    pinFullUrl?: string;
     /**
      * Supported login auth methods for this session.
      */
@@ -40,6 +53,18 @@ export type AuthStateSignup = Omit<ServerAuthStateSignup, 'signupAuthMethods'> &
      * A Para Portal URL for creating a new user PIN.
      */
     pinUrl?: string;
+    /**
+     * Full (unshortened) portal URL for passkey creation.
+     */
+    passkeyFullUrl?: string;
+    /**
+     * Full (unshortened) portal URL for password creation.
+     */
+    passwordFullUrl?: string;
+    /**
+     * Full (unshortened) portal URL for PIN creation.
+     */
+    pinFullUrl?: string;
     /**
      * The Para system ID for the newly generated passkey.
      */

package/dist/types/types/config.d.ts

@@ -1,6 +1,7 @@
 import { AxiosInstance } from 'axios';
-import Client, { EmailTheme, Network, OnRampAsset, OnRampProvider, PregenAuth, TWalletScheme, TWalletType, Theme } from '@getpara/user-management-client';
+import Client, { EmailTheme, Network, OnRampAsset, OnRampProvider, PregenAuth, TWalletScheme, TWalletType } from '@getpara/user-management-client';
 import { EnclaveClient } from '../shares/enclave.js';
+import type { PortalTheme } from './util.js';
 export declare enum Environment {
     DEV = "DEV",
     SANDBOX = "SANDBOX",
@@ -94,7 +95,7 @@ export interface ConstructorOpts {
      * Theme to use for the portal
      * @deprecated configure theming through the developer portal
      */
-    portalTheme?: Theme;
+    portalTheme?: PortalTheme;
     useDKLSForCreation?: boolean;
     disableWebSockets?: boolean;
     wasmOverride?: ArrayBuffer;

package/dist/types/types/coreApi.d.ts

@@ -3,8 +3,8 @@ import type { OAuthResponse, WithCustomTheme, WithUseShortUrls, Verify2faParams,
 import { ParaCore } from '../ParaCore.js';
 import { FullSignatureRes, Wallet } from './wallet.js';
 import { AccountLinkInProgress } from './accountLinking.js';
-import type { WaitForLoginParams, WaitForLoginResponse, WaitForSignupParams, WaitForWalletCreationParams, WaitForWalletCreationResponse, GetOAuthUrlParams, AddCredentialParams, LoginExternalWalletParams, LoginExternalWalletResponse, ResendVerificationCodeParams, SignUpOrLogInParams, SignUpOrLogInResponse, VerifyOAuthProcessParams, VerifyExternalWalletParams, VerifyExternalWalletResponse, VerifyFarcasterParams, VerifyTelegramParams, ClaimPregenWalletsParams, ClaimPregenWalletsResponse, CreateGuestWalletsResponse, CreatePregenWalletParams, CreatePregenWalletPerTypeParams, CreatePregenWalletPerTypeResponse, CreatePregenWalletResponse, CreateWalletParams, CreateWalletPerTypeParams, CreateWalletPerTypeResponse, CreateWalletResponse, DistributeNewWalletShareParams, GetPregenWalletsParams, GetPregenWalletsResponse, GetWalletBalanceParams, HasPregenWalletParams, PollingCallbacks, RefreshShareParams, RefreshShareResponse, UpdatePregenWalletIdentifierParams, BaseVerifyExternalWalletParams, AuthenticateWithEmailOrPhoneParams, AuthenticateWithEmailOrPhoneResponse, AuthenticateWithOAuthParams, AuthenticateWithOAuthResponse } from '../services/types';
-export declare const PARA_CORE_METHODS: readonly ["getAuthInfo", "signUpOrLogIn", "verifyNewAccount", "waitForLogin", "waitForSignup", "waitForWalletCreation", "getOAuthUrl", "verifyOAuth", "getFarcasterConnectUri", "verifyFarcaster", "verifyTelegram", "resendVerificationCode", "loginExternalWallet", "verifyExternalWallet", "setup2fa", "enable2fa", "verify2fa", "logout", "clearStorage", "isSessionActive", "isFullyLoggedIn", "refreshSession", "keepSessionAlive", "exportSession", "waitAndExportSession", "importSession", "getVerificationToken", "getWallets", "getWalletsByType", "fetchWallets", "createWallet", "createWalletPerType", "getPregenWallets", "hasPregenWallet", "updatePregenWalletIdentifier", "createPregenWallet", "createPregenWalletPerType", "claimPregenWallets", "createGuestWallets", "distributeNewWalletShare", "getUserShare", "setUserShare", "refreshShare", "signMessage", "signTransaction", "initiateOnRampTransaction", "getWalletBalance", "issueJwt", "getLinkedAccounts", "accountLinkInProgress", "addCredential", "exportPrivateKey", "authenticateWithEmailOrPhone", "authenticateWithOAuth"];
+import type { WaitForLoginParams, WaitForLoginResponse, WaitForSignupParams, WaitForWalletCreationParams, WaitForWalletCreationResponse, GetOAuthUrlParams, AddCredentialParams, LoginExternalWalletParams, LoginExternalWalletResponse, ResendVerificationCodeParams, SignUpOrLogInParams, SignUpOrLogInResponse, VerifyOAuthProcessParams, VerifyExternalWalletParams, VerifyExternalWalletResponse, VerifyFarcasterParams, VerifyTelegramParams, ClaimPregenWalletsParams, ClaimPregenWalletsResponse, CreateGuestWalletsResponse, CreatePregenWalletParams, CreatePregenWalletPerTypeParams, CreatePregenWalletPerTypeResponse, CreatePregenWalletResponse, CreateWalletParams, CreateWalletPerTypeParams, CreateWalletPerTypeResponse, CreateWalletResponse, DistributeNewWalletShareParams, GetPregenWalletsParams, GetPregenWalletsResponse, GetWalletBalanceParams, HasPregenWalletParams, PollingCallbacks, RefreshShareParams, RefreshShareResponse, RequestFaucetParams, RequestFaucetResponse, UpdatePregenWalletIdentifierParams, BaseVerifyExternalWalletParams, AuthenticateWithEmailOrPhoneParams, AuthenticateWithEmailOrPhoneResponse, AuthenticateWithOAuthParams, AuthenticateWithOAuthResponse } from '../services/types';
+export declare const PARA_CORE_METHODS: readonly ["getAuthInfo", "signUpOrLogIn", "verifyNewAccount", "waitForLogin", "waitForSignup", "waitForWalletCreation", "getOAuthUrl", "verifyOAuth", "getFarcasterConnectUri", "verifyFarcaster", "verifyTelegram", "resendVerificationCode", "loginExternalWallet", "verifyExternalWallet", "setup2fa", "enable2fa", "verify2fa", "logout", "clearStorage", "isSessionActive", "isFullyLoggedIn", "refreshSession", "keepSessionAlive", "exportSession", "waitAndExportSession", "importSession", "getVerificationToken", "getWallets", "getWalletsByType", "fetchWallets", "createWallet", "createWalletPerType", "getPregenWallets", "hasPregenWallet", "updatePregenWalletIdentifier", "createPregenWallet", "createPregenWalletPerType", "claimPregenWallets", "createGuestWallets", "distributeNewWalletShare", "getUserShare", "setUserShare", "refreshShare", "signMessage", "signTransaction", "initiateOnRampTransaction", "getWalletBalance", "requestFaucet", "issueJwt", "getLinkedAccounts", "accountLinkInProgress", "addCredential", "exportPrivateKey", "authenticateWithEmailOrPhone", "authenticateWithOAuth"];
 export declare const PARA_INTERNAL_METHODS: readonly ["linkAccount", "unlinkAccount", "verifyEmailOrPhoneLink", "verifyOAuthLink", "verifyFarcasterLink", "verifyTelegramLink", "verifyExternalWalletLink", "accountLinkInProgress", "prepareLogin", "sendLoginCode", "supportedUserAuthMethods"];
 export type CoreMethodName = (typeof PARA_CORE_METHODS)[number];
 export type CoreMethodParams<method extends CoreMethodName & keyof CoreMethods> = CoreMethods[method] extends {
@@ -363,6 +363,10 @@ export type CoreMethods = Record<CoreMethodName, {
         params: GetWalletBalanceParams;
         response: string;
     };
+    requestFaucet: {
+        params: RequestFaucetParams;
+        response: RequestFaucetResponse;
+    };
     issueJwt: {
         params: IssueJwtParams;
         response: IssueJwtResponse;
@@ -423,7 +427,9 @@ export type InternalMethods = {
     };
     sendLoginCode: {
         params: void;
-        response: void;
+        response: {
+            userId: string;
+        };
     };
     supportedUserAuthMethods: {
         params: void;

package/dist/types/types/serviceInterfaces.d.ts

@@ -1,6 +1,6 @@
 import type { pki as pkiType } from 'node-forge';
-import type { PartnerEntity, BackupKitEmailProps, VerificationEmailProps, TLinkedAccountType, Theme } from '@getpara/user-management-client';
-import type { Ctx, Environment, AccountLinkInProgress, ConstructorOpts } from './index.js';
+import type { PartnerEntity, BackupKitEmailProps, VerificationEmailProps, TLinkedAccountType } from '@getpara/user-management-client';
+import type { Ctx, Environment, AccountLinkInProgress, ConstructorOpts, PortalTheme } from './index.js';
 import type { PlatformUtils } from '../PlatformUtils.js';
 import type { AuthService } from '../services/AuthService.js';
 import type { WalletService } from '../services/WalletService.js';
@@ -71,7 +71,7 @@ export interface PortalUrlServiceInterface {
     isPartnerOptional: boolean | undefined;
     ctx: Ctx;
     get loginEncryptionKeyPair(): pkiType.rsa.KeyPair | undefined;
-    portalTheme?: Theme;
+    portalTheme?: PortalTheme;
     portalPrimaryButtonColor?: string;
     portalTextColor?: string;
     portalPrimaryButtonTextColor?: string;

package/dist/types/types/util.d.ts

@@ -1,4 +1,17 @@
 import { TAuthMethod, Theme } from '@getpara/user-management-client';
+/**
+ * Extended portal theme type that adds new theming fields not yet in the
+ * backend `Theme` type from `@getpara/user-management-client`.
+ *
+ * TODO: Remove this extension once the UMC `Theme` type includes
+ * `foregroundMixRatio` and `cssOverrides`.
+ */
+export type PortalTheme = Theme & {
+    /** Controls how much the foreground/accent color is mixed into generated UI palette steps. */
+    foregroundMixRatio?: number;
+    /** Raw CSS variable overrides applied after theme generation. Advanced use. */
+    cssOverrides?: Record<string, string>;
+};
 export type WithAuthMethod = {
     /**
      * Which authorization method to use for the URL, either `'PASSKEY'`, `'PASSWORD'` or `'PIN'`.
@@ -9,7 +22,7 @@ export type WithCustomTheme = {
     /**
      * The theme to apply to generated URLs, if different from your configured theme.
      */
-    portalTheme?: Theme;
+    portalTheme?: PortalTheme;
 };
 export type WithUseShortUrls = {
     /**

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@getpara/core-sdk",
-  "version": "2.24.0",
+  "version": "3.0.0-alpha.0",
   "dependencies": {
     "@celo/utils": "^8.0.2",
     "@cosmjs/encoding": "^0.32.4",
     "@ethereumjs/util": "^9.1.0",
-    "@getpara/user-management-client": "2.24.0",
+    "@getpara/user-management-client": "3.0.0-alpha.0",
     "@noble/hashes": "^1.5.0",
     "axios": "^1.8.4",
     "base64url": "^3.0.1",
@@ -30,7 +30,7 @@
     "dist",
     "package.json"
   ],
-  "gitHead": "3ea729c9a5e550c2053c5fff07d1ca7d8a8f9ce9",
+  "gitHead": "f58e6e365ca63a447edaa44fba3b157e5ca7a368",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "scripts": {