@proofchain/sdk 2.6.0 → 2.8.0

package/dist/index.d.mts

@@ -1582,61 +1582,49 @@ declare class EndUsersClient {
      */
     list(options?: ListEndUsersOptions): Promise<EndUserListResponse>;
     /**
-     * Get an end-user by ID
+     * Get an end-user by external ID
      */
-    get(userId: string): Promise<EndUser>;
+    get(externalId: string): Promise<EndUser>;
     /**
-     * Get an end-user by external ID
+     * Get an end-user by internal UUID (admin use)
      */
-    getByExternalId(externalId: string): Promise<EndUser>;
+    getByInternalId(userId: string): Promise<EndUser>;
     /**
      * Create an end-user manually
      */
     create(data: CreateEndUserRequest): Promise<EndUser>;
     /**
-     * Update an end-user profile
+     * Update an end-user profile by external ID
      */
-    update(userId: string, data: UpdateEndUserRequest): Promise<EndUser>;
+    update(externalId: string, data: UpdateEndUserRequest): Promise<EndUser>;
     /**
      * Delete an end-user
      */
     delete(userId: string): Promise<void>;
     /**
-     * Link a wallet to an end-user
-     */
-    linkWallet(userId: string, request: LinkWalletRequest): Promise<EndUser>;
-    /**
-     * Unlink wallet from an end-user
+     * Link a wallet to an end-user by external ID
      */
-    unlinkWallet(userId: string): Promise<EndUser>;
+    linkWallet(externalId: string, request: LinkWalletRequest): Promise<EndUser>;
     /**
-     * Get user activity/events
+     * Get user activity/events by external ID
      */
-    getActivity(userId: string, options?: {
+    getActivity(externalId: string, options?: {
         page?: number;
         page_size?: number;
         event_type?: string;
     }): Promise<UserActivityResponse>;
     /**
-     * Add points to a user
-     */
-    addPoints(userId: string, points: number, reason?: string): Promise<EndUser>;
-    /**
-     * Add a segment to a user
+     * Add points to a user by external ID
      */
-    addSegment(userId: string, segment: string): Promise<EndUser>;
-    /**
-     * Remove a segment from a user
-     */
-    removeSegment(userId: string, segment: string): Promise<EndUser>;
+    addPoints(externalId: string, points: number, reason?: string): Promise<EndUser>;
     /**
      * Merge two users (moves all data from source to target)
      */
     merge(request: MergeUsersRequest): Promise<EndUser>;
     /**
-     * Update user attributes (convenience method)
+     * Update user attributes (convenience method) by external ID
      */
-    updateAttributes(userId: string, attributes: Record<string, any>): Promise<EndUser>;
+    updateAttributes(externalId: string, attributes: Record<string, any>): Promise<EndUser>;
     /**
      * Export users as CSV
      */
@@ -2465,6 +2453,17 @@ declare class DataViewsClient {
  * Manage cohort definitions, scoring, and filtered leaderboards with percentiles.
  */
 
+interface LeaderboardUserProfile$1 {
+    external_id: string;
+    display_name: string | null;
+    first_name: string | null;
+    last_name: string | null;
+    email: string | null;
+    avatar_url: string | null;
+    country: string | null;
+    city: string | null;
+    attributes: Record<string, unknown>;
+}
 interface CohortLeaderboardEntry {
     rank: number;
     user_id: string;
@@ -2472,6 +2471,7 @@ interface CohortLeaderboardEntry {
     percentile_global: number;
     percentile_filtered: number | null;
     computed_at?: string;
+    user?: LeaderboardUserProfile$1 | null;
 }
 interface CohortGroupStats {
     filtered_avg_percentile: number | null;
@@ -2562,6 +2562,17 @@ declare class CohortLeaderboardClient {
  * Manage fanpass composite scores and filtered leaderboards.
  */
 
+interface LeaderboardUserProfile {
+    external_id: string;
+    display_name: string | null;
+    first_name: string | null;
+    last_name: string | null;
+    email: string | null;
+    avatar_url: string | null;
+    country: string | null;
+    city: string | null;
+    attributes: Record<string, unknown>;
+}
 interface FanpassLeaderboardEntry {
     rank: number;
     user_id: string;
@@ -2570,6 +2581,7 @@ interface FanpassLeaderboardEntry {
     raw_score: number;
     percentile: number;
     computed_at?: string;
+    user?: LeaderboardUserProfile | null;
 }
 interface FanpassGroupStats {
     avg_fan_score: number;
@@ -2954,4 +2966,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 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 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 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 };

package/dist/index.d.ts

@@ -1582,61 +1582,49 @@ declare class EndUsersClient {
      */
     list(options?: ListEndUsersOptions): Promise<EndUserListResponse>;
     /**
-     * Get an end-user by ID
+     * Get an end-user by external ID
      */
-    get(userId: string): Promise<EndUser>;
+    get(externalId: string): Promise<EndUser>;
     /**
-     * Get an end-user by external ID
+     * Get an end-user by internal UUID (admin use)
      */
-    getByExternalId(externalId: string): Promise<EndUser>;
+    getByInternalId(userId: string): Promise<EndUser>;
     /**
      * Create an end-user manually
      */
     create(data: CreateEndUserRequest): Promise<EndUser>;
     /**
-     * Update an end-user profile
+     * Update an end-user profile by external ID
      */
-    update(userId: string, data: UpdateEndUserRequest): Promise<EndUser>;
+    update(externalId: string, data: UpdateEndUserRequest): Promise<EndUser>;
     /**
      * Delete an end-user
      */
     delete(userId: string): Promise<void>;
     /**
-     * Link a wallet to an end-user
-     */
-    linkWallet(userId: string, request: LinkWalletRequest): Promise<EndUser>;
-    /**
-     * Unlink wallet from an end-user
+     * Link a wallet to an end-user by external ID
      */
-    unlinkWallet(userId: string): Promise<EndUser>;
+    linkWallet(externalId: string, request: LinkWalletRequest): Promise<EndUser>;
     /**
-     * Get user activity/events
+     * Get user activity/events by external ID
      */
-    getActivity(userId: string, options?: {
+    getActivity(externalId: string, options?: {
         page?: number;
         page_size?: number;
         event_type?: string;
     }): Promise<UserActivityResponse>;
     /**
-     * Add points to a user
-     */
-    addPoints(userId: string, points: number, reason?: string): Promise<EndUser>;
-    /**
-     * Add a segment to a user
+     * Add points to a user by external ID
      */
-    addSegment(userId: string, segment: string): Promise<EndUser>;
-    /**
-     * Remove a segment from a user
-     */
-    removeSegment(userId: string, segment: string): Promise<EndUser>;
+    addPoints(externalId: string, points: number, reason?: string): Promise<EndUser>;
     /**
      * Merge two users (moves all data from source to target)
      */
     merge(request: MergeUsersRequest): Promise<EndUser>;
     /**
-     * Update user attributes (convenience method)
+     * Update user attributes (convenience method) by external ID
      */
-    updateAttributes(userId: string, attributes: Record<string, any>): Promise<EndUser>;
+    updateAttributes(externalId: string, attributes: Record<string, any>): Promise<EndUser>;
     /**
      * Export users as CSV
      */
@@ -2465,6 +2453,17 @@ declare class DataViewsClient {
  * Manage cohort definitions, scoring, and filtered leaderboards with percentiles.
  */
 
+interface LeaderboardUserProfile$1 {
+    external_id: string;
+    display_name: string | null;
+    first_name: string | null;
+    last_name: string | null;
+    email: string | null;
+    avatar_url: string | null;
+    country: string | null;
+    city: string | null;
+    attributes: Record<string, unknown>;
+}
 interface CohortLeaderboardEntry {
     rank: number;
     user_id: string;
@@ -2472,6 +2471,7 @@ interface CohortLeaderboardEntry {
     percentile_global: number;
     percentile_filtered: number | null;
     computed_at?: string;
+    user?: LeaderboardUserProfile$1 | null;
 }
 interface CohortGroupStats {
     filtered_avg_percentile: number | null;
@@ -2562,6 +2562,17 @@ declare class CohortLeaderboardClient {
  * Manage fanpass composite scores and filtered leaderboards.
  */
 
+interface LeaderboardUserProfile {
+    external_id: string;
+    display_name: string | null;
+    first_name: string | null;
+    last_name: string | null;
+    email: string | null;
+    avatar_url: string | null;
+    country: string | null;
+    city: string | null;
+    attributes: Record<string, unknown>;
+}
 interface FanpassLeaderboardEntry {
     rank: number;
     user_id: string;
@@ -2570,6 +2581,7 @@ interface FanpassLeaderboardEntry {
     raw_score: number;
     percentile: number;
     computed_at?: string;
+    user?: LeaderboardUserProfile | null;
 }
 interface FanpassGroupStats {
     avg_fan_score: number;
@@ -2954,4 +2966,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 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 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 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 };

package/dist/index.js

@@ -1148,16 +1148,16 @@ var EndUsersClient = class {
     return this.http.get(`/end-users?${params.toString()}`);
   }
   /**
-   * Get an end-user by ID
+   * Get an end-user by external ID
    */
-  async get(userId) {
-    return this.http.get(`/end-users/${userId}`);
+  async get(externalId) {
+    return this.http.get(`/end-users/by-external/${encodeURIComponent(externalId)}`);
   }
   /**
-   * Get an end-user by external ID
+   * Get an end-user by internal UUID (admin use)
    */
-  async getByExternalId(externalId) {
-    return this.http.get(`/end-users/by-external/${encodeURIComponent(externalId)}`);
+  async getByInternalId(userId) {
+    return this.http.get(`/end-users/${userId}`);
   }
   /**
    * Create an end-user manually
@@ -1166,10 +1166,10 @@ var EndUsersClient = class {
     return this.http.post("/end-users", data);
   }
   /**
-   * Update an end-user profile
+   * Update an end-user profile by external ID
    */
-  async update(userId, data) {
-    return this.http.patch(`/end-users/${userId}`, data);
+  async update(externalId, data) {
+    return this.http.patch(`/end-users/by-external/${encodeURIComponent(externalId)}`, data);
   }
   /**
    * Delete an end-user
@@ -1178,44 +1178,29 @@ var EndUsersClient = class {
     await this.http.delete(`/end-users/${userId}`);
   }
   /**
-   * Link a wallet to an end-user
+   * Link a wallet to an end-user by external ID
    */
-  async linkWallet(userId, request) {
-    return this.http.post(`/end-users/${userId}/wallet`, request);
+  async linkWallet(externalId, request) {
+    return this.http.post(`/end-users/by-external/${encodeURIComponent(externalId)}/link-wallet`, request);
   }
   /**
-   * Unlink wallet from an end-user
+   * Get user activity/events by external ID
    */
-  async unlinkWallet(userId) {
-    return this.http.delete(`/end-users/${userId}/wallet`);
-  }
-  /**
-   * Get user activity/events
-   */
-  async getActivity(userId, options = {}) {
+  async getActivity(externalId, options = {}) {
     const params = new URLSearchParams();
     if (options.page) params.append("page", options.page.toString());
     if (options.page_size) params.append("page_size", options.page_size.toString());
     if (options.event_type) params.append("event_type", options.event_type);
-    return this.http.get(`/end-users/${userId}/activity?${params.toString()}`);
-  }
-  /**
-   * Add points to a user
-   */
-  async addPoints(userId, points, reason) {
-    return this.http.post(`/end-users/${userId}/points`, { points, reason });
+    return this.http.get(`/end-users/by-external/${encodeURIComponent(externalId)}/activity?${params.toString()}`);
   }
   /**
-   * Add a segment to a user
+   * Add points to a user by external ID
    */
-  async addSegment(userId, segment) {
-    return this.http.post(`/end-users/${userId}/segments`, { segment });
-  }
-  /**
-   * Remove a segment from a user
-   */
-  async removeSegment(userId, segment) {
-    return this.http.delete(`/end-users/${userId}/segments/${encodeURIComponent(segment)}`);
+  async addPoints(externalId, points, reason) {
+    const params = new URLSearchParams();
+    params.append("points", points.toString());
+    if (reason) params.append("reason", reason);
+    return this.http.post(`/end-users/by-external/${encodeURIComponent(externalId)}/add-points?${params.toString()}`, {});
   }
   /**
    * Merge two users (moves all data from source to target)
@@ -1224,10 +1209,10 @@ var EndUsersClient = class {
     return this.http.post("/end-users/merge", request);
   }
   /**
-   * Update user attributes (convenience method)
+   * Update user attributes (convenience method) by external ID
    */
-  async updateAttributes(userId, attributes) {
-    return this.http.patch(`/end-users/${userId}`, { attributes });
+  async updateAttributes(externalId, attributes) {
+    return this.http.patch(`/end-users/by-external/${encodeURIComponent(externalId)}`, { attributes });
   }
   /**
    * Export users as CSV

package/dist/index.mjs

@@ -1094,16 +1094,16 @@ var EndUsersClient = class {
     return this.http.get(`/end-users?${params.toString()}`);
   }
   /**
-   * Get an end-user by ID
+   * Get an end-user by external ID
    */
-  async get(userId) {
-    return this.http.get(`/end-users/${userId}`);
+  async get(externalId) {
+    return this.http.get(`/end-users/by-external/${encodeURIComponent(externalId)}`);
   }
   /**
-   * Get an end-user by external ID
+   * Get an end-user by internal UUID (admin use)
    */
-  async getByExternalId(externalId) {
-    return this.http.get(`/end-users/by-external/${encodeURIComponent(externalId)}`);
+  async getByInternalId(userId) {
+    return this.http.get(`/end-users/${userId}`);
   }
   /**
    * Create an end-user manually
@@ -1112,10 +1112,10 @@ var EndUsersClient = class {
     return this.http.post("/end-users", data);
   }
   /**
-   * Update an end-user profile
+   * Update an end-user profile by external ID
    */
-  async update(userId, data) {
-    return this.http.patch(`/end-users/${userId}`, data);
+  async update(externalId, data) {
+    return this.http.patch(`/end-users/by-external/${encodeURIComponent(externalId)}`, data);
   }
   /**
    * Delete an end-user
@@ -1124,44 +1124,29 @@ var EndUsersClient = class {
     await this.http.delete(`/end-users/${userId}`);
   }
   /**
-   * Link a wallet to an end-user
+   * Link a wallet to an end-user by external ID
    */
-  async linkWallet(userId, request) {
-    return this.http.post(`/end-users/${userId}/wallet`, request);
+  async linkWallet(externalId, request) {
+    return this.http.post(`/end-users/by-external/${encodeURIComponent(externalId)}/link-wallet`, request);
   }
   /**
-   * Unlink wallet from an end-user
+   * Get user activity/events by external ID
    */
-  async unlinkWallet(userId) {
-    return this.http.delete(`/end-users/${userId}/wallet`);
-  }
-  /**
-   * Get user activity/events
-   */
-  async getActivity(userId, options = {}) {
+  async getActivity(externalId, options = {}) {
     const params = new URLSearchParams();
     if (options.page) params.append("page", options.page.toString());
     if (options.page_size) params.append("page_size", options.page_size.toString());
     if (options.event_type) params.append("event_type", options.event_type);
-    return this.http.get(`/end-users/${userId}/activity?${params.toString()}`);
-  }
-  /**
-   * Add points to a user
-   */
-  async addPoints(userId, points, reason) {
-    return this.http.post(`/end-users/${userId}/points`, { points, reason });
+    return this.http.get(`/end-users/by-external/${encodeURIComponent(externalId)}/activity?${params.toString()}`);
   }
   /**
-   * Add a segment to a user
+   * Add points to a user by external ID
    */
-  async addSegment(userId, segment) {
-    return this.http.post(`/end-users/${userId}/segments`, { segment });
-  }
-  /**
-   * Remove a segment from a user
-   */
-  async removeSegment(userId, segment) {
-    return this.http.delete(`/end-users/${userId}/segments/${encodeURIComponent(segment)}`);
+  async addPoints(externalId, points, reason) {
+    const params = new URLSearchParams();
+    params.append("points", points.toString());
+    if (reason) params.append("reason", reason);
+    return this.http.post(`/end-users/by-external/${encodeURIComponent(externalId)}/add-points?${params.toString()}`, {});
   }
   /**
    * Merge two users (moves all data from source to target)
@@ -1170,10 +1155,10 @@ var EndUsersClient = class {
     return this.http.post("/end-users/merge", request);
   }
   /**
-   * Update user attributes (convenience method)
+   * Update user attributes (convenience method) by external ID
    */
-  async updateAttributes(userId, attributes) {
-    return this.http.patch(`/end-users/${userId}`, { attributes });
+  async updateAttributes(externalId, attributes) {
+    return this.http.patch(`/end-users/by-external/${encodeURIComponent(externalId)}`, { attributes });
   }
   /**
    * Export users as CSV

package/package.json

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