@proofchain/sdk 2.14.0 → 2.15.0

package/dist/index.d.mts

@@ -3128,6 +3128,16 @@ interface IngestionClientOptions {
     ingestUrl?: string;
     timeout?: number;
 }
+interface EndUserIngestionClientOptions {
+    /** End-user JWT from your auth provider (Auth0, Firebase, Clerk, etc.) */
+    userToken: string;
+    /** Proofchain tenant slug or client_id */
+    tenantId: string;
+    /** Base URL for the tenant API (default: https://api.proofchain.co.za) */
+    apiUrl?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
 /**
  * High-performance ingestion client for the Rust ingestion API.
  *
@@ -3176,6 +3186,47 @@ declare class IngestionClient {
         ipfsHash?: string;
     }>;
 }
+/**
+ * End-user ingestion client that routes events through the tenant-api JWKS proxy.
+ * Events are validated (JWT + user_id enforcement) then forwarded to the Rust
+ * ingestion pipeline for consistent processing.
+ *
+ * @example
+ * ```typescript
+ * const ingestion = new EndUserIngestionClient({
+ *   userToken: auth.getIdToken(),
+ *   tenantId: 'my-tenant-slug',
+ * });
+ *
+ * // Submit event (user_id MUST match the JWT's user identity)
+ * const result = await ingestion.ingest({
+ *   userId: 'user-123',
+ *   eventType: 'page_view',
+ *   data: { page: '/home' },
+ * });
+ * ```
+ */
+declare class EndUserIngestionClient {
+    private userToken;
+    private tenantId;
+    private apiUrl;
+    private timeout;
+    constructor(options: EndUserIngestionClientOptions);
+    /** Update the end-user JWT token (e.g., after token refresh). */
+    setToken(userToken: string): void;
+    private getHeaders;
+    private handleResponse;
+    /**
+     * Submit a single event as an authenticated end-user.
+     * The userId MUST match the JWT's user identity or the request will be rejected with 403.
+     */
+    ingest(request: IngestEventRequest): Promise<IngestEventResponse>;
+    /**
+     * Submit a batch of events as an authenticated end-user (up to 100 events).
+     * ALL events must have userId matching the JWT's user identity.
+     */
+    ingestBatch(request: BatchIngestRequest): Promise<BatchIngestResponse>;
+}
 
 /**
  * ProofChain SDK Error Classes
@@ -3217,4 +3268,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$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 };
+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, EndUserIngestionClient, type EndUserIngestionClientOptions, 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

@@ -3128,6 +3128,16 @@ interface IngestionClientOptions {
     ingestUrl?: string;
     timeout?: number;
 }
+interface EndUserIngestionClientOptions {
+    /** End-user JWT from your auth provider (Auth0, Firebase, Clerk, etc.) */
+    userToken: string;
+    /** Proofchain tenant slug or client_id */
+    tenantId: string;
+    /** Base URL for the tenant API (default: https://api.proofchain.co.za) */
+    apiUrl?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
 /**
  * High-performance ingestion client for the Rust ingestion API.
  *
@@ -3176,6 +3186,47 @@ declare class IngestionClient {
         ipfsHash?: string;
     }>;
 }
+/**
+ * End-user ingestion client that routes events through the tenant-api JWKS proxy.
+ * Events are validated (JWT + user_id enforcement) then forwarded to the Rust
+ * ingestion pipeline for consistent processing.
+ *
+ * @example
+ * ```typescript
+ * const ingestion = new EndUserIngestionClient({
+ *   userToken: auth.getIdToken(),
+ *   tenantId: 'my-tenant-slug',
+ * });
+ *
+ * // Submit event (user_id MUST match the JWT's user identity)
+ * const result = await ingestion.ingest({
+ *   userId: 'user-123',
+ *   eventType: 'page_view',
+ *   data: { page: '/home' },
+ * });
+ * ```
+ */
+declare class EndUserIngestionClient {
+    private userToken;
+    private tenantId;
+    private apiUrl;
+    private timeout;
+    constructor(options: EndUserIngestionClientOptions);
+    /** Update the end-user JWT token (e.g., after token refresh). */
+    setToken(userToken: string): void;
+    private getHeaders;
+    private handleResponse;
+    /**
+     * Submit a single event as an authenticated end-user.
+     * The userId MUST match the JWT's user identity or the request will be rejected with 403.
+     */
+    ingest(request: IngestEventRequest): Promise<IngestEventResponse>;
+    /**
+     * Submit a batch of events as an authenticated end-user (up to 100 events).
+     * ALL events must have userId matching the JWT's user identity.
+     */
+    ingestBatch(request: BatchIngestRequest): Promise<BatchIngestResponse>;
+}
 
 /**
  * ProofChain SDK Error Classes
@@ -3217,4 +3268,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$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 };
+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, EndUserIngestionClient, type EndUserIngestionClientOptions, 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

@@ -27,6 +27,7 @@ __export(index_exports, {
   CohortLeaderboardClient: () => CohortLeaderboardClient,
   DataViewsClient: () => DataViewsClient,
   DocumentsResource: () => DocumentsResource,
+  EndUserIngestionClient: () => EndUserIngestionClient,
   EndUsersClient: () => EndUsersClient,
   EventsResource: () => EventsResource,
   FanpassLeaderboardClient: () => FanpassLeaderboardClient,
@@ -2552,6 +2553,135 @@ var IngestionClient = class {
     }
   }
 };
+var EndUserIngestionClient = class {
+  constructor(options) {
+    this.userToken = options.userToken;
+    this.tenantId = options.tenantId;
+    this.apiUrl = (options.apiUrl || "https://api.proofchain.co.za").replace(/\/$/, "");
+    this.timeout = options.timeout || 3e4;
+  }
+  /** Update the end-user JWT token (e.g., after token refresh). */
+  setToken(userToken) {
+    this.userToken = userToken;
+  }
+  getHeaders() {
+    return {
+      "Authorization": `Bearer ${this.userToken}`,
+      "X-Tenant-ID": this.tenantId,
+      "Content-Type": "application/json",
+      "User-Agent": USER_AGENT2
+    };
+  }
+  async handleResponse(response) {
+    const contentType = response.headers.get("content-type");
+    const isJson = contentType?.includes("application/json");
+    if (response.ok) {
+      if (response.status === 204 || !isJson) {
+        return {};
+      }
+      return response.json();
+    }
+    const body = isJson ? await response.json().catch(() => ({})) : {};
+    const message = body.detail || body.message || `HTTP ${response.status}`;
+    switch (response.status) {
+      case 401:
+        throw new AuthenticationError(message);
+      case 403:
+        throw new ProofChainError(message, 403, body);
+      case 422:
+      case 400:
+        throw new ValidationError(message, body.errors);
+      case 429:
+        const retryAfter = response.headers.get("Retry-After");
+        throw new RateLimitError(retryAfter ? parseInt(retryAfter, 10) : void 0);
+      default:
+        if (response.status >= 500) {
+          throw new ServerError(message, response.status);
+        }
+        throw new ProofChainError(message, response.status, body);
+    }
+  }
+  /**
+   * Submit a single event as an authenticated end-user.
+   * The userId MUST match the JWT's user identity or the request will be rejected with 403.
+   */
+  async ingest(request) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(`${this.apiUrl}/end-user/events/ingest`, {
+        method: "POST",
+        headers: this.getHeaders(),
+        body: JSON.stringify({
+          user_id: request.userId,
+          event_type: request.eventType,
+          data: request.data || {},
+          event_source: request.eventSource || "end_user_sdk"
+        }),
+        signal: controller.signal
+      });
+      const result = await this.handleResponse(response);
+      return {
+        eventId: result.event_id,
+        certificateId: result.certificate_id,
+        status: result.status,
+        queuePosition: result.queue_position,
+        estimatedConfirmation: result.estimated_confirmation
+      };
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new NetworkError("Request timed out");
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  /**
+   * Submit a batch of events as an authenticated end-user (up to 100 events).
+   * ALL events must have userId matching the JWT's user identity.
+   */
+  async ingestBatch(request) {
+    if (request.events.length > 100) {
+      throw new ValidationError("End-user batch size cannot exceed 100 events");
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout * 2);
+    try {
+      const response = await fetch(`${this.apiUrl}/end-user/events/ingest/batch`, {
+        method: "POST",
+        headers: this.getHeaders(),
+        body: JSON.stringify({
+          events: request.events.map((e) => ({
+            user_id: e.userId,
+            event_type: e.eventType,
+            data: e.data || {},
+            event_source: e.eventSource || "end_user_sdk"
+          }))
+        }),
+        signal: controller.signal
+      });
+      const result = await this.handleResponse(response);
+      return {
+        totalEvents: result.total_events || result.total,
+        queued: result.queued,
+        failed: result.failed,
+        results: (result.results || result.responses || []).map((r) => ({
+          eventId: r.event_id,
+          certificateId: r.certificate_id,
+          status: r.status
+        }))
+      };
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new NetworkError("Request timed out");
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,
@@ -2561,6 +2691,7 @@ var IngestionClient = class {
   CohortLeaderboardClient,
   DataViewsClient,
   DocumentsResource,
+  EndUserIngestionClient,
   EndUsersClient,
   EventsResource,
   FanpassLeaderboardClient,

package/dist/index.mjs

@@ -2498,6 +2498,135 @@ var IngestionClient = class {
     }
   }
 };
+var EndUserIngestionClient = class {
+  constructor(options) {
+    this.userToken = options.userToken;
+    this.tenantId = options.tenantId;
+    this.apiUrl = (options.apiUrl || "https://api.proofchain.co.za").replace(/\/$/, "");
+    this.timeout = options.timeout || 3e4;
+  }
+  /** Update the end-user JWT token (e.g., after token refresh). */
+  setToken(userToken) {
+    this.userToken = userToken;
+  }
+  getHeaders() {
+    return {
+      "Authorization": `Bearer ${this.userToken}`,
+      "X-Tenant-ID": this.tenantId,
+      "Content-Type": "application/json",
+      "User-Agent": USER_AGENT2
+    };
+  }
+  async handleResponse(response) {
+    const contentType = response.headers.get("content-type");
+    const isJson = contentType?.includes("application/json");
+    if (response.ok) {
+      if (response.status === 204 || !isJson) {
+        return {};
+      }
+      return response.json();
+    }
+    const body = isJson ? await response.json().catch(() => ({})) : {};
+    const message = body.detail || body.message || `HTTP ${response.status}`;
+    switch (response.status) {
+      case 401:
+        throw new AuthenticationError(message);
+      case 403:
+        throw new ProofChainError(message, 403, body);
+      case 422:
+      case 400:
+        throw new ValidationError(message, body.errors);
+      case 429:
+        const retryAfter = response.headers.get("Retry-After");
+        throw new RateLimitError(retryAfter ? parseInt(retryAfter, 10) : void 0);
+      default:
+        if (response.status >= 500) {
+          throw new ServerError(message, response.status);
+        }
+        throw new ProofChainError(message, response.status, body);
+    }
+  }
+  /**
+   * Submit a single event as an authenticated end-user.
+   * The userId MUST match the JWT's user identity or the request will be rejected with 403.
+   */
+  async ingest(request) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(`${this.apiUrl}/end-user/events/ingest`, {
+        method: "POST",
+        headers: this.getHeaders(),
+        body: JSON.stringify({
+          user_id: request.userId,
+          event_type: request.eventType,
+          data: request.data || {},
+          event_source: request.eventSource || "end_user_sdk"
+        }),
+        signal: controller.signal
+      });
+      const result = await this.handleResponse(response);
+      return {
+        eventId: result.event_id,
+        certificateId: result.certificate_id,
+        status: result.status,
+        queuePosition: result.queue_position,
+        estimatedConfirmation: result.estimated_confirmation
+      };
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new NetworkError("Request timed out");
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  /**
+   * Submit a batch of events as an authenticated end-user (up to 100 events).
+   * ALL events must have userId matching the JWT's user identity.
+   */
+  async ingestBatch(request) {
+    if (request.events.length > 100) {
+      throw new ValidationError("End-user batch size cannot exceed 100 events");
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout * 2);
+    try {
+      const response = await fetch(`${this.apiUrl}/end-user/events/ingest/batch`, {
+        method: "POST",
+        headers: this.getHeaders(),
+        body: JSON.stringify({
+          events: request.events.map((e) => ({
+            user_id: e.userId,
+            event_type: e.eventType,
+            data: e.data || {},
+            event_source: e.eventSource || "end_user_sdk"
+          }))
+        }),
+        signal: controller.signal
+      });
+      const result = await this.handleResponse(response);
+      return {
+        totalEvents: result.total_events || result.total,
+        queued: result.queued,
+        failed: result.failed,
+        results: (result.results || result.responses || []).map((r) => ({
+          eventId: r.event_id,
+          certificateId: r.certificate_id,
+          status: r.status
+        }))
+      };
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new NetworkError("Request timed out");
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+};
 export {
   AuthenticationError,
   AuthorizationError,
@@ -2506,6 +2635,7 @@ export {
   CohortLeaderboardClient,
   DataViewsClient,
   DocumentsResource,
+  EndUserIngestionClient,
   EndUsersClient,
   EventsResource,
   FanpassLeaderboardClient,

package/package.json

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