@getpara/core-sdk 3.0.0-alpha.1 → 3.1.0

package/dist/types/index.d.ts

@@ -1,11 +1,11 @@
 import { ParaCore } from './ParaCore.js';
-export { type Auth, type AuthInfo, type PrimaryAuthInfo, type VerifiedAuthInfo, type VerifiedAuth, AuthMethod, type TAuthMethod, AuthMethodStatus, type AuthExtras, type CurrentWalletIds, EmailTheme, type PartnerEntity, type WalletEntity, Network, type TNetwork, WalletType, type TWalletType, WalletScheme, type TWalletScheme, OnRampAsset, type TOnRampAsset, OnRampPurchaseType, OnRampProvider, OnRampPurchaseStatus, type OnRampConfig, type OnRampAssets, type OnRampPurchase, type OnRampAssetInfo, type ProviderAssetInfo, OnRampMethod, type Theme, OAuthMethod, type TOAuthMethod, type TLinkedAccountType, type SupportedAccountLinks, type SupportedWalletTypes, type TPregenIdentifierType, type PregenIds, type LinkedAccount, type LinkedAccounts, type TExternalWallet, type ExternalWalletInfo, type PregenAuth, type Setup2faResponse, type TelegramAuthResponse, type VerifyExternalWalletParams, type AssetMetadata, type AssetMetadataIndexed, type AssetValue, type BalancesConfig, type WalletBalance, type ProfileBalance, type OfframpDepositRequest, type WalletWithMetadata, RecoveryStatus, ThemeMode, NON_ED25519, PREGEN_IDENTIFIER_TYPES, WALLET_TYPES, WALLET_SCHEMES, OAUTH_METHODS, LINKED_ACCOUNT_TYPES, EXTERNAL_WALLET_TYPES, EVM_WALLETS, SOLANA_WALLETS, COSMOS_WALLETS, formatAssetQuantity, formatCurrency, type EstimateTransactionOpts, type EstimateTransactionResult, type BroadcastTransactionOpts, type BroadcastTransactionResult, type PendingTransactionEntity, type SerializedDecodedTx, type SerializedTxData, type GetPendingTransactionResponse, } from '@getpara/user-management-client';
+export { type Auth, type AuthInfo, type PrimaryAuthInfo, type VerifiedAuthInfo, type VerifiedAuth, AuthMethod, type TAuthMethod, AuthMethodStatus, AuthLayout, type TAuthLayout, type AuthExtras, type CurrentWalletIds, EmailTheme, type PartnerEntity, type PartnerAppConfig, type WalletEntity, Network, type TNetwork, WalletType, type TWalletType, WalletScheme, type TWalletScheme, OnRampAsset, type TOnRampAsset, OnRampPurchaseType, OnRampProvider, OnRampPurchaseStatus, type OnRampConfig, type OnRampAssets, type OnRampPurchase, type OnRampAssetInfo, type ProviderAssetInfo, OnRampMethod, OAuthMethod, type TOAuthMethod, type TLinkedAccountType, type SupportedAccountLinks, type SupportedWalletTypes, type TPregenIdentifierType, type PregenIds, type LinkedAccount, type LinkedAccounts, type TExternalWallet, type ExternalWalletInfo, type PregenAuth, type Setup2faResponse, type TelegramAuthResponse, type VerifyExternalWalletParams, type AssetMetadata, type AssetMetadataIndexed, type AssetValue, type BalancesConfig, type WalletBalance, type ProfileBalance, type OfframpDepositRequest, type WalletWithMetadata, RecoveryStatus, ThemeMode, NON_ED25519, PREGEN_IDENTIFIER_TYPES, WALLET_TYPES, WALLET_SCHEMES, OAUTH_METHODS, LINKED_ACCOUNT_TYPES, EXTERNAL_WALLET_TYPES, EVM_WALLETS, SOLANA_WALLETS, COSMOS_WALLETS, formatAssetQuantity, formatCurrency, type EstimateTransactionOpts, type EstimateTransactionResult, type BroadcastTransactionOpts, type BroadcastTransactionResult, type PendingTransactionEntity, type SerializedDecodedTx, type SerializedTxData, type GetPendingTransactionResponse, DeliveryChannel, type PartnerThemeConfig as Theme, } from '@getpara/user-management-client';
 export { PopupType, PregenIdentifierType, type AuthStateSignup, type AuthStateVerify, type AuthStateLogin, type AuthState, type OAuthResponse, type CoreAuthInfo, type SignatureRes, type FullSignatureRes, type SuccessfulSignatureRes, type DeniedSignatureRes, type DeniedSignatureResWithUrl, type Wallet, type AvailableWallet, type AccountLinkInProgress, AccountLinkError, type InternalInterface, type Verify2faParams, type Verify2faResponse, type StorageType, type TelegramParams, type CreateParaSignerBaseOptions, } from './types/index.js';
 export * from './types/smartAccounts.js';
 export * from './types/coreApi.js';
 export * from './types/events.js';
 export * from './types/config.js';
-export { getPortalDomain, dispatchEvent, onParaEvent, offParaEvent, entityToWallet, constructUrl, shortenUrl, isPortal, } from './utils/index.js';
+export { getPortalDomain, dispatchEvent, onParaEvent, offParaEvent, entityToWallet, constructUrl, shortenUrl, isPortal, warnOnce, } from './utils/index.js';
 export { PREFIX as STORAGE_PREFIX, PARA_PREFIX as PARA_STORAGE_PREFIX, LOCAL_STORAGE_CURRENT_WALLET_IDS, LOCAL_STORAGE_WALLETS, } from './constants.js';
 export { distributeNewShare } from './shares/shareDistribution.js';
 export { KeyContainer } from './shares/KeyContainer.js';
@@ -22,10 +22,22 @@ export * from './utils/phone.js';
 export * from './utils/config.js';
 export { isWalletSupported } from './utils/wallet.js';
 export { getNetworkPrefix, getOnRampAssets, getOnRampNetworks, toAssetInfoArray } from './utils/onRamps.js';
-export { getPortalBaseURL } from './utils/url.js';
+export { getPortalBaseURL, getParaConnectBaseUrl } from './utils/url.js';
+export { encodeConfigParams, tryDecodeConfig, isCompressionStreamSupported, ENCODED_CONFIG_VERSION, } from './utils/configEncoding.js';
+export type { EncodedConfig, EncodedAppConfig } from './utils/configEncoding.js';
 export { retrieve as transmissionUtilsRetrieve } from './transmission/transmissionUtils.js';
 export type { ShareData } from './shares/enclave.js';
 export type { StateSnapshot, AuthStateInfo } from './state/types/core';
 export type * from './services/types';
+export { getTracer, wrapWithSpan, wrapWithSpanInContext, extractTraceContextFromUrl, getUrlTraceCarrier, setDefaultParentContext, getDefaultParentContext, SpanStatusCode, } from './telemetry/tracer.js';
+export type { Span, Attributes, Context } from './telemetry/tracer.js';
+export { getOrCreateSessionId } from './telemetry/session.js';
+export { initTelemetry, isTelemetryInitialized, onTelemetryReady, flushTelemetry } from './telemetry/init.js';
+export { getUxState, setCurrentView, setLastInteraction } from './telemetry/uxState.js';
+export { setCurrentUserId } from './telemetry/uxStateSpanProcessor.js';
+export { recordActionOnSpan, type UxActionOutcome } from './telemetry/uxAction.js';
+export { startModalSession, endModalSession, getModalSessionContext } from './telemetry/modalSession.js';
+export type { InitTelemetryOpts } from './telemetry/init.js';
+export type { PartnerTelemetryConfig } from './telemetry/config.js';
 export declare const paraVersion: string;
 export default ParaCore;

package/dist/types/services/types/AuthServiceTypes.d.ts

@@ -1,4 +1,4 @@
-import type { Auth, AuthExtras, AuthMethod, AuthType, ExternalWalletInfo, PrimaryAuth, PrimaryAuthInfo, ServerAuthState, ServerAuthStateLogin, TAuthMethod, Theme, TOAuthMethod } from '@getpara/user-management-client';
+import type { Auth, AuthExtras, AuthMethod, AuthType, DeliveryChannel, ExternalWalletInfo, PrimaryAuth, PrimaryAuthInfo, ServerAuthState, ServerAuthStateLogin, TAuthMethod, PartnerThemeConfig, TOAuthMethod } from '@getpara/user-management-client';
 import type { AuthState, AuthStateDone, AuthStateLogin, AuthStateSignup, AuthStateVerify, CoreAuthInfo, WithCustomTheme, WithSessionLookupId, WithShorten, WithUseShortUrls } from '../../types/index.js';
 import type { InitOAuthPollingParams, PollingCallbacks } from './PollingServiceTypes.js';
 import { PerformConnectExternalWalletResponse, ExternalSignMessageParams } from './ExternalWalletServiceTypes.js';
@@ -36,7 +36,7 @@ export type PrepareAuthStateMethod = <T extends ServerAuthState>(serverAuthState
 }) => Promise<AuthState>;
 export type PrepareLoginStateMethod = (loginState: ServerAuthStateLogin, options: {
     useShortUrls?: boolean;
-    portalTheme?: Theme;
+    portalTheme?: PartnerThemeConfig;
     sessionLookupId: string;
 }) => Promise<AuthStateLogin>;
 export interface AuthenticateWithEmailOrPhoneParams extends SignUpOrLogInParams {
@@ -145,6 +145,13 @@ export type AddCredentialMethod = (_: AddCredentialParams) => Promise<string | u
 export type SupportedUserAuthMethodsMethod = () => Promise<Set<AuthMethod>>;
 export interface ResendVerificationCodeParams {
     type?: 'SIGNUP' | 'LINK_ACCOUNT' | 'LOGIN';
+    deliveryChannel?: DeliveryChannel;
 }
-export type ResendVerificationCodeMethod = (_: ResendVerificationCodeParams) => Promise<void>;
+export interface ResendVerificationCodeResponse {
+    deliveryChannel?: DeliveryChannel;
+    fallbackUsed?: boolean;
+    fallbackChannel?: DeliveryChannel;
+    isSmsAllowed?: boolean;
+}
+export type ResendVerificationCodeMethod = (_: ResendVerificationCodeParams) => Promise<ResendVerificationCodeResponse>;
 export {};

package/dist/types/services/types/PortalUrlServiceTypes.d.ts

@@ -1,5 +1,5 @@
-import type { TAuthMethod, TOAuthMethod } from '@getpara/user-management-client';
-import type { AccountLinkInProgress, PortalTheme, WithAuthMethod, WithCustomTheme, WithSessionId, WithShorten } from '../../types/index.js';
+import type { TAuthMethod, TOAuthMethod, PartnerThemeConfig } from '@getpara/user-management-client';
+import type { AccountLinkInProgress, WithAuthMethod, WithCustomTheme, WithSessionId, WithShorten } from '../../types/index.js';
 type Device = {
     sessionId: string;
     encryptionKey: string;
@@ -11,7 +11,7 @@ export type PortalUrlOptions = {
     thisDevice?: Device;
     newDevice?: Device;
     sessionId?: string;
-    portalTheme?: PortalTheme;
+    portalTheme?: PartnerThemeConfig;
     pathId?: string;
     shorten?: boolean;
     isEmbedded?: boolean;

package/dist/types/services/types/WalletServiceTypes.d.ts

@@ -111,6 +111,10 @@ export interface RequestFaucetParams {
     chain?: string;
 }
 export interface RequestFaucetResponse {
+    /**
+     * Hash for the submitted faucet funding transaction. Wait for confirmation
+     * before assuming funds are spendable.
+     */
     transactionHash: string;
     amount: string;
     chain: string;

package/dist/types/state/actors/setupPara.d.ts

@@ -1,2 +1,20 @@
 import { StateMachineInterface } from '../../types/serviceInterfaces.js';
+/**
+ * Bootstraps the SDK. Runs the platform-specific `setup()` (Farcaster init,
+ * wallet-record backfill, etc.) AND an eager partner-record load via
+ * `touchSession` in parallel — both are independent network/IO tasks and
+ * the state machine only flips `isReady=true` once this actor resolves.
+ *
+ * Eager partner load lives here rather than inside each subclass's setup()
+ * so every consumer of core-sdk (ParaWeb, ParaServer, future subclasses)
+ * gets it for free — the state machine is the canonical SDK lifecycle,
+ * and "partner is loaded" is part of being ready.
+ *
+ * Skipped in the portal context where `ModalLayoutV2` runs its own
+ * getPartner fetch with separate telemetry plumbing — calling touchSession
+ * there would duplicate the call. Best-effort otherwise: a network failure
+ * keeps partner unloaded for now, partner-dependent code paths fall back
+ * to legacy props / lazy-load via `#assertPartner` at gated method
+ * call-sites, and the SDK still becomes ready.
+ */
 export declare const createSetupParaActor: (paraCoreInterface: StateMachineInterface) => import("xstate").PromiseActorLogic<void, {}, import("xstate").EventObject>;

package/dist/types/state/machines/authStateMachine.d.ts

@@ -842,7 +842,7 @@ export declare function createAuthStateMachine(paraCoreInterface: StateMachineIn
                         data: {
                             authState: ServerAuthState;
                             sessionLookupId: string;
-                            portalTheme: import("../../types/util.js").PortalTheme;
+                            portalTheme: import("@getpara/user-management-client").PartnerThemeConfig;
                             useShortUrls: boolean;
                         };
                         finished: boolean;

package/dist/types/state/machines/coreStateMachine.d.ts

@@ -842,7 +842,7 @@ export declare function createCoreStateMachine(paraCoreInterface: StateMachineIn
                             data: {
                                 authState: import("@getpara/shared").ServerAuthState;
                                 sessionLookupId: string;
-                                portalTheme: import("../../types/util.js").PortalTheme;
+                                portalTheme: import("@getpara/shared/dist/types/types/partnerAppConfig.js").PartnerThemeConfig;
                                 useShortUrls: boolean;
                             };
                             finished: boolean;
@@ -2889,6 +2889,10 @@ export declare function createCoreStateMachine(paraCoreInterface: StateMachineIn
                 }];
             };
             readonly needs_wallets: {
+                readonly always: readonly [{
+                    readonly target: "creating_wallets";
+                    readonly guard: "shouldAutoCreate";
+                }];
                 readonly on: {
                     readonly WAIT_FOR_WALLET_CREATION: {
                         readonly target: "claiming_wallets";
@@ -4584,7 +4588,7 @@ export declare function createCoreStateMachine(paraCoreInterface: StateMachineIn
                                 data: {
                                     authState: import("@getpara/shared").ServerAuthState;
                                     sessionLookupId: string;
-                                    portalTheme: import("../../types/util.js").PortalTheme;
+                                    portalTheme: import("@getpara/shared/dist/types/types/partnerAppConfig.js").PartnerThemeConfig;
                                     useShortUrls: boolean;
                                 };
                                 finished: boolean;
@@ -6636,6 +6640,10 @@ export declare function createCoreStateMachine(paraCoreInterface: StateMachineIn
                     }];
                 };
                 readonly needs_wallets: {
+                    readonly always: readonly [{
+                        readonly target: "creating_wallets";
+                        readonly guard: "shouldAutoCreate";
+                    }];
                     readonly on: {
                         readonly WAIT_FOR_WALLET_CREATION: {
                             readonly target: "claiming_wallets";
@@ -8404,7 +8412,7 @@ export declare function createCoreStateMachine(paraCoreInterface: StateMachineIn
                                                     data: {
                                                         authState: import("@getpara/shared").ServerAuthState;
                                                         sessionLookupId: string;
-                                                        portalTheme: import("../../types/util.js").PortalTheme;
+                                                        portalTheme: import("@getpara/shared/dist/types/types/partnerAppConfig.js").PartnerThemeConfig;
                                                         useShortUrls: boolean;
                                                     };
                                                     finished: boolean;
@@ -10456,6 +10464,10 @@ export declare function createCoreStateMachine(paraCoreInterface: StateMachineIn
                                         }];
                                     };
                                     readonly needs_wallets: {
+                                        readonly always: readonly [{
+                                            readonly target: "creating_wallets";
+                                            readonly guard: "shouldAutoCreate";
+                                        }];
                                         readonly on: {
                                             readonly WAIT_FOR_WALLET_CREATION: {
                                                 readonly target: "claiming_wallets";
@@ -12162,7 +12174,7 @@ export declare function createCoreStateMachine(paraCoreInterface: StateMachineIn
                                                     data: {
                                                         authState: import("@getpara/shared").ServerAuthState;
                                                         sessionLookupId: string;
-                                                        portalTheme: import("../../types/util.js").PortalTheme;
+                                                        portalTheme: import("@getpara/shared/dist/types/types/partnerAppConfig.js").PartnerThemeConfig;
                                                         useShortUrls: boolean;
                                                     };
                                                     finished: boolean;
@@ -14214,6 +14226,10 @@ export declare function createCoreStateMachine(paraCoreInterface: StateMachineIn
                                         }];
                                     };
                                     readonly needs_wallets: {
+                                        readonly always: readonly [{
+                                            readonly target: "creating_wallets";
+                                            readonly guard: "shouldAutoCreate";
+                                        }];
                                         readonly on: {
                                             readonly WAIT_FOR_WALLET_CREATION: {
                                                 readonly target: "claiming_wallets";
@@ -16014,7 +16030,7 @@ export declare function createCoreStateMachine(paraCoreInterface: StateMachineIn
                                                     data: {
                                                         authState: import("@getpara/shared").ServerAuthState;
                                                         sessionLookupId: string;
-                                                        portalTheme: import("../../types/util.js").PortalTheme;
+                                                        portalTheme: import("@getpara/shared/dist/types/types/partnerAppConfig.js").PartnerThemeConfig;
                                                         useShortUrls: boolean;
                                                     };
                                                     finished: boolean;
@@ -18066,6 +18082,10 @@ export declare function createCoreStateMachine(paraCoreInterface: StateMachineIn
                                         }];
                                     };
                                     readonly needs_wallets: {
+                                        readonly always: readonly [{
+                                            readonly target: "creating_wallets";
+                                            readonly guard: "shouldAutoCreate";
+                                        }];
                                         readonly on: {
                                             readonly WAIT_FOR_WALLET_CREATION: {
                                                 readonly target: "claiming_wallets";
@@ -19773,7 +19793,7 @@ export declare function createCoreStateMachine(paraCoreInterface: StateMachineIn
                                                     data: {
                                                         authState: import("@getpara/shared").ServerAuthState;
                                                         sessionLookupId: string;
-                                                        portalTheme: import("../../types/util.js").PortalTheme;
+                                                        portalTheme: import("@getpara/shared/dist/types/types/partnerAppConfig.js").PartnerThemeConfig;
                                                         useShortUrls: boolean;
                                                     };
                                                     finished: boolean;
@@ -21825,6 +21845,10 @@ export declare function createCoreStateMachine(paraCoreInterface: StateMachineIn
                                         }];
                                     };
                                     readonly needs_wallets: {
+                                        readonly always: readonly [{
+                                            readonly target: "creating_wallets";
+                                            readonly guard: "shouldAutoCreate";
+                                        }];
                                         readonly on: {
                                             readonly WAIT_FOR_WALLET_CREATION: {
                                                 readonly target: "claiming_wallets";

package/dist/types/state/machines/walletStateMachine.d.ts

@@ -211,6 +211,10 @@ export declare function createWalletStateMachine(paraCoreInterface: StateMachine
             }];
         };
         readonly needs_wallets: {
+            readonly always: readonly [{
+                readonly target: "creating_wallets";
+                readonly guard: "shouldAutoCreate";
+            }];
             readonly on: {
                 readonly WAIT_FOR_WALLET_CREATION: {
                     readonly target: "claiming_wallets";

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

@@ -1,4 +1,4 @@
-import type { BiometricLocationHint, CurrentWalletIds, ServerAuthState, TOAuthMethod } from '@getpara/user-management-client';
+import type { BiometricLocationHint, CurrentWalletIds, DeliveryChannel, 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';
@@ -96,6 +96,12 @@ export type AuthStateInfo = {
     verificationUrl: string | null;
     /** Full (unshortened) verification URL. Used by preloaded iframe. */
     verificationFullUrl: string | null;
+    /** Channel the OTP was sent over — set on phone verifications so the UI can render channel-specific copy */
+    deliveryChannel: DeliveryChannel | null;
+    /** True when the server had to fall back from the primary channel (WhatsApp → SMS typically) */
+    fallbackUsed: boolean;
+    /** The channel actually used when fallbackUsed is true */
+    fallbackChannel: DeliveryChannel | null;
     /** External wallet verification data when signature is needed */
     externalWalletVerification: {
         signatureVerificationMessage: string;

package/dist/types/telemetry/BeaconSpanProcessor.d.ts

@@ -0,0 +1,10 @@
+import type { ReadableSpan, Span, SpanProcessor } from '@opentelemetry/sdk-trace-base';
+import type { Context } from '@opentelemetry/api';
+export declare class BeaconSpanProcessor implements SpanProcessor {
+    #private;
+    constructor(url: string);
+    onStart(_span: Span, _parentContext: Context): void;
+    onEnd(span: ReadableSpan): void;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+}

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

@@ -0,0 +1,4 @@
+export type PartnerTelemetryConfig = {
+    enabled: boolean;
+    sample_rate: number;
+};

package/dist/types/telemetry/init.d.ts

@@ -0,0 +1,17 @@
+import { type Attributes } from '@opentelemetry/api';
+import type { SDKType } from '@getpara/user-management-client';
+export type InitTelemetryOpts = {
+    tunnelUrl: string;
+    sampleRate: number;
+    sdkType: SDKType;
+    sdkVersion: string;
+    partnerId?: string;
+    resourceAttributes?: Attributes;
+    isDev?: boolean;
+    isPortal?: boolean;
+};
+export declare function onTelemetryReady(cb: () => void): void;
+export declare function initTelemetry(opts: InitTelemetryOpts): Promise<void>;
+export declare function isTelemetryInitialized(): boolean;
+export declare function flushTelemetry(): Promise<void>;
+export declare function __resetTelemetryForTests(): void;

package/dist/types/telemetry/modalSession.d.ts

@@ -0,0 +1,5 @@
+import { type Context } from '@opentelemetry/api';
+export declare function startModalSession(): void;
+export declare function endModalSession(): void;
+export declare function getModalSessionContext(): Context | undefined;
+export declare function __resetModalSessionForTests(): void;

package/dist/types/telemetry/session.d.ts

@@ -0,0 +1,2 @@
+export declare function getOrCreateSessionId(): string;
+export declare function __resetSessionForTests(): void;

package/dist/types/telemetry/tracer.d.ts

@@ -0,0 +1,10 @@
+import { type Attributes, type Context, type Span } from '@opentelemetry/api';
+export declare function getTracer(): import("@opentelemetry/api").Tracer;
+export declare function setDefaultParentContext(ctx: Context): void;
+export declare function getDefaultParentContext(): Context | undefined;
+export declare function wrapWithSpan<T>(name: string, fn: (span: Span) => Promise<T> | T, attributes?: Attributes): Promise<T>;
+export declare function extractTraceContextFromUrl(search?: string): Context;
+export declare function getUrlTraceCarrier(search?: string): Record<string, string>;
+export declare function wrapWithSpanInContext<T>(parentContext: Context, name: string, fn: (span: Span, traceHeaders: Record<string, string>) => Promise<T> | T): Promise<T>;
+export { SpanStatusCode } from '@opentelemetry/api';
+export type { Span, Attributes, Context } from '@opentelemetry/api';

package/dist/types/telemetry/uxAction.d.ts

@@ -0,0 +1,3 @@
+import type { Span } from '@opentelemetry/api';
+export type UxActionOutcome = 'success' | 'error';
+export declare function recordActionOnSpan(span: Span, targetId: string, outcome: UxActionOutcome): void;

package/dist/types/telemetry/uxBaggagePropagator.d.ts

@@ -0,0 +1,7 @@
+import { type Context, type TextMapGetter, type TextMapPropagator, type TextMapSetter } from '@opentelemetry/api';
+export declare class UxBaggagePropagator implements TextMapPropagator {
+    #private;
+    inject(ctx: Context, carrier: unknown, setter: TextMapSetter): void;
+    extract(ctx: Context, carrier: unknown, getter: TextMapGetter): Context;
+    fields(): string[];
+}

package/dist/types/telemetry/uxState.d.ts

@@ -0,0 +1,8 @@
+export type UxState = {
+    view?: string;
+    lastInteraction?: string;
+};
+export declare function getUxState(): Readonly<UxState>;
+export declare function setCurrentView(view: string | undefined): void;
+export declare function setLastInteraction(targetId: string | undefined): void;
+export declare function __resetUxStateForTests(): void;

package/dist/types/telemetry/uxStateSpanProcessor.d.ts

@@ -0,0 +1,9 @@
+import type { Context } from '@opentelemetry/api';
+import type { Span, SpanProcessor } from '@opentelemetry/sdk-trace-base';
+export declare function setCurrentUserId(userId: string | undefined): void;
+export declare class UxStateSpanProcessor implements SpanProcessor {
+    onStart(span: Span, _parentContext: Context): void;
+    onEnd(): void;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+}

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

@@ -1,7 +1,6 @@
 import { AxiosInstance } from 'axios';
-import Client, { EmailTheme, Network, OnRampAsset, OnRampProvider, PregenAuth, TWalletScheme, TWalletType } from '@getpara/user-management-client';
+import Client, { EmailTheme, Network, OnRampAsset, OnRampProvider, PregenAuth, SdkOverridableAppConfig, TWalletScheme, TWalletType, PartnerThemeConfig } 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",
@@ -95,7 +94,7 @@ export interface ConstructorOpts {
      * Theme to use for the portal
      * @deprecated configure theming through the developer portal
      */
-    portalTheme?: PortalTheme;
+    portalTheme?: PartnerThemeConfig;
     useDKLSForCreation?: boolean;
     disableWebSockets?: boolean;
     wasmOverride?: ArrayBuffer;
@@ -157,4 +156,17 @@ export interface ConstructorOpts {
      * @default false
      */
     enableDebugLogs?: boolean;
+    /**
+     * SDK-side overrides for partner-driven app config. Applied as the
+     * `#constructorOverrides` layer in `paraCore.config`'s merge chain. The React
+     * provider's `configOverrides` prop sits on top via a separate layer; React
+     * always wins when both surfaces touch the same key.
+     *
+     * Most partners should configure these in the developer portal — the constructor
+     * surface exists primarily for non-React contexts (`@getpara/server-sdk`,
+     * custom integrations) and dev-time iteration.
+     *
+     * The overridable subset is `SdkOverridableAppConfig`, enforced at compile time.
+     */
+    configOverrides?: Partial<SdkOverridableAppConfig>;
 }

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

@@ -1,9 +1,9 @@
-import { ExternalWalletInfo, OnRampPurchase, OnRampPurchaseCreateParams, Setup2faResponse, VerifiedAuth, WalletEntity, WalletParams, TWalletType, IssueJwtParams, IssueJwtResponse, TLinkedAccountType, LinkedAccounts, AuthMethod } from '@getpara/user-management-client';
+import { ExternalWalletInfo, OnRampPurchase, OnRampPurchaseCreateParams, Setup2faResponse, VerifiedAuth, WalletEntity, WalletParams, TWalletType, IssueJwtParams, IssueJwtResponse, TLinkedAccountType, LinkedAccounts, AuthMethod, DeliveryChannel } from '@getpara/user-management-client';
 import type { OAuthResponse, WithCustomTheme, WithUseShortUrls, Verify2faParams, Verify2faResponse, AuthStateSignup, StorageType, CoreAuthInfo, TelegramParams } from './';
 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, RequestFaucetParams, RequestFaucetResponse, UpdatePregenWalletIdentifierParams, BaseVerifyExternalWalletParams, AuthenticateWithEmailOrPhoneParams, AuthenticateWithEmailOrPhoneResponse, AuthenticateWithOAuthParams, AuthenticateWithOAuthResponse } from '../services/types';
+import type { WaitForLoginParams, WaitForLoginResponse, WaitForSignupParams, WaitForWalletCreationParams, WaitForWalletCreationResponse, GetOAuthUrlParams, AddCredentialParams, LoginExternalWalletParams, LoginExternalWalletResponse, ResendVerificationCodeParams, ResendVerificationCodeResponse, 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];
@@ -189,7 +189,7 @@ export type CoreMethods = Record<CoreMethodName, {
     };
     resendVerificationCode: {
         params: ResendVerificationCodeParams;
-        response: void;
+        response: ResendVerificationCodeResponse;
     };
     logout: {
         params: LogoutParams;
@@ -278,32 +278,26 @@ export type CoreMethods = Record<CoreMethodName, {
         params: CreateWalletPerTypeParams;
         response: CreateWalletPerTypeResponse;
     };
-    /** @deprecated Use the REST API instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     getPregenWallets: {
         params: GetPregenWalletsParams;
         response: GetPregenWalletsResponse;
     };
-    /** @deprecated Use the REST API instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     updatePregenWalletIdentifier: {
         params: UpdatePregenWalletIdentifierParams;
         response: void;
     };
-    /** @deprecated Use the REST API instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     hasPregenWallet: {
         params: HasPregenWalletParams;
         response: boolean;
     };
-    /** @deprecated Use the REST API instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     createPregenWallet: {
         params: CreatePregenWalletParams;
         response: CreatePregenWalletResponse;
     };
-    /** @deprecated Use the REST API instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     createPregenWalletPerType: {
         params: CreatePregenWalletPerTypeParams;
         response: CreatePregenWalletPerTypeResponse;
     };
-    /** @deprecated Use the REST API instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     claimPregenWallets: {
         params: ClaimPregenWalletsParams;
         response: ClaimPregenWalletsResponse;
@@ -429,6 +423,10 @@ export type InternalMethods = {
         params: void;
         response: {
             userId: string;
+            deliveryChannel?: DeliveryChannel;
+            fallbackUsed?: boolean;
+            fallbackChannel?: DeliveryChannel;
+            isSmsAllowed?: boolean;
         };
     };
     supportedUserAuthMethods: {

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 } from '@getpara/user-management-client';
-import type { Ctx, Environment, AccountLinkInProgress, ConstructorOpts, PortalTheme } from './index.js';
+import type { PartnerAppConfig, PartnerEntity, BackupKitEmailProps, VerificationEmailProps, TLinkedAccountType, PartnerThemeConfig } from '@getpara/user-management-client';
+import type { Ctx, Environment, AccountLinkInProgress, ConstructorOpts } from './index.js';
 import type { PlatformUtils } from '../PlatformUtils.js';
 import type { AuthService } from '../services/AuthService.js';
 import type { WalletService } from '../services/WalletService.js';
@@ -71,13 +71,15 @@ export interface PortalUrlServiceInterface {
     isPartnerOptional: boolean | undefined;
     ctx: Ctx;
     get loginEncryptionKeyPair(): pkiType.rsa.KeyPair | undefined;
-    portalTheme?: PortalTheme;
+    portalTheme?: PartnerThemeConfig;
     portalPrimaryButtonColor?: string;
     portalTextColor?: string;
     portalPrimaryButtonTextColor?: string;
     portalBackgroundColor?: string;
     borderRadius?: string;
     get accountLinkInProgress(): AccountLinkInProgress | undefined;
+    /** Merged partner-config surface (partner ⊕ SDK overrides); `{}` before the partner record loads. */
+    get config(): PartnerAppConfig;
 }
 export interface SessionManagementServiceInterface {
     displayModalError: (error?: string) => void;

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

@@ -1,17 +1,4 @@
-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>;
-};
+import { TAuthMethod, PartnerThemeConfig } from '@getpara/user-management-client';
 export type WithAuthMethod = {
     /**
      * Which authorization method to use for the URL, either `'PASSKEY'`, `'PASSWORD'` or `'PIN'`.
@@ -22,7 +9,7 @@ export type WithCustomTheme = {
     /**
      * The theme to apply to generated URLs, if different from your configured theme.
      */
-    portalTheme?: PortalTheme;
+    portalTheme?: PartnerThemeConfig;
 };
 export type WithUseShortUrls = {
     /**

package/dist/types/utils/configEncoding.d.ts

@@ -0,0 +1,51 @@
+import type { PartnerThemeConfig } from '@getpara/user-management-client';
+/**
+ * Versioned envelope carried by the optional `c` URL search param when the
+ * plain-form portal URL would exceed the tier-1 length threshold. Mirrors the
+ * top-level shape of the partner config blob (theme + app slices); the auth
+ * slice was intentionally omitted since the portal renders no
+ * auth-method-selection UI and the params had no consumer.
+ *
+ * `v` is required and acts as the compat key. The portal validates it on
+ * decode and silently falls back to individual URL params on unknown versions
+ * — so future schema evolution (e.g. adding an auth slice if portal-side
+ * gating ever ships) is BW-compat: older portals just ignore the blob.
+ */
+export declare const ENCODED_CONFIG_VERSION: 1;
+export type EncodedAppConfig = {
+    appName?: string;
+    homepageUrl?: string;
+};
+export type EncodedConfig = {
+    v: typeof ENCODED_CONFIG_VERSION;
+    theme?: PartnerThemeConfig;
+    app?: EncodedAppConfig;
+};
+/**
+ * Feature detection — `CompressionStream` lands in Chrome 80 (2020), Firefox 113
+ * (May 2023), and Safari 16.4 (March 2023). The current portal browserslist
+ * resolves a minimum of iOS Safari 15.6 + Safari 15.6, which DON'T have it.
+ *
+ * On unsupported browsers, the SDK skips tier 2 emission and lets the portal
+ * URL fall through to tier 3 (`shortenUrl`) at the cost of ~150ms RTT. Adding
+ * a sync pako fallback (~45 KB on the cold path) is an option if iOS 15.x
+ * latency on long-URL flows becomes a real complaint — the seam lives here.
+ */
+export declare function isCompressionStreamSupported(): boolean;
+/**
+ * Encode the config blob as `base64url(gzip(JSON))`. Async because both
+ * `CompressionStream` (encode side) and `DecompressionStream` (decode side)
+ * are Streams API and produce async output.
+ *
+ * Returns `null` when `CompressionStream` is unavailable so callers can
+ * gracefully degrade to tier 3 instead of throwing.
+ */
+export declare function encodeConfigParams(config: EncodedConfig): Promise<string | null>;
+/**
+ * Inverse of `encodeConfigParams`. Never throws — returns `null` on any
+ * failure (corrupt base64, invalid gzip, invalid JSON, unknown `v`, etc.)
+ * so the portal can silently fall back to individual URL params.
+ *
+ * Async because `DecompressionStream` is part of the Streams API.
+ */
+export declare function tryDecodeConfig(s: string): Promise<EncodedConfig | null>;

package/dist/types/utils/deprecation.d.ts

@@ -1 +1,3 @@
-export declare function warnPregenDeprecation(methodName: string): void;
+export declare function warnOnce(scope: string, key: string, message: string): void;
+/** Test-only: clear the warned set so tests can assert "warns once" across cases. */
+export declare function _resetWarnOnceForTests(): void;

package/dist/types/utils/index.d.ts

@@ -1,10 +1,12 @@
 export * from './autobind.js';
 export * from './config.js';
+export { warnOnce } from './deprecation.js';
 export * from './events.js';
 export * from './formatting.js';
 export * from './json.js';
 export * from './listeners.js';
 export * from './onRamps.js';
+export * from './partnerConfig.js';
 export * from './phone.js';
 export * from './polling.js';
 export * from './types.js';