@proofchain/sdk 2.12.2 → 2.13.0

package/dist/index.d.mts

@@ -2,13 +2,17 @@
  * HTTP Client for ProofChain API
  */
 interface HttpClientOptions {
-    apiKey: string;
+    apiKey?: string;
+    userToken?: string;
+    tenantId?: string;
     baseUrl?: string;
     timeout?: number;
     maxRetries?: number;
 }
 declare class HttpClient {
     private apiKey;
+    private userToken;
+    private tenantId;
     private baseUrl;
     private timeout;
     private maxRetries;
@@ -377,7 +381,11 @@ interface CreateApiKeyRequest {
     expiresInDays?: number;
 }
 interface ProofChainOptions {
-    apiKey: string;
+    apiKey?: string;
+    /** End-user JWT for JWKS auth (alternative to apiKey). For PWA clients. */
+    userToken?: string;
+    /** Tenant slug or client_id. Required when using userToken. */
+    tenantId?: string;
     baseUrl?: string;
     timeout?: number;
     maxRetries?: number;
@@ -1586,7 +1594,7 @@ interface RegisterWalletRequest {
     wallet_address: string;
     signature?: string;
 }
-interface UserReward {
+interface UserReward$1 {
     id: string;
     reward_name: string;
     reward_type: string;
@@ -1600,7 +1608,7 @@ interface UserReward {
 }
 interface UserRewardsResponse {
     user_id: string;
-    rewards: UserReward[];
+    rewards: UserReward$1[];
     total: number;
     page: number;
     page_size: number;
@@ -1846,6 +1854,23 @@ interface EarnedReward {
     earned_at: string;
     distributed_at?: string;
 }
+interface UserReward {
+    id: string;
+    reward_name: string;
+    reward_type: string;
+    slug?: string;
+    description?: string;
+    status: string;
+    value?: number;
+    value_currency?: string;
+    image_url?: string;
+    badge_color?: string;
+    nft_token_id?: number;
+    nft_tx_hash?: string;
+    earned_at: string;
+    distributed_at?: string;
+    expires_at?: string;
+}
 interface RewardAsset {
     id: string;
     definition_id: string;
@@ -1937,9 +1962,12 @@ declare class RewardsClient {
         offset?: number;
     }): Promise<EarnedReward[]>;
     /**
-     * Get earned rewards for a user
+     * Get earned rewards for a user (with full badge/reward details)
      */
-    getUserRewards(userId: string): Promise<EarnedReward[]>;
+    getUserRewards(userId: string, options?: {
+        status?: string;
+        reward_type?: string;
+    }): Promise<UserReward[]>;
     /**
      * Manually award rewards to users
      */
@@ -3009,6 +3037,27 @@ declare class ProofChain {
     /** Fanpass leaderboard client for composite score leaderboards */
     fanpassLeaderboard: FanpassLeaderboardClient;
     constructor(options: ProofChainOptions);
+    /**
+     * Create a client for end-user JWT authentication (PWA/frontend use).
+     * Uses the end-user's JWT from their auth system instead of an API key.
+     * End-user clients have read-only access scoped to their own data.
+     *
+     * @example
+     * ```typescript
+     * const client = ProofChain.forEndUser({
+     *   userToken: authSystem.getIdToken(),
+     *   tenantId: 'my-tenant-slug',
+     * });
+     * const passport = await client.passports.getUserPassport(myUserId);
+     * ```
+     */
+    static forEndUser(options: {
+        userToken: string;
+        tenantId: string;
+        baseUrl?: string;
+        timeout?: number;
+        maxRetries?: number;
+    }): ProofChain;
     /**
      * Create a client from environment variables.
      * Reads PROOFCHAIN_API_KEY and optionally PROOFCHAIN_BASE_URL.
@@ -3151,4 +3200,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 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 };
+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$1 as 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

@@ -2,13 +2,17 @@
  * HTTP Client for ProofChain API
  */
 interface HttpClientOptions {
-    apiKey: string;
+    apiKey?: string;
+    userToken?: string;
+    tenantId?: string;
     baseUrl?: string;
     timeout?: number;
     maxRetries?: number;
 }
 declare class HttpClient {
     private apiKey;
+    private userToken;
+    private tenantId;
     private baseUrl;
     private timeout;
     private maxRetries;
@@ -377,7 +381,11 @@ interface CreateApiKeyRequest {
     expiresInDays?: number;
 }
 interface ProofChainOptions {
-    apiKey: string;
+    apiKey?: string;
+    /** End-user JWT for JWKS auth (alternative to apiKey). For PWA clients. */
+    userToken?: string;
+    /** Tenant slug or client_id. Required when using userToken. */
+    tenantId?: string;
     baseUrl?: string;
     timeout?: number;
     maxRetries?: number;
@@ -1586,7 +1594,7 @@ interface RegisterWalletRequest {
     wallet_address: string;
     signature?: string;
 }
-interface UserReward {
+interface UserReward$1 {
     id: string;
     reward_name: string;
     reward_type: string;
@@ -1600,7 +1608,7 @@ interface UserReward {
 }
 interface UserRewardsResponse {
     user_id: string;
-    rewards: UserReward[];
+    rewards: UserReward$1[];
     total: number;
     page: number;
     page_size: number;
@@ -1846,6 +1854,23 @@ interface EarnedReward {
     earned_at: string;
     distributed_at?: string;
 }
+interface UserReward {
+    id: string;
+    reward_name: string;
+    reward_type: string;
+    slug?: string;
+    description?: string;
+    status: string;
+    value?: number;
+    value_currency?: string;
+    image_url?: string;
+    badge_color?: string;
+    nft_token_id?: number;
+    nft_tx_hash?: string;
+    earned_at: string;
+    distributed_at?: string;
+    expires_at?: string;
+}
 interface RewardAsset {
     id: string;
     definition_id: string;
@@ -1937,9 +1962,12 @@ declare class RewardsClient {
         offset?: number;
     }): Promise<EarnedReward[]>;
     /**
-     * Get earned rewards for a user
+     * Get earned rewards for a user (with full badge/reward details)
      */
-    getUserRewards(userId: string): Promise<EarnedReward[]>;
+    getUserRewards(userId: string, options?: {
+        status?: string;
+        reward_type?: string;
+    }): Promise<UserReward[]>;
     /**
      * Manually award rewards to users
      */
@@ -3009,6 +3037,27 @@ declare class ProofChain {
     /** Fanpass leaderboard client for composite score leaderboards */
     fanpassLeaderboard: FanpassLeaderboardClient;
     constructor(options: ProofChainOptions);
+    /**
+     * Create a client for end-user JWT authentication (PWA/frontend use).
+     * Uses the end-user's JWT from their auth system instead of an API key.
+     * End-user clients have read-only access scoped to their own data.
+     *
+     * @example
+     * ```typescript
+     * const client = ProofChain.forEndUser({
+     *   userToken: authSystem.getIdToken(),
+     *   tenantId: 'my-tenant-slug',
+     * });
+     * const passport = await client.passports.getUserPassport(myUserId);
+     * ```
+     */
+    static forEndUser(options: {
+        userToken: string;
+        tenantId: string;
+        baseUrl?: string;
+        timeout?: number;
+        maxRetries?: number;
+    }): ProofChain;
     /**
      * Create a client from environment variables.
      * Reads PROOFCHAIN_API_KEY and optionally PROOFCHAIN_BASE_URL.
@@ -3151,4 +3200,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 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 };
+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$1 as 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

@@ -119,17 +119,27 @@ var DEFAULT_TIMEOUT = 3e4;
 var USER_AGENT = "proofchain-js/0.1.0";
 var HttpClient = class {
   constructor(options) {
-    this.apiKey = options.apiKey;
+    this.apiKey = options.apiKey || "";
+    this.userToken = options.userToken || "";
+    this.tenantId = options.tenantId || "";
     this.baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.timeout = options.timeout || DEFAULT_TIMEOUT;
     this.maxRetries = options.maxRetries ?? 3;
   }
   getHeaders() {
-    return {
-      "X-API-Key": this.apiKey,
+    const headers = {
       "Content-Type": "application/json",
       "User-Agent": USER_AGENT
     };
+    if (this.userToken) {
+      headers["Authorization"] = `Bearer ${this.userToken}`;
+      if (this.tenantId) {
+        headers["X-Tenant-ID"] = this.tenantId;
+      }
+    } else if (this.apiKey) {
+      headers["X-API-Key"] = this.apiKey;
+    }
+    return headers;
   }
   async handleResponse(response) {
     const contentType = response.headers.get("content-type");
@@ -221,9 +231,16 @@ var HttpClient = class {
   async requestMultipart(path, formData) {
     const url = `${this.baseUrl}${path}`;
     const headers = {
-      "X-API-Key": this.apiKey,
       "User-Agent": USER_AGENT
     };
+    if (this.userToken) {
+      headers["Authorization"] = `Bearer ${this.userToken}`;
+      if (this.tenantId) {
+        headers["X-Tenant-ID"] = this.tenantId;
+      }
+    } else if (this.apiKey) {
+      headers["X-API-Key"] = this.apiKey;
+    }
     return this.fetchWithRetry(url, {
       method: "POST",
       headers,
@@ -237,10 +254,7 @@ var HttpClient = class {
     try {
       const response = await fetch(url, {
         method: "GET",
-        headers: {
-          "X-API-Key": this.apiKey,
-          "User-Agent": USER_AGENT
-        },
+        headers: this.getHeaders(),
         signal: controller.signal
       });
       clearTimeout(timeoutId);
@@ -1451,10 +1465,14 @@ var RewardsClient = class {
     return this.http.get(`/rewards/earned?${params.toString()}`);
   }
   /**
-   * Get earned rewards for a user
+   * Get earned rewards for a user (with full badge/reward details)
    */
-  async getUserRewards(userId) {
-    return this.http.get(`/rewards/earned/user/${userId}`);
+  async getUserRewards(userId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.status) params.append("status", options.status);
+    if (options.reward_type) params.append("reward_type", options.reward_type);
+    const query = params.toString();
+    return this.http.get(`/rewards/users/${userId}/rewards${query ? "?" + query : ""}`);
   }
   /**
    * Manually award rewards to users
@@ -2322,6 +2340,23 @@ var ProofChain = class _ProofChain {
     this.cohorts = new CohortLeaderboardClient(this.http);
     this.fanpassLeaderboard = new FanpassLeaderboardClient(this.http);
   }
+  /**
+   * Create a client for end-user JWT authentication (PWA/frontend use).
+   * Uses the end-user's JWT from their auth system instead of an API key.
+   * End-user clients have read-only access scoped to their own data.
+   *
+   * @example
+   * ```typescript
+   * const client = ProofChain.forEndUser({
+   *   userToken: authSystem.getIdToken(),
+   *   tenantId: 'my-tenant-slug',
+   * });
+   * const passport = await client.passports.getUserPassport(myUserId);
+   * ```
+   */
+  static forEndUser(options) {
+    return new _ProofChain(options);
+  }
   /**
    * Create a client from environment variables.
    * Reads PROOFCHAIN_API_KEY and optionally PROOFCHAIN_BASE_URL.

package/dist/index.mjs

@@ -65,17 +65,27 @@ var DEFAULT_TIMEOUT = 3e4;
 var USER_AGENT = "proofchain-js/0.1.0";
 var HttpClient = class {
   constructor(options) {
-    this.apiKey = options.apiKey;
+    this.apiKey = options.apiKey || "";
+    this.userToken = options.userToken || "";
+    this.tenantId = options.tenantId || "";
     this.baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.timeout = options.timeout || DEFAULT_TIMEOUT;
     this.maxRetries = options.maxRetries ?? 3;
   }
   getHeaders() {
-    return {
-      "X-API-Key": this.apiKey,
+    const headers = {
       "Content-Type": "application/json",
       "User-Agent": USER_AGENT
     };
+    if (this.userToken) {
+      headers["Authorization"] = `Bearer ${this.userToken}`;
+      if (this.tenantId) {
+        headers["X-Tenant-ID"] = this.tenantId;
+      }
+    } else if (this.apiKey) {
+      headers["X-API-Key"] = this.apiKey;
+    }
+    return headers;
   }
   async handleResponse(response) {
     const contentType = response.headers.get("content-type");
@@ -167,9 +177,16 @@ var HttpClient = class {
   async requestMultipart(path, formData) {
     const url = `${this.baseUrl}${path}`;
     const headers = {
-      "X-API-Key": this.apiKey,
       "User-Agent": USER_AGENT
     };
+    if (this.userToken) {
+      headers["Authorization"] = `Bearer ${this.userToken}`;
+      if (this.tenantId) {
+        headers["X-Tenant-ID"] = this.tenantId;
+      }
+    } else if (this.apiKey) {
+      headers["X-API-Key"] = this.apiKey;
+    }
     return this.fetchWithRetry(url, {
       method: "POST",
       headers,
@@ -183,10 +200,7 @@ var HttpClient = class {
     try {
       const response = await fetch(url, {
         method: "GET",
-        headers: {
-          "X-API-Key": this.apiKey,
-          "User-Agent": USER_AGENT
-        },
+        headers: this.getHeaders(),
         signal: controller.signal
       });
       clearTimeout(timeoutId);
@@ -1397,10 +1411,14 @@ var RewardsClient = class {
     return this.http.get(`/rewards/earned?${params.toString()}`);
   }
   /**
-   * Get earned rewards for a user
+   * Get earned rewards for a user (with full badge/reward details)
    */
-  async getUserRewards(userId) {
-    return this.http.get(`/rewards/earned/user/${userId}`);
+  async getUserRewards(userId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.status) params.append("status", options.status);
+    if (options.reward_type) params.append("reward_type", options.reward_type);
+    const query = params.toString();
+    return this.http.get(`/rewards/users/${userId}/rewards${query ? "?" + query : ""}`);
   }
   /**
    * Manually award rewards to users
@@ -2268,6 +2286,23 @@ var ProofChain = class _ProofChain {
     this.cohorts = new CohortLeaderboardClient(this.http);
     this.fanpassLeaderboard = new FanpassLeaderboardClient(this.http);
   }
+  /**
+   * Create a client for end-user JWT authentication (PWA/frontend use).
+   * Uses the end-user's JWT from their auth system instead of an API key.
+   * End-user clients have read-only access scoped to their own data.
+   *
+   * @example
+   * ```typescript
+   * const client = ProofChain.forEndUser({
+   *   userToken: authSystem.getIdToken(),
+   *   tenantId: 'my-tenant-slug',
+   * });
+   * const passport = await client.passports.getUserPassport(myUserId);
+   * ```
+   */
+  static forEndUser(options) {
+    return new _ProofChain(options);
+  }
   /**
    * Create a client from environment variables.
    * Reads PROOFCHAIN_API_KEY and optionally PROOFCHAIN_BASE_URL.

package/package.json

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