@proofchain/sdk 2.9.0 → 2.10.0

package/dist/index.d.mts

@@ -1115,7 +1115,7 @@ interface UserWalletSummary {
         };
     }>;
 }
-interface CreateWalletRequest {
+interface CreateWalletRequest$1 {
     user_id: string;
     wallet_type?: 'eoa' | 'smart' | 'solana';
     network?: string;
@@ -1268,7 +1268,7 @@ declare class WalletClient {
     /**
      * Create a single wallet for a user
      */
-    create(data: CreateWalletRequest): Promise<Wallet>;
+    create(data: CreateWalletRequest$1): Promise<Wallet>;
     /**
      * Get a wallet by ID
      */
@@ -1562,6 +1562,7 @@ interface ListEndUsersOptions {
     status?: string;
     segment?: string;
     has_wallet?: boolean;
+    min_events?: number;
     sort_by?: string;
     sort_order?: 'asc' | 'desc';
 }
@@ -1571,9 +1572,78 @@ interface LinkWalletRequest {
     signature?: string;
 }
 interface MergeUsersRequest {
-    source_user_id: string;
+    source_user_ids: string[];
     target_user_id: string;
 }
+interface CreateWalletRequest {
+    wallet_type?: string;
+    network?: string;
+}
+interface RegisterWalletRequest {
+    wallet_address: string;
+    signature?: string;
+}
+interface UserReward {
+    id: string;
+    reward_name: string;
+    reward_type: string;
+    value?: number;
+    value_currency?: string;
+    status: string;
+    earned_at?: string;
+    distributed_at?: string;
+    nft_token_id?: number;
+    nft_tx_hash?: string;
+}
+interface UserRewardsResponse {
+    user_id: string;
+    rewards: UserReward[];
+    total: number;
+    page: number;
+    page_size: number;
+    has_more: boolean;
+}
+interface GDPRDeletionRequest {
+    confirm: boolean;
+    delete_events?: boolean;
+    delete_wallets?: boolean;
+    reason?: string;
+}
+interface GDPRDeletionResponse {
+    success: boolean;
+    user_id: string;
+    external_id: string;
+    deleted_records: Record<string, number>;
+    merkle_warning?: string;
+    audit_id?: string;
+}
+interface GDPRPreviewResponse {
+    user: Record<string, any>;
+    would_delete: Record<string, number>;
+    merkle_warning?: string;
+}
+interface WalletCreationResult {
+    success: boolean;
+    user_id: string;
+    wallet_address: string;
+    wallet_type?: string;
+    network?: string;
+    source: string;
+}
+interface SetProfileRequest {
+    email?: string;
+    first_name?: string;
+    last_name?: string;
+    display_name?: string;
+    avatar_url?: string;
+    phone?: string;
+    date_of_birth?: string;
+    country?: string;
+    city?: string;
+    timezone?: string;
+    language?: string;
+    bio?: string;
+}
 declare class EndUsersClient {
     private http;
     constructor(http: HttpClient);
@@ -1622,9 +1692,84 @@ declare class EndUsersClient {
      */
     merge(request: MergeUsersRequest): Promise<EndUser>;
     /**
-     * Update user attributes (convenience method) by external ID
+     * Update an end-user profile by internal UUID
+     */
+    updateByInternalId(userId: string, data: UpdateEndUserRequest): Promise<EndUser>;
+    /**
+     * Get user rewards by external ID
+     */
+    getRewards(externalId: string, options?: {
+        status?: string;
+        page?: number;
+        page_size?: number;
+    }): Promise<UserRewardsResponse>;
+    /**
+     * Get user rewards by internal UUID
+     */
+    getRewardsByInternalId(userId: string, options?: {
+        status?: string;
+        page?: number;
+        page_size?: number;
+    }): Promise<UserRewardsResponse>;
+    /**
+     * Create a CDP (custodial) wallet for an end-user by external ID
+     */
+    createWallet(externalId: string, request?: CreateWalletRequest): Promise<WalletCreationResult>;
+    /**
+     * Register an external wallet for an end-user by external ID
+     */
+    registerWallet(externalId: string, request: RegisterWalletRequest): Promise<WalletCreationResult>;
+    /**
+     * Ensure a user has a wallet, creating one if they don't.
+     *
+     * This is the recommended way for frontend devs to guarantee a wallet
+     * exists before performing any wallet-dependent operation (e.g. attestation,
+     * on-chain claims, token transfers).
+     *
+     * If the user already has a wallet, returns immediately with the existing
+     * address. If not, creates a CDP wallet with the specified options.
+     *
+     * @param externalId - The user's external ID
+     * @param options - Wallet creation options (only used if a new wallet is created)
+     * @returns Wallet result with address and creation status
+     *
+     * @example
+     * ```typescript
+     * // One-liner before any wallet-dependent operation
+     * const wallet = await client.users.ensureWallet('user-123');
+     * console.log(wallet.wallet_address); // '0xabc...'
+     *
+     * // With options
+     * const wallet = await client.users.ensureWallet('user-123', {
+     *   wallet_type: 'eoa',
+     *   network: 'base-mainnet',
+     * });
+     * ```
+     */
+    ensureWallet(externalId: string, options?: CreateWalletRequest): Promise<WalletCreationResult>;
+    /**
+     * Update user attributes (convenience method) by external ID.
+     * Merges the provided attributes into the existing attributes object.
      */
     updateAttributes(externalId: string, attributes: Record<string, any>): Promise<EndUser>;
+    /**
+     * Remove specific attributes from a user by external ID.
+     * Fetches current attributes, removes the specified keys, and saves.
+     */
+    removeAttributes(externalId: string, keys: string[]): Promise<EndUser>;
+    /**
+     * Set profile fields (convenience method) by external ID.
+     * Only updates the fields provided, leaving others unchanged.
+     */
+    setProfile(externalId: string, profile: SetProfileRequest): Promise<EndUser>;
+    /**
+     * Preview what would be deleted for a GDPR request
+     */
+    gdprPreview(userId: string): Promise<GDPRPreviewResponse>;
+    /**
+     * GDPR Right to Be Forgotten - permanently delete all user data
+     */
+    gdprDelete(userId: string, request: GDPRDeletionRequest): Promise<GDPRDeletionResponse>;
     /**
      * Export users as CSV
      */
@@ -2984,4 +3129,4 @@ declare class TimeoutError extends ProofChainError {
     constructor(message?: string);
 }
 
-export { type Achievement, type ActivitySummaryView, type AddNFTRequest, type ApiKey, type AttestRequest, type AttestationMode, type AttestationResult, AuthenticationError, AuthorizationError, type AvailableView, type Badge, type BatchIngestRequest, type BatchIngestResponse, type BatchVerifyResult, type BlockchainProof, type BlockchainStats, type Certificate, type CertificateVerifyResult, CertificatesResource, type Channel, type ChannelState, type ChannelStatus, ChannelsResource, type ClaimRewardResult, type CohortDefinition, type CohortGroupStats, CohortLeaderboardClient, type CohortLeaderboardEntry, type CohortLeaderboardOptions, type CohortLeaderboardResponse, type ComprehensiveWalletInfo, type CreateAchievementRequest, type CreateApiKeyRequest, type CreateBadgeRequest, type CreateChannelRequest, type CreateDataViewRequest, type CreateDualWalletsRequest, type CreateEndUserRequest, type CreateEventRequest, type CreatePassportDefinitionRequest, type CreatePassportRequest, type CreateQuestRequest, type CreateQuestStepRequest, type CreateRewardDefinitionRequest, type CreateSchemaRequest, type CreateTemplateFieldRequest, type CreateTemplateRequest, type CreateWalletRequest, type CreateWebhookRequest, type DataViewColumn, type DataViewComputation, type DataViewDetail, type DataViewExecuteResult, type DataViewInfo, type DataViewListResponse, type DataViewPreviewRequest, type DataViewPreviewResult, type DataViewSummary, DataViewsClient, DocumentsResource, type DualWallets, type EarnedReward, type EndUser, type EndUserListResponse, EndUsersClient, type Event, type EventBatchProof, type EventMetadata, type EventStatus, EventsResource, type ExecuteSwapRequest, type Facet, type FacetsResponse, type FanProfileView, type FanpassGroupStats, FanpassLeaderboardClient, type FanpassLeaderboardEntry, type FanpassLeaderboardOptions, type FanpassLeaderboardResponse, type FanpassUserComparisonResponse, type FieldValue, type IngestEventRequest, type IngestEventResponse, IngestionClient, type IngestionClientOptions, type IssueCertificateRequest, type LeaderboardUserProfile$1 as LeaderboardUserProfile, type LinkWalletRequest, type ListCertificatesRequest, type ListCohortsOptions, type ListEndUsersOptions, type ListEventsRequest, type ListQuestsOptions, type ListRewardsOptions, type ListSchemasOptions, type ManualRewardRequest, type MergeUsersRequest, type Milestone, type NFT, NetworkError, NotFoundError, type Passport, PassportClient, type PassportDefinition, type PassportFieldValue, type PassportHistory, type PassportTemplate, type PassportV2Data, type PassportWithFields, ProofChain, ProofChainError, type ProofChainOptions, type ProofVerifyResult, type Quest, type QuestStep, type QuestWithProgress, QuestsClient, RateLimitError, type RewardAsset, type RewardDefinition, type RewardEarned, RewardsClient, type Schema, type SchemaDetail, type SchemaField, type SchemaListResponse, type ValidationError$1 as SchemaValidationError, SchemasClient, type SearchFilters, type SearchQueryRequest, type SearchRequest, SearchResource, type SearchResponse, type SearchResult, type SearchStats, ServerError, type Settlement, type StepCompletionResult, type StepProgress, type StreamAck, type StreamEventRequest, type SwapQuote, type SwapQuoteRequest, type SwapResult, type TemplateField, type TenantInfo, TenantResource, type TierDefinition, TimeoutError, type TokenBalance, type TransferRequest, type TransferResult, type UpdateDataViewRequest, type UpdateEndUserRequest, type UpdatePassportRequest, type UpdateWebhookRequest, type UsageStats, type UserAchievement, type UserActivity, type UserActivityResponse, type UserBadge, type UserBreakdownResponse, type UserCohortBreakdownEntry, type UserQuestProgress, type UserWalletSummary, type UserWithWallets, type UsersWithWalletsResponse, type ValidateDataRequest, ValidationError, type ValidationErrorDetail, type ValidationResult, type VaultFile, type VaultFolder, type VaultListResponse, VaultResource, type VaultStats, type VaultUploadRequest, type VerificationResult, VerifyResource, type ViewColumn, type ViewTemplate, type Wallet, type WalletBalance, WalletClient, type WalletStats, type Webhook, WebhooksResource };
+export { type Achievement, type ActivitySummaryView, type AddNFTRequest, type ApiKey, type AttestRequest, type AttestationMode, type AttestationResult, AuthenticationError, AuthorizationError, type AvailableView, type Badge, type BatchIngestRequest, type BatchIngestResponse, type BatchVerifyResult, type BlockchainProof, type BlockchainStats, type Certificate, type CertificateVerifyResult, CertificatesResource, type Channel, type ChannelState, type ChannelStatus, ChannelsResource, type ClaimRewardResult, type CohortDefinition, type CohortGroupStats, CohortLeaderboardClient, type CohortLeaderboardEntry, type CohortLeaderboardOptions, type CohortLeaderboardResponse, type ComprehensiveWalletInfo, type CreateAchievementRequest, type CreateApiKeyRequest, type CreateBadgeRequest, type CreateChannelRequest, type CreateDataViewRequest, type CreateDualWalletsRequest, type CreateEndUserRequest, type CreateEventRequest, type CreatePassportDefinitionRequest, type CreatePassportRequest, type CreateQuestRequest, type CreateQuestStepRequest, type CreateRewardDefinitionRequest, type CreateSchemaRequest, type CreateTemplateFieldRequest, type CreateTemplateRequest, type CreateWalletRequest as CreateUserWalletRequest, type CreateWalletRequest$1 as CreateWalletRequest, type CreateWebhookRequest, type DataViewColumn, type DataViewComputation, type DataViewDetail, type DataViewExecuteResult, type DataViewInfo, type DataViewListResponse, type DataViewPreviewRequest, type DataViewPreviewResult, type DataViewSummary, DataViewsClient, DocumentsResource, type DualWallets, type EarnedReward, type EndUser, type EndUserListResponse, EndUsersClient, type Event, type EventBatchProof, type EventMetadata, type EventStatus, EventsResource, type ExecuteSwapRequest, type Facet, type FacetsResponse, type FanProfileView, type FanpassGroupStats, FanpassLeaderboardClient, type FanpassLeaderboardEntry, type FanpassLeaderboardOptions, type FanpassLeaderboardResponse, type FanpassUserComparisonResponse, type FieldValue, type GDPRDeletionRequest, type GDPRDeletionResponse, type GDPRPreviewResponse, type IngestEventRequest, type IngestEventResponse, IngestionClient, type IngestionClientOptions, type IssueCertificateRequest, type LeaderboardUserProfile$1 as LeaderboardUserProfile, type LinkWalletRequest, type ListCertificatesRequest, type ListCohortsOptions, type ListEndUsersOptions, type ListEventsRequest, type ListQuestsOptions, type ListRewardsOptions, type ListSchemasOptions, type ManualRewardRequest, type MergeUsersRequest, type Milestone, type NFT, NetworkError, NotFoundError, type Passport, PassportClient, type PassportDefinition, type PassportFieldValue, type PassportHistory, type PassportTemplate, type PassportV2Data, type PassportWithFields, ProofChain, ProofChainError, type ProofChainOptions, type ProofVerifyResult, type Quest, type QuestStep, type QuestWithProgress, QuestsClient, RateLimitError, type RegisterWalletRequest, type RewardAsset, type RewardDefinition, type RewardEarned, RewardsClient, type Schema, type SchemaDetail, type SchemaField, type SchemaListResponse, type ValidationError$1 as SchemaValidationError, SchemasClient, type SearchFilters, type SearchQueryRequest, type SearchRequest, SearchResource, type SearchResponse, type SearchResult, type SearchStats, ServerError, type SetProfileRequest, type Settlement, type StepCompletionResult, type StepProgress, type StreamAck, type StreamEventRequest, type SwapQuote, type SwapQuoteRequest, type SwapResult, type TemplateField, type TenantInfo, TenantResource, type TierDefinition, TimeoutError, type TokenBalance, type TransferRequest, type TransferResult, type UpdateDataViewRequest, type UpdateEndUserRequest, type UpdatePassportRequest, type UpdateWebhookRequest, type UsageStats, type UserAchievement, type UserActivity, type UserActivityResponse, type UserBadge, type UserBreakdownResponse, type UserCohortBreakdownEntry, type UserQuestProgress, type UserReward, type UserRewardsResponse, type UserWalletSummary, type UserWithWallets, type UsersWithWalletsResponse, type ValidateDataRequest, ValidationError, type ValidationErrorDetail, type ValidationResult, type VaultFile, type VaultFolder, type VaultListResponse, VaultResource, type VaultStats, type VaultUploadRequest, type VerificationResult, VerifyResource, type ViewColumn, type ViewTemplate, type Wallet, type WalletBalance, WalletClient, type WalletCreationResult, type WalletStats, type Webhook, WebhooksResource };

package/dist/index.d.ts

@@ -1115,7 +1115,7 @@ interface UserWalletSummary {
         };
     }>;
 }
-interface CreateWalletRequest {
+interface CreateWalletRequest$1 {
     user_id: string;
     wallet_type?: 'eoa' | 'smart' | 'solana';
     network?: string;
@@ -1268,7 +1268,7 @@ declare class WalletClient {
     /**
      * Create a single wallet for a user
      */
-    create(data: CreateWalletRequest): Promise<Wallet>;
+    create(data: CreateWalletRequest$1): Promise<Wallet>;
     /**
      * Get a wallet by ID
      */
@@ -1562,6 +1562,7 @@ interface ListEndUsersOptions {
     status?: string;
     segment?: string;
     has_wallet?: boolean;
+    min_events?: number;
     sort_by?: string;
     sort_order?: 'asc' | 'desc';
 }
@@ -1571,9 +1572,78 @@ interface LinkWalletRequest {
     signature?: string;
 }
 interface MergeUsersRequest {
-    source_user_id: string;
+    source_user_ids: string[];
     target_user_id: string;
 }
+interface CreateWalletRequest {
+    wallet_type?: string;
+    network?: string;
+}
+interface RegisterWalletRequest {
+    wallet_address: string;
+    signature?: string;
+}
+interface UserReward {
+    id: string;
+    reward_name: string;
+    reward_type: string;
+    value?: number;
+    value_currency?: string;
+    status: string;
+    earned_at?: string;
+    distributed_at?: string;
+    nft_token_id?: number;
+    nft_tx_hash?: string;
+}
+interface UserRewardsResponse {
+    user_id: string;
+    rewards: UserReward[];
+    total: number;
+    page: number;
+    page_size: number;
+    has_more: boolean;
+}
+interface GDPRDeletionRequest {
+    confirm: boolean;
+    delete_events?: boolean;
+    delete_wallets?: boolean;
+    reason?: string;
+}
+interface GDPRDeletionResponse {
+    success: boolean;
+    user_id: string;
+    external_id: string;
+    deleted_records: Record<string, number>;
+    merkle_warning?: string;
+    audit_id?: string;
+}
+interface GDPRPreviewResponse {
+    user: Record<string, any>;
+    would_delete: Record<string, number>;
+    merkle_warning?: string;
+}
+interface WalletCreationResult {
+    success: boolean;
+    user_id: string;
+    wallet_address: string;
+    wallet_type?: string;
+    network?: string;
+    source: string;
+}
+interface SetProfileRequest {
+    email?: string;
+    first_name?: string;
+    last_name?: string;
+    display_name?: string;
+    avatar_url?: string;
+    phone?: string;
+    date_of_birth?: string;
+    country?: string;
+    city?: string;
+    timezone?: string;
+    language?: string;
+    bio?: string;
+}
 declare class EndUsersClient {
     private http;
     constructor(http: HttpClient);
@@ -1622,9 +1692,84 @@ declare class EndUsersClient {
      */
     merge(request: MergeUsersRequest): Promise<EndUser>;
     /**
-     * Update user attributes (convenience method) by external ID
+     * Update an end-user profile by internal UUID
+     */
+    updateByInternalId(userId: string, data: UpdateEndUserRequest): Promise<EndUser>;
+    /**
+     * Get user rewards by external ID
+     */
+    getRewards(externalId: string, options?: {
+        status?: string;
+        page?: number;
+        page_size?: number;
+    }): Promise<UserRewardsResponse>;
+    /**
+     * Get user rewards by internal UUID
+     */
+    getRewardsByInternalId(userId: string, options?: {
+        status?: string;
+        page?: number;
+        page_size?: number;
+    }): Promise<UserRewardsResponse>;
+    /**
+     * Create a CDP (custodial) wallet for an end-user by external ID
+     */
+    createWallet(externalId: string, request?: CreateWalletRequest): Promise<WalletCreationResult>;
+    /**
+     * Register an external wallet for an end-user by external ID
+     */
+    registerWallet(externalId: string, request: RegisterWalletRequest): Promise<WalletCreationResult>;
+    /**
+     * Ensure a user has a wallet, creating one if they don't.
+     *
+     * This is the recommended way for frontend devs to guarantee a wallet
+     * exists before performing any wallet-dependent operation (e.g. attestation,
+     * on-chain claims, token transfers).
+     *
+     * If the user already has a wallet, returns immediately with the existing
+     * address. If not, creates a CDP wallet with the specified options.
+     *
+     * @param externalId - The user's external ID
+     * @param options - Wallet creation options (only used if a new wallet is created)
+     * @returns Wallet result with address and creation status
+     *
+     * @example
+     * ```typescript
+     * // One-liner before any wallet-dependent operation
+     * const wallet = await client.users.ensureWallet('user-123');
+     * console.log(wallet.wallet_address); // '0xabc...'
+     *
+     * // With options
+     * const wallet = await client.users.ensureWallet('user-123', {
+     *   wallet_type: 'eoa',
+     *   network: 'base-mainnet',
+     * });
+     * ```
+     */
+    ensureWallet(externalId: string, options?: CreateWalletRequest): Promise<WalletCreationResult>;
+    /**
+     * Update user attributes (convenience method) by external ID.
+     * Merges the provided attributes into the existing attributes object.
      */
     updateAttributes(externalId: string, attributes: Record<string, any>): Promise<EndUser>;
+    /**
+     * Remove specific attributes from a user by external ID.
+     * Fetches current attributes, removes the specified keys, and saves.
+     */
+    removeAttributes(externalId: string, keys: string[]): Promise<EndUser>;
+    /**
+     * Set profile fields (convenience method) by external ID.
+     * Only updates the fields provided, leaving others unchanged.
+     */
+    setProfile(externalId: string, profile: SetProfileRequest): Promise<EndUser>;
+    /**
+     * Preview what would be deleted for a GDPR request
+     */
+    gdprPreview(userId: string): Promise<GDPRPreviewResponse>;
+    /**
+     * GDPR Right to Be Forgotten - permanently delete all user data
+     */
+    gdprDelete(userId: string, request: GDPRDeletionRequest): Promise<GDPRDeletionResponse>;
     /**
      * Export users as CSV
      */
@@ -2984,4 +3129,4 @@ declare class TimeoutError extends ProofChainError {
     constructor(message?: string);
 }
 
-export { type Achievement, type ActivitySummaryView, type AddNFTRequest, type ApiKey, type AttestRequest, type AttestationMode, type AttestationResult, AuthenticationError, AuthorizationError, type AvailableView, type Badge, type BatchIngestRequest, type BatchIngestResponse, type BatchVerifyResult, type BlockchainProof, type BlockchainStats, type Certificate, type CertificateVerifyResult, CertificatesResource, type Channel, type ChannelState, type ChannelStatus, ChannelsResource, type ClaimRewardResult, type CohortDefinition, type CohortGroupStats, CohortLeaderboardClient, type CohortLeaderboardEntry, type CohortLeaderboardOptions, type CohortLeaderboardResponse, type ComprehensiveWalletInfo, type CreateAchievementRequest, type CreateApiKeyRequest, type CreateBadgeRequest, type CreateChannelRequest, type CreateDataViewRequest, type CreateDualWalletsRequest, type CreateEndUserRequest, type CreateEventRequest, type CreatePassportDefinitionRequest, type CreatePassportRequest, type CreateQuestRequest, type CreateQuestStepRequest, type CreateRewardDefinitionRequest, type CreateSchemaRequest, type CreateTemplateFieldRequest, type CreateTemplateRequest, type CreateWalletRequest, type CreateWebhookRequest, type DataViewColumn, type DataViewComputation, type DataViewDetail, type DataViewExecuteResult, type DataViewInfo, type DataViewListResponse, type DataViewPreviewRequest, type DataViewPreviewResult, type DataViewSummary, DataViewsClient, DocumentsResource, type DualWallets, type EarnedReward, type EndUser, type EndUserListResponse, EndUsersClient, type Event, type EventBatchProof, type EventMetadata, type EventStatus, EventsResource, type ExecuteSwapRequest, type Facet, type FacetsResponse, type FanProfileView, type FanpassGroupStats, FanpassLeaderboardClient, type FanpassLeaderboardEntry, type FanpassLeaderboardOptions, type FanpassLeaderboardResponse, type FanpassUserComparisonResponse, type FieldValue, type IngestEventRequest, type IngestEventResponse, IngestionClient, type IngestionClientOptions, type IssueCertificateRequest, type LeaderboardUserProfile$1 as LeaderboardUserProfile, type LinkWalletRequest, type ListCertificatesRequest, type ListCohortsOptions, type ListEndUsersOptions, type ListEventsRequest, type ListQuestsOptions, type ListRewardsOptions, type ListSchemasOptions, type ManualRewardRequest, type MergeUsersRequest, type Milestone, type NFT, NetworkError, NotFoundError, type Passport, PassportClient, type PassportDefinition, type PassportFieldValue, type PassportHistory, type PassportTemplate, type PassportV2Data, type PassportWithFields, ProofChain, ProofChainError, type ProofChainOptions, type ProofVerifyResult, type Quest, type QuestStep, type QuestWithProgress, QuestsClient, RateLimitError, type RewardAsset, type RewardDefinition, type RewardEarned, RewardsClient, type Schema, type SchemaDetail, type SchemaField, type SchemaListResponse, type ValidationError$1 as SchemaValidationError, SchemasClient, type SearchFilters, type SearchQueryRequest, type SearchRequest, SearchResource, type SearchResponse, type SearchResult, type SearchStats, ServerError, type Settlement, type StepCompletionResult, type StepProgress, type StreamAck, type StreamEventRequest, type SwapQuote, type SwapQuoteRequest, type SwapResult, type TemplateField, type TenantInfo, TenantResource, type TierDefinition, TimeoutError, type TokenBalance, type TransferRequest, type TransferResult, type UpdateDataViewRequest, type UpdateEndUserRequest, type UpdatePassportRequest, type UpdateWebhookRequest, type UsageStats, type UserAchievement, type UserActivity, type UserActivityResponse, type UserBadge, type UserBreakdownResponse, type UserCohortBreakdownEntry, type UserQuestProgress, type UserWalletSummary, type UserWithWallets, type UsersWithWalletsResponse, type ValidateDataRequest, ValidationError, type ValidationErrorDetail, type ValidationResult, type VaultFile, type VaultFolder, type VaultListResponse, VaultResource, type VaultStats, type VaultUploadRequest, type VerificationResult, VerifyResource, type ViewColumn, type ViewTemplate, type Wallet, type WalletBalance, WalletClient, type WalletStats, type Webhook, WebhooksResource };
+export { type Achievement, type ActivitySummaryView, type AddNFTRequest, type ApiKey, type AttestRequest, type AttestationMode, type AttestationResult, AuthenticationError, AuthorizationError, type AvailableView, type Badge, type BatchIngestRequest, type BatchIngestResponse, type BatchVerifyResult, type BlockchainProof, type BlockchainStats, type Certificate, type CertificateVerifyResult, CertificatesResource, type Channel, type ChannelState, type ChannelStatus, ChannelsResource, type ClaimRewardResult, type CohortDefinition, type CohortGroupStats, CohortLeaderboardClient, type CohortLeaderboardEntry, type CohortLeaderboardOptions, type CohortLeaderboardResponse, type ComprehensiveWalletInfo, type CreateAchievementRequest, type CreateApiKeyRequest, type CreateBadgeRequest, type CreateChannelRequest, type CreateDataViewRequest, type CreateDualWalletsRequest, type CreateEndUserRequest, type CreateEventRequest, type CreatePassportDefinitionRequest, type CreatePassportRequest, type CreateQuestRequest, type CreateQuestStepRequest, type CreateRewardDefinitionRequest, type CreateSchemaRequest, type CreateTemplateFieldRequest, type CreateTemplateRequest, type CreateWalletRequest as CreateUserWalletRequest, type CreateWalletRequest$1 as CreateWalletRequest, type CreateWebhookRequest, type DataViewColumn, type DataViewComputation, type DataViewDetail, type DataViewExecuteResult, type DataViewInfo, type DataViewListResponse, type DataViewPreviewRequest, type DataViewPreviewResult, type DataViewSummary, DataViewsClient, DocumentsResource, type DualWallets, type EarnedReward, type EndUser, type EndUserListResponse, EndUsersClient, type Event, type EventBatchProof, type EventMetadata, type EventStatus, EventsResource, type ExecuteSwapRequest, type Facet, type FacetsResponse, type FanProfileView, type FanpassGroupStats, FanpassLeaderboardClient, type FanpassLeaderboardEntry, type FanpassLeaderboardOptions, type FanpassLeaderboardResponse, type FanpassUserComparisonResponse, type FieldValue, type GDPRDeletionRequest, type GDPRDeletionResponse, type GDPRPreviewResponse, type IngestEventRequest, type IngestEventResponse, IngestionClient, type IngestionClientOptions, type IssueCertificateRequest, type LeaderboardUserProfile$1 as LeaderboardUserProfile, type LinkWalletRequest, type ListCertificatesRequest, type ListCohortsOptions, type ListEndUsersOptions, type ListEventsRequest, type ListQuestsOptions, type ListRewardsOptions, type ListSchemasOptions, type ManualRewardRequest, type MergeUsersRequest, type Milestone, type NFT, NetworkError, NotFoundError, type Passport, PassportClient, type PassportDefinition, type PassportFieldValue, type PassportHistory, type PassportTemplate, type PassportV2Data, type PassportWithFields, ProofChain, ProofChainError, type ProofChainOptions, type ProofVerifyResult, type Quest, type QuestStep, type QuestWithProgress, QuestsClient, RateLimitError, type RegisterWalletRequest, type RewardAsset, type RewardDefinition, type RewardEarned, RewardsClient, type Schema, type SchemaDetail, type SchemaField, type SchemaListResponse, type ValidationError$1 as SchemaValidationError, SchemasClient, type SearchFilters, type SearchQueryRequest, type SearchRequest, SearchResource, type SearchResponse, type SearchResult, type SearchStats, ServerError, type SetProfileRequest, type Settlement, type StepCompletionResult, type StepProgress, type StreamAck, type StreamEventRequest, type SwapQuote, type SwapQuoteRequest, type SwapResult, type TemplateField, type TenantInfo, TenantResource, type TierDefinition, TimeoutError, type TokenBalance, type TransferRequest, type TransferResult, type UpdateDataViewRequest, type UpdateEndUserRequest, type UpdatePassportRequest, type UpdateWebhookRequest, type UsageStats, type UserAchievement, type UserActivity, type UserActivityResponse, type UserBadge, type UserBreakdownResponse, type UserCohortBreakdownEntry, type UserQuestProgress, type UserReward, type UserRewardsResponse, type UserWalletSummary, type UserWithWallets, type UsersWithWalletsResponse, type ValidateDataRequest, ValidationError, type ValidationErrorDetail, type ValidationResult, type VaultFile, type VaultFolder, type VaultListResponse, VaultResource, type VaultStats, type VaultUploadRequest, type VerificationResult, VerifyResource, type ViewColumn, type ViewTemplate, type Wallet, type WalletBalance, WalletClient, type WalletCreationResult, type WalletStats, type Webhook, WebhooksResource };

package/dist/index.js

@@ -1143,6 +1143,7 @@ var EndUsersClient = class {
     if (options.status) params.append("status", options.status);
     if (options.segment) params.append("segment", options.segment);
     if (options.has_wallet !== void 0) params.append("has_wallet", options.has_wallet.toString());
+    if (options.min_events !== void 0) params.append("min_events", options.min_events.toString());
     if (options.sort_by) params.append("sort_by", options.sort_by);
     if (options.sort_order) params.append("sort_order", options.sort_order);
     return this.http.get(`/end-users?${params.toString()}`);
@@ -1209,11 +1210,121 @@ var EndUsersClient = class {
     return this.http.post("/end-users/merge", request);
   }
   /**
-   * Update user attributes (convenience method) by external ID
+   * Update an end-user profile by internal UUID
+   */
+  async updateByInternalId(userId, data) {
+    return this.http.patch(`/end-users/${userId}`, data);
+  }
+  /**
+   * Get user rewards by external ID
+   */
+  async getRewards(externalId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.status) params.append("status", options.status);
+    if (options.page) params.append("page", options.page.toString());
+    if (options.page_size) params.append("page_size", options.page_size.toString());
+    return this.http.get(`/end-users/by-external/${encodeURIComponent(externalId)}/rewards?${params.toString()}`);
+  }
+  /**
+   * Get user rewards by internal UUID
+   */
+  async getRewardsByInternalId(userId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.status) params.append("status", options.status);
+    if (options.page) params.append("page", options.page.toString());
+    if (options.page_size) params.append("page_size", options.page_size.toString());
+    return this.http.get(`/end-users/${userId}/rewards?${params.toString()}`);
+  }
+  /**
+   * Create a CDP (custodial) wallet for an end-user by external ID
+   */
+  async createWallet(externalId, request = {}) {
+    return this.http.post(`/end-users/by-external/${encodeURIComponent(externalId)}/create-wallet`, request);
+  }
+  /**
+   * Register an external wallet for an end-user by external ID
+   */
+  async registerWallet(externalId, request) {
+    return this.http.post(`/end-users/by-external/${encodeURIComponent(externalId)}/register-wallet`, request);
+  }
+  /**
+   * Ensure a user has a wallet, creating one if they don't.
+   *
+   * This is the recommended way for frontend devs to guarantee a wallet
+   * exists before performing any wallet-dependent operation (e.g. attestation,
+   * on-chain claims, token transfers).
+   *
+   * If the user already has a wallet, returns immediately with the existing
+   * address. If not, creates a CDP wallet with the specified options.
+   *
+   * @param externalId - The user's external ID
+   * @param options - Wallet creation options (only used if a new wallet is created)
+   * @returns Wallet result with address and creation status
+   *
+   * @example
+   * ```typescript
+   * // One-liner before any wallet-dependent operation
+   * const wallet = await client.users.ensureWallet('user-123');
+   * console.log(wallet.wallet_address); // '0xabc...'
+   *
+   * // With options
+   * const wallet = await client.users.ensureWallet('user-123', {
+   *   wallet_type: 'eoa',
+   *   network: 'base-mainnet',
+   * });
+   * ```
+   */
+  async ensureWallet(externalId, options = {}) {
+    const user = await this.get(externalId);
+    if (user.wallet_address) {
+      return {
+        success: true,
+        user_id: externalId,
+        wallet_address: user.wallet_address,
+        wallet_type: user.wallet_source ?? void 0,
+        source: "existing"
+      };
+    }
+    return this.createWallet(externalId, options);
+  }
+  /**
+   * Update user attributes (convenience method) by external ID.
+   * Merges the provided attributes into the existing attributes object.
    */
   async updateAttributes(externalId, attributes) {
     return this.http.patch(`/end-users/by-external/${encodeURIComponent(externalId)}`, { attributes });
   }
+  /**
+   * Remove specific attributes from a user by external ID.
+   * Fetches current attributes, removes the specified keys, and saves.
+   */
+  async removeAttributes(externalId, keys) {
+    const user = await this.get(externalId);
+    const attributes = { ...user.attributes || {} };
+    for (const key of keys) {
+      delete attributes[key];
+    }
+    return this.http.patch(`/end-users/by-external/${encodeURIComponent(externalId)}`, { attributes });
+  }
+  /**
+   * Set profile fields (convenience method) by external ID.
+   * Only updates the fields provided, leaving others unchanged.
+   */
+  async setProfile(externalId, profile) {
+    return this.http.patch(`/end-users/by-external/${encodeURIComponent(externalId)}`, profile);
+  }
+  /**
+   * Preview what would be deleted for a GDPR request
+   */
+  async gdprPreview(userId) {
+    return this.http.get(`/end-users/${userId}/gdpr/preview`);
+  }
+  /**
+   * GDPR Right to Be Forgotten - permanently delete all user data
+   */
+  async gdprDelete(userId, request) {
+    return this.http.request("DELETE", `/end-users/${userId}/gdpr`, { body: request });
+  }
   /**
    * Export users as CSV
    */

package/dist/index.mjs

@@ -1089,6 +1089,7 @@ var EndUsersClient = class {
     if (options.status) params.append("status", options.status);
     if (options.segment) params.append("segment", options.segment);
     if (options.has_wallet !== void 0) params.append("has_wallet", options.has_wallet.toString());
+    if (options.min_events !== void 0) params.append("min_events", options.min_events.toString());
     if (options.sort_by) params.append("sort_by", options.sort_by);
     if (options.sort_order) params.append("sort_order", options.sort_order);
     return this.http.get(`/end-users?${params.toString()}`);
@@ -1155,11 +1156,121 @@ var EndUsersClient = class {
     return this.http.post("/end-users/merge", request);
   }
   /**
-   * Update user attributes (convenience method) by external ID
+   * Update an end-user profile by internal UUID
+   */
+  async updateByInternalId(userId, data) {
+    return this.http.patch(`/end-users/${userId}`, data);
+  }
+  /**
+   * Get user rewards by external ID
+   */
+  async getRewards(externalId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.status) params.append("status", options.status);
+    if (options.page) params.append("page", options.page.toString());
+    if (options.page_size) params.append("page_size", options.page_size.toString());
+    return this.http.get(`/end-users/by-external/${encodeURIComponent(externalId)}/rewards?${params.toString()}`);
+  }
+  /**
+   * Get user rewards by internal UUID
+   */
+  async getRewardsByInternalId(userId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.status) params.append("status", options.status);
+    if (options.page) params.append("page", options.page.toString());
+    if (options.page_size) params.append("page_size", options.page_size.toString());
+    return this.http.get(`/end-users/${userId}/rewards?${params.toString()}`);
+  }
+  /**
+   * Create a CDP (custodial) wallet for an end-user by external ID
+   */
+  async createWallet(externalId, request = {}) {
+    return this.http.post(`/end-users/by-external/${encodeURIComponent(externalId)}/create-wallet`, request);
+  }
+  /**
+   * Register an external wallet for an end-user by external ID
+   */
+  async registerWallet(externalId, request) {
+    return this.http.post(`/end-users/by-external/${encodeURIComponent(externalId)}/register-wallet`, request);
+  }
+  /**
+   * Ensure a user has a wallet, creating one if they don't.
+   *
+   * This is the recommended way for frontend devs to guarantee a wallet
+   * exists before performing any wallet-dependent operation (e.g. attestation,
+   * on-chain claims, token transfers).
+   *
+   * If the user already has a wallet, returns immediately with the existing
+   * address. If not, creates a CDP wallet with the specified options.
+   *
+   * @param externalId - The user's external ID
+   * @param options - Wallet creation options (only used if a new wallet is created)
+   * @returns Wallet result with address and creation status
+   *
+   * @example
+   * ```typescript
+   * // One-liner before any wallet-dependent operation
+   * const wallet = await client.users.ensureWallet('user-123');
+   * console.log(wallet.wallet_address); // '0xabc...'
+   *
+   * // With options
+   * const wallet = await client.users.ensureWallet('user-123', {
+   *   wallet_type: 'eoa',
+   *   network: 'base-mainnet',
+   * });
+   * ```
+   */
+  async ensureWallet(externalId, options = {}) {
+    const user = await this.get(externalId);
+    if (user.wallet_address) {
+      return {
+        success: true,
+        user_id: externalId,
+        wallet_address: user.wallet_address,
+        wallet_type: user.wallet_source ?? void 0,
+        source: "existing"
+      };
+    }
+    return this.createWallet(externalId, options);
+  }
+  /**
+   * Update user attributes (convenience method) by external ID.
+   * Merges the provided attributes into the existing attributes object.
    */
   async updateAttributes(externalId, attributes) {
     return this.http.patch(`/end-users/by-external/${encodeURIComponent(externalId)}`, { attributes });
   }
+  /**
+   * Remove specific attributes from a user by external ID.
+   * Fetches current attributes, removes the specified keys, and saves.
+   */
+  async removeAttributes(externalId, keys) {
+    const user = await this.get(externalId);
+    const attributes = { ...user.attributes || {} };
+    for (const key of keys) {
+      delete attributes[key];
+    }
+    return this.http.patch(`/end-users/by-external/${encodeURIComponent(externalId)}`, { attributes });
+  }
+  /**
+   * Set profile fields (convenience method) by external ID.
+   * Only updates the fields provided, leaving others unchanged.
+   */
+  async setProfile(externalId, profile) {
+    return this.http.patch(`/end-users/by-external/${encodeURIComponent(externalId)}`, profile);
+  }
+  /**
+   * Preview what would be deleted for a GDPR request
+   */
+  async gdprPreview(userId) {
+    return this.http.get(`/end-users/${userId}/gdpr/preview`);
+  }
+  /**
+   * GDPR Right to Be Forgotten - permanently delete all user data
+   */
+  async gdprDelete(userId, request) {
+    return this.http.request("DELETE", `/end-users/${userId}/gdpr`, { body: request });
+  }
   /**
    * Export users as CSV
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proofchain/sdk",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "description": "Official JavaScript/TypeScript SDK for ProofChain - blockchain-anchored document attestation",
   "main": "dist/index.js",
   "module": "dist/index.mjs",