@proofchain/sdk 2.2.0 → 2.3.0

package/dist/index.d.mts

@@ -1858,15 +1858,27 @@ interface UserQuestProgress {
     user_id: string;
     quest_id: string;
     quest_name: string;
-    status: 'not_started' | 'in_progress' | 'completed' | 'failed' | 'expired';
+    status: 'not_started' | 'in_progress' | 'completed' | 'failed' | 'expired' | 'reward_pending';
     started_at?: string;
     completed_at?: string;
     expires_at?: string;
     completion_count: number;
     current_step_order: number;
+    steps_completed: number;
+    total_steps: number;
+    completion_percentage: number;
     step_progress: StepProgress[];
     points_earned: number;
-    reward_earned: boolean;
+    reward_earned?: RewardEarned;
+}
+interface RewardEarned {
+    id: string;
+    reward_name: string;
+    reward_type: string;
+    value?: number;
+    value_currency?: string;
+    status: string;
+    earned_at: string;
 }
 interface StepProgress {
     step_id: string;
@@ -1876,6 +1888,14 @@ interface StepProgress {
     completed_at?: string;
     event_id?: string;
 }
+interface StepCompletionResult {
+    step_index: number;
+    step_completed: boolean;
+    quest_completed: boolean;
+    current_count: number;
+    target_count: number;
+    points_earned: number;
+}
 interface QuestWithProgress extends Quest {
     user_progress?: UserQuestProgress;
 }
@@ -1938,6 +1958,13 @@ declare class QuestsClient {
      * Get a quest by ID
      */
     get(questId: string): Promise<Quest>;
+    /**
+     * List available quests for a user (active, public quests with user progress)
+     * This is the main endpoint for frontend quest displays
+     */
+    listAvailable(userId: string, options?: {
+        category?: string;
+    }): Promise<QuestWithProgress[]>;
     /**
      * Get a quest by slug
      */
@@ -1955,7 +1982,11 @@ declare class QuestsClient {
      */
     delete(questId: string): Promise<void>;
     /**
-     * Activate a quest
+     * Publish/activate a quest (changes status from draft to active)
+     */
+    publish(questId: string): Promise<Quest>;
+    /**
+     * @deprecated Use publish() instead
      */
     activate(questId: string): Promise<Quest>;
     /**
@@ -1983,9 +2014,9 @@ declare class QuestsClient {
      */
     getUserProgress(questId: string, userId: string): Promise<UserQuestProgress>;
     /**
-     * Complete a step manually
+     * Complete a step manually by step index
      */
-    completeStep(questId: string, userId: string, stepId: string): Promise<UserQuestProgress>;
+    completeStep(questId: string, userId: string, stepIndex: number): Promise<StepCompletionResult>;
     /**
      * Get all quest progress for a user
      */
@@ -2753,4 +2784,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 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 FieldValue, type IngestEventRequest, type IngestEventResponse, IngestionClient, type IngestionClientOptions, type IssueCertificateRequest, type LinkWalletRequest, type ListCertificatesRequest, 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, 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 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 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 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 FieldValue, type IngestEventRequest, type IngestEventResponse, IngestionClient, type IngestionClientOptions, type IssueCertificateRequest, type LinkWalletRequest, type ListCertificatesRequest, 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 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

@@ -1858,15 +1858,27 @@ interface UserQuestProgress {
     user_id: string;
     quest_id: string;
     quest_name: string;
-    status: 'not_started' | 'in_progress' | 'completed' | 'failed' | 'expired';
+    status: 'not_started' | 'in_progress' | 'completed' | 'failed' | 'expired' | 'reward_pending';
     started_at?: string;
     completed_at?: string;
     expires_at?: string;
     completion_count: number;
     current_step_order: number;
+    steps_completed: number;
+    total_steps: number;
+    completion_percentage: number;
     step_progress: StepProgress[];
     points_earned: number;
-    reward_earned: boolean;
+    reward_earned?: RewardEarned;
+}
+interface RewardEarned {
+    id: string;
+    reward_name: string;
+    reward_type: string;
+    value?: number;
+    value_currency?: string;
+    status: string;
+    earned_at: string;
 }
 interface StepProgress {
     step_id: string;
@@ -1876,6 +1888,14 @@ interface StepProgress {
     completed_at?: string;
     event_id?: string;
 }
+interface StepCompletionResult {
+    step_index: number;
+    step_completed: boolean;
+    quest_completed: boolean;
+    current_count: number;
+    target_count: number;
+    points_earned: number;
+}
 interface QuestWithProgress extends Quest {
     user_progress?: UserQuestProgress;
 }
@@ -1938,6 +1958,13 @@ declare class QuestsClient {
      * Get a quest by ID
      */
     get(questId: string): Promise<Quest>;
+    /**
+     * List available quests for a user (active, public quests with user progress)
+     * This is the main endpoint for frontend quest displays
+     */
+    listAvailable(userId: string, options?: {
+        category?: string;
+    }): Promise<QuestWithProgress[]>;
     /**
      * Get a quest by slug
      */
@@ -1955,7 +1982,11 @@ declare class QuestsClient {
      */
     delete(questId: string): Promise<void>;
     /**
-     * Activate a quest
+     * Publish/activate a quest (changes status from draft to active)
+     */
+    publish(questId: string): Promise<Quest>;
+    /**
+     * @deprecated Use publish() instead
      */
     activate(questId: string): Promise<Quest>;
     /**
@@ -1983,9 +2014,9 @@ declare class QuestsClient {
      */
     getUserProgress(questId: string, userId: string): Promise<UserQuestProgress>;
     /**
-     * Complete a step manually
+     * Complete a step manually by step index
      */
-    completeStep(questId: string, userId: string, stepId: string): Promise<UserQuestProgress>;
+    completeStep(questId: string, userId: string, stepIndex: number): Promise<StepCompletionResult>;
     /**
      * Get all quest progress for a user
      */
@@ -2753,4 +2784,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 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 FieldValue, type IngestEventRequest, type IngestEventResponse, IngestionClient, type IngestionClientOptions, type IssueCertificateRequest, type LinkWalletRequest, type ListCertificatesRequest, 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, 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 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 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 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 FieldValue, type IngestEventRequest, type IngestEventResponse, IngestionClient, type IngestionClientOptions, type IssueCertificateRequest, type LinkWalletRequest, type ListCertificatesRequest, 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 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

@@ -1371,6 +1371,16 @@ var QuestsClient = class {
   async get(questId) {
     return this.http.get(`/quests/${questId}`);
   }
+  /**
+   * List available quests for a user (active, public quests with user progress)
+   * This is the main endpoint for frontend quest displays
+   */
+  async listAvailable(userId, options = {}) {
+    const params = new URLSearchParams();
+    params.append("user_id", userId);
+    if (options.category) params.append("category", options.category);
+    return this.http.get(`/quests/available?${params.toString()}`);
+  }
   /**
    * Get a quest by slug
    */
@@ -1399,10 +1409,16 @@ var QuestsClient = class {
   // Quest Status
   // ---------------------------------------------------------------------------
   /**
-   * Activate a quest
+   * Publish/activate a quest (changes status from draft to active)
+   */
+  async publish(questId) {
+    return this.http.post(`/quests/${questId}/publish`, {});
+  }
+  /**
+   * @deprecated Use publish() instead
    */
   async activate(questId) {
-    return this.http.post(`/quests/${questId}/activate`, {});
+    return this.publish(questId);
   }
   /**
    * Pause a quest
@@ -1448,12 +1464,13 @@ var QuestsClient = class {
     return this.http.get(`/quests/${questId}/progress/${encodeURIComponent(userId)}`);
   }
   /**
-   * Complete a step manually
+   * Complete a step manually by step index
    */
-  async completeStep(questId, userId, stepId) {
-    return this.http.post(`/quests/${questId}/steps/${stepId}/complete`, {
-      user_id: userId
-    });
+  async completeStep(questId, userId, stepIndex) {
+    return this.http.post(
+      `/quests/${questId}/progress/${encodeURIComponent(userId)}/step/${stepIndex}/complete`,
+      {}
+    );
   }
   /**
    * Get all quest progress for a user

package/dist/index.mjs

@@ -1319,6 +1319,16 @@ var QuestsClient = class {
   async get(questId) {
     return this.http.get(`/quests/${questId}`);
   }
+  /**
+   * List available quests for a user (active, public quests with user progress)
+   * This is the main endpoint for frontend quest displays
+   */
+  async listAvailable(userId, options = {}) {
+    const params = new URLSearchParams();
+    params.append("user_id", userId);
+    if (options.category) params.append("category", options.category);
+    return this.http.get(`/quests/available?${params.toString()}`);
+  }
   /**
    * Get a quest by slug
    */
@@ -1347,10 +1357,16 @@ var QuestsClient = class {
   // Quest Status
   // ---------------------------------------------------------------------------
   /**
-   * Activate a quest
+   * Publish/activate a quest (changes status from draft to active)
+   */
+  async publish(questId) {
+    return this.http.post(`/quests/${questId}/publish`, {});
+  }
+  /**
+   * @deprecated Use publish() instead
    */
   async activate(questId) {
-    return this.http.post(`/quests/${questId}/activate`, {});
+    return this.publish(questId);
   }
   /**
    * Pause a quest
@@ -1396,12 +1412,13 @@ var QuestsClient = class {
     return this.http.get(`/quests/${questId}/progress/${encodeURIComponent(userId)}`);
   }
   /**
-   * Complete a step manually
+   * Complete a step manually by step index
    */
-  async completeStep(questId, userId, stepId) {
-    return this.http.post(`/quests/${questId}/steps/${stepId}/complete`, {
-      user_id: userId
-    });
+  async completeStep(questId, userId, stepIndex) {
+    return this.http.post(
+      `/quests/${questId}/progress/${encodeURIComponent(userId)}/step/${stepIndex}/complete`,
+      {}
+    );
   }
   /**
    * Get all quest progress for a user

package/package.json

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