@siglume/direct-request-payment 0.4.15 → 0.4.17

package/dist/index.d.cts

@@ -6,7 +6,7 @@ declare const DIRECT_REQUEST_PAYMENT_RECEIPT_KIND = "sdrp_direct_payment";
 declare const DIRECT_REQUEST_PAYMENT_ALLOWANCE_RECEIPT_KIND = "sdrp_direct_payment_allowance";
 declare const DIRECT_REQUEST_PAYMENT_REFERENCE_TYPE = "sdrp_direct_payment_requirement";
 declare const DEFAULT_WEBHOOK_TOLERANCE_SECONDS = 300;
-declare const DIRECT_REQUEST_PAYMENT_SDK_VERSION = "0.4.15";
+declare const DIRECT_REQUEST_PAYMENT_SDK_VERSION = "0.4.17";
 declare const DIRECT_REQUEST_PAYMENT_STANDARD_SETTLED_STATUS = "settled";
 declare const DIRECT_REQUEST_PAYMENT_METERED_ACCEPTED_STATUS = "pending_settlement";
 declare const DIRECT_REQUEST_PAYMENT_STANDARD_FINALITY = "per_payment_onchain";
@@ -14,6 +14,7 @@ declare const DIRECT_REQUEST_PAYMENT_METERED_FINALITY = "aggregated_onchain_sett
 type DirectRequestPaymentCurrency = "JPY" | "USD";
 type DirectRequestPaymentToken = "JPYC" | "USDC";
 type DirectRequestPaymentMeteredPlanType = "micro" | "nano";
+type DirectRequestPaymentSettlementTrigger = "amount_threshold" | "scheduled_close";
 type DirectRequestPaymentMinorAmount = string;
 type DirectRequestPaymentRawWebhookBody = Uint8Array | ArrayBuffer | string;
 type DirectRequestPaymentWebhookSignatureBody = DirectRequestPaymentRawWebhookBody | Record<string, unknown>;
@@ -95,7 +96,7 @@ interface DirectRequestPaymentSettlementBatch {
     plan_type: string;
     settlement_cadence: string;
     status: string;
-    settlement_trigger?: "amount_threshold" | "scheduled_close" | string | null;
+    settlement_trigger?: DirectRequestPaymentSettlementTrigger | null;
     settlement_threshold_minor?: DirectRequestPaymentMinorAmount | null;
     threshold_reached_at?: string | null;
     total_unsettled_exposure_minor?: DirectRequestPaymentMinorAmount | null;
@@ -122,6 +123,12 @@ interface DirectRequestPaymentSettlementBatch {
     settled_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
     unsettled_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
     past_due_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    terminal_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    uncollectible_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    written_off_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    terminal_status?: "uncollectible" | "written_off" | string | null;
+    terminal_marked_at?: string | null;
+    terminal_reason_code?: string | null;
     buyer_period_ref?: string | null;
     failure_reason_code?: string | null;
     failure_reason_label?: string | null;
@@ -129,21 +136,68 @@ interface DirectRequestPaymentSettlementBatch {
     support_reference?: string | null;
     [key: string]: unknown;
 }
+interface DirectRequestPaymentMeteredOpenPeriod {
+    plan_type?: DirectRequestPaymentMeteredPlanType | string;
+    settlement_cadence?: "weekly" | "monthly" | string;
+    currency?: DirectRequestPaymentCurrency | string;
+    token_symbol?: DirectRequestPaymentToken | string;
+    period_start?: string | null;
+    period_end?: string | null;
+    close_at?: string | null;
+    settlement_trigger?: DirectRequestPaymentSettlementTrigger | null;
+    settlement_threshold_minor?: DirectRequestPaymentMinorAmount | null;
+    threshold_reached_at?: string | null;
+    provider_gross_amount_minor?: DirectRequestPaymentMinorAmount;
+    provider_usage_amount_minor?: DirectRequestPaymentMinorAmount;
+    protocol_fee_minor?: DirectRequestPaymentMinorAmount;
+    provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    buyer_debit_minor?: DirectRequestPaymentMinorAmount;
+    total_unsettled_exposure_minor?: DirectRequestPaymentMinorAmount | null;
+    [key: string]: unknown;
+}
+interface DirectRequestPaymentPastDueBlock {
+    settlement_batch_id?: string;
+    plan_type?: DirectRequestPaymentMeteredPlanType | string;
+    currency?: DirectRequestPaymentCurrency | string;
+    token_symbol?: DirectRequestPaymentToken | string;
+    total_unsettled_exposure_minor?: DirectRequestPaymentMinorAmount | null;
+    past_due_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    failure_reason_code?: string | null;
+    support_reference?: string | null;
+    [key: string]: unknown;
+}
+interface DirectRequestPaymentBalanceSufficiency {
+    sufficient?: boolean;
+    currency?: DirectRequestPaymentCurrency | string;
+    token_symbol?: DirectRequestPaymentToken | string;
+    required_minor?: DirectRequestPaymentMinorAmount;
+    available_minor?: DirectRequestPaymentMinorAmount;
+    [key: string]: unknown;
+}
+interface DirectRequestPaymentProviderMeteredTotals {
+    settled_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    unsettled_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    past_due_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    terminal_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    uncollectible_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    written_off_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    [key: string]: DirectRequestPaymentMinorAmount | undefined;
+}
 interface DirectRequestPaymentBuyerMeteredSummary {
     role: "buyer";
-    open_periods: Array<Record<string, unknown>>;
+    open_periods: DirectRequestPaymentMeteredOpenPeriod[];
     settlement_batches: DirectRequestPaymentSettlementBatch[];
-    past_due_blocks: Array<Record<string, unknown>>;
-    balance_sufficiency?: Record<string, unknown>;
+    past_due_blocks: DirectRequestPaymentPastDueBlock[];
+    balance_sufficiency?: DirectRequestPaymentBalanceSufficiency;
     [key: string]: unknown;
 }
 interface DirectRequestPaymentProviderMeteredSummary {
     role: "provider";
     timezone?: string | null;
     filters?: Record<string, unknown>;
-    open_periods: Array<Record<string, unknown>>;
+    open_periods: DirectRequestPaymentMeteredOpenPeriod[];
     periods: DirectRequestPaymentSettlementBatch[];
-    totals: Record<string, DirectRequestPaymentMinorAmount>;
+    totals: DirectRequestPaymentProviderMeteredTotals;
     [key: string]: unknown;
 }
 interface DirectRequestPaymentChallengeInput {
@@ -420,6 +474,14 @@ interface DirectRequestPaymentWebhookEvent {
         settlement_cadence?: "per_payment" | "weekly" | "monthly" | string | null;
         finality?: string | null;
         protocol_fee_minor?: DirectRequestPaymentMinorAmount | null;
+        provider_gross_amount_minor?: DirectRequestPaymentMinorAmount | null;
+        provider_usage_amount_minor?: DirectRequestPaymentMinorAmount | null;
+        provider_receivable_minor?: DirectRequestPaymentMinorAmount | null;
+        buyer_debit_minor?: DirectRequestPaymentMinorAmount | null;
+        settlement_trigger?: DirectRequestPaymentSettlementTrigger | string | null;
+        settlement_threshold_minor?: DirectRequestPaymentMinorAmount | null;
+        threshold_reached_at?: string | null;
+        total_unsettled_exposure_minor?: DirectRequestPaymentMinorAmount | null;
         settlement_status?: string | null;
         settlement_batch_id?: string | null;
         chain_receipt_id?: string | null;
@@ -430,7 +492,7 @@ interface DirectRequestPaymentWebhookEvent {
     [key: string]: unknown;
 }
 type DirectPaymentConfirmationKind = "standard_settled" | "metered_usage_accepted" | "metered_batch_settled" | "unknown";
-type DirectPaymentConfirmationUnknownReason = "not_direct_payment_confirmed" | "invalid_metered_settlement_confirmation" | "missing_standard_settlement_fields" | "missing_metered_usage_fields" | "unknown_confirmation_shape";
+type DirectPaymentConfirmationUnknownReason = "not_direct_payment_confirmed" | "unsupported_confirmation_mode" | "invalid_metered_settlement_confirmation" | "missing_standard_settlement_fields" | "missing_metered_usage_fields" | "unknown_confirmation_shape";
 interface DirectPaymentStandardSettledClassification {
     kind: "standard_settled";
     event: DirectRequestPaymentWebhookEvent;
@@ -497,7 +559,7 @@ declare class SiglumeWebhookPayloadError extends SiglumeDirectRequestPaymentErro
     constructor(message: string);
 }
 declare class DirectRequestPaymentClient {
-    readonly auth_token: string;
+    #private;
     readonly base_url: string;
     readonly timeout_ms: number;
     readonly user_agent: string;
@@ -525,7 +587,7 @@ declare class DirectRequestPaymentClient {
     request<T>(method: string, path: string, json_body?: unknown): Promise<T>;
 }
 declare class DirectRequestPaymentMerchantClient {
-    readonly auth_token: string;
+    #private;
     readonly base_url: string;
     readonly timeout_ms: number;
     readonly user_agent: string;
@@ -638,4 +700,4 @@ declare const verifyExternal402Challenge: typeof verifyDirectRequestPaymentChall
 declare const createExternal402RecurringChallenge: typeof createDirectRequestPaymentRecurringChallenge;
 declare const verifyExternal402RecurringChallenge: typeof verifyDirectRequestPaymentRecurringChallenge;
 
-export { DEFAULT_SIGLUME_API_BASE, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, DIRECT_REQUEST_PAYMENT_ALLOWANCE_RECEIPT_KIND, DIRECT_REQUEST_PAYMENT_CHALLENGE_SCHEME, DIRECT_REQUEST_PAYMENT_METERED_ACCEPTED_STATUS, DIRECT_REQUEST_PAYMENT_METERED_FINALITY, DIRECT_REQUEST_PAYMENT_MODE, DIRECT_REQUEST_PAYMENT_RECEIPT_KIND, DIRECT_REQUEST_PAYMENT_RECURRING_CHALLENGE_SCHEME, DIRECT_REQUEST_PAYMENT_REFERENCE_TYPE, DIRECT_REQUEST_PAYMENT_SDK_VERSION, DIRECT_REQUEST_PAYMENT_STANDARD_FINALITY, DIRECT_REQUEST_PAYMENT_STANDARD_SETTLED_STATUS, type DirectPaymentConfirmationClassification, type DirectPaymentConfirmationKind, type DirectPaymentConfirmationUnknownReason, type DirectPaymentMeteredBatchSettledClassification, type DirectPaymentMeteredUsageAcceptedClassification, type DirectPaymentRequirement, type DirectPaymentRequirementCreateInput, type DirectPaymentStandardSettledClassification, type DirectPaymentUnknownClassification, type DirectPaymentVerifyInput, type DirectRequestPaymentBillingPlan, type DirectRequestPaymentBuyerMeteredQuery, type DirectRequestPaymentBuyerMeteredSummary, type DirectRequestPaymentBuyerUsageEvent, type DirectRequestPaymentChallenge, type DirectRequestPaymentChallengeInput, type DirectRequestPaymentCheckoutSetupInput, type DirectRequestPaymentCheckoutSetupResult, DirectRequestPaymentClient, type DirectRequestPaymentClientOptions, type DirectRequestPaymentCurrency, type DirectRequestPaymentListResponse, type DirectRequestPaymentMerchantAccount, type DirectRequestPaymentMerchantBillingMandateInput, DirectRequestPaymentMerchantClient, type DirectRequestPaymentMerchantResponse, type DirectRequestPaymentMerchantSetupInput, type DirectRequestPaymentMeteredListQuery, type DirectRequestPaymentMeteredPlanType, type DirectRequestPaymentMinorAmount, type DirectRequestPaymentProviderMeteredListQuery, type DirectRequestPaymentProviderMeteredQuery, type DirectRequestPaymentProviderMeteredSummary, type DirectRequestPaymentProviderUsageEvent, type DirectRequestPaymentRawWebhookBody, type DirectRequestPaymentRecurringCadence, type DirectRequestPaymentRecurringChallenge, type DirectRequestPaymentRecurringChallengeInput, type DirectRequestPaymentSettlementBatch, type DirectRequestPaymentToken, type DirectRequestPaymentWebhookEvent, type DirectRequestPaymentWebhookSignatureBody, type DirectRequestPaymentWebhookSubscription, type DirectRequestPaymentWebhookSubscriptionInput, HostedCheckoutNotAvailableError, type HostedCheckoutSession, type HostedCheckoutSessionCreateInput, type HostedCheckoutSessionCreateResult, type ParsedDirectRequestPaymentChallenge, SiglumeApiError, SiglumeDirectRequestPaymentError, type SiglumeEnvelopeMeta, SiglumeWebhookPayloadError, SiglumeWebhookSignatureError, type Web3PreparedTransactionExecutePayload, type Web3PreparedTransactionExecuteResult, type Web3TransactionRequest, type WebhookSignatureVerification, buildAllowanceExecutionPayload, buildPaymentExecutionPayload, buildPreparedTransactionExecutionPayload, buildWebhookSignatureHeader, classifyDirectPaymentConfirmation, computeWebhookSignature, createDirectRequestPaymentChallenge, createDirectRequestPaymentChallengeSignature, createDirectRequestPaymentRecurringChallenge, createDirectRequestPaymentRecurringChallengeSignature, createExternal402Challenge, createExternal402RecurringChallenge, directRequestPaymentChallengeHash, directRequestPaymentRequestHash, directRequestPaymentRequestHashV2, parseDirectRequestPaymentChallenge, parseDirectRequestPaymentWebhookEvent, verifyDirectRequestPaymentChallenge, verifyDirectRequestPaymentRecurringChallenge, verifyDirectRequestPaymentWebhook, verifyExternal402Challenge, verifyExternal402RecurringChallenge, verifyWebhookSignature };
+export { DEFAULT_SIGLUME_API_BASE, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, DIRECT_REQUEST_PAYMENT_ALLOWANCE_RECEIPT_KIND, DIRECT_REQUEST_PAYMENT_CHALLENGE_SCHEME, DIRECT_REQUEST_PAYMENT_METERED_ACCEPTED_STATUS, DIRECT_REQUEST_PAYMENT_METERED_FINALITY, DIRECT_REQUEST_PAYMENT_MODE, DIRECT_REQUEST_PAYMENT_RECEIPT_KIND, DIRECT_REQUEST_PAYMENT_RECURRING_CHALLENGE_SCHEME, DIRECT_REQUEST_PAYMENT_REFERENCE_TYPE, DIRECT_REQUEST_PAYMENT_SDK_VERSION, DIRECT_REQUEST_PAYMENT_STANDARD_FINALITY, DIRECT_REQUEST_PAYMENT_STANDARD_SETTLED_STATUS, type DirectPaymentConfirmationClassification, type DirectPaymentConfirmationKind, type DirectPaymentConfirmationUnknownReason, type DirectPaymentMeteredBatchSettledClassification, type DirectPaymentMeteredUsageAcceptedClassification, type DirectPaymentRequirement, type DirectPaymentRequirementCreateInput, type DirectPaymentStandardSettledClassification, type DirectPaymentUnknownClassification, type DirectPaymentVerifyInput, type DirectRequestPaymentBalanceSufficiency, type DirectRequestPaymentBillingPlan, type DirectRequestPaymentBuyerMeteredQuery, type DirectRequestPaymentBuyerMeteredSummary, type DirectRequestPaymentBuyerUsageEvent, type DirectRequestPaymentChallenge, type DirectRequestPaymentChallengeInput, type DirectRequestPaymentCheckoutSetupInput, type DirectRequestPaymentCheckoutSetupResult, DirectRequestPaymentClient, type DirectRequestPaymentClientOptions, type DirectRequestPaymentCurrency, type DirectRequestPaymentListResponse, type DirectRequestPaymentMerchantAccount, type DirectRequestPaymentMerchantBillingMandateInput, DirectRequestPaymentMerchantClient, type DirectRequestPaymentMerchantResponse, type DirectRequestPaymentMerchantSetupInput, type DirectRequestPaymentMeteredListQuery, type DirectRequestPaymentMeteredOpenPeriod, type DirectRequestPaymentMeteredPlanType, type DirectRequestPaymentMinorAmount, type DirectRequestPaymentPastDueBlock, type DirectRequestPaymentProviderMeteredListQuery, type DirectRequestPaymentProviderMeteredQuery, type DirectRequestPaymentProviderMeteredSummary, type DirectRequestPaymentProviderMeteredTotals, type DirectRequestPaymentProviderUsageEvent, type DirectRequestPaymentRawWebhookBody, type DirectRequestPaymentRecurringCadence, type DirectRequestPaymentRecurringChallenge, type DirectRequestPaymentRecurringChallengeInput, type DirectRequestPaymentSettlementBatch, type DirectRequestPaymentSettlementTrigger, type DirectRequestPaymentToken, type DirectRequestPaymentWebhookEvent, type DirectRequestPaymentWebhookSignatureBody, type DirectRequestPaymentWebhookSubscription, type DirectRequestPaymentWebhookSubscriptionInput, HostedCheckoutNotAvailableError, type HostedCheckoutSession, type HostedCheckoutSessionCreateInput, type HostedCheckoutSessionCreateResult, type ParsedDirectRequestPaymentChallenge, SiglumeApiError, SiglumeDirectRequestPaymentError, type SiglumeEnvelopeMeta, SiglumeWebhookPayloadError, SiglumeWebhookSignatureError, type Web3PreparedTransactionExecutePayload, type Web3PreparedTransactionExecuteResult, type Web3TransactionRequest, type WebhookSignatureVerification, buildAllowanceExecutionPayload, buildPaymentExecutionPayload, buildPreparedTransactionExecutionPayload, buildWebhookSignatureHeader, classifyDirectPaymentConfirmation, computeWebhookSignature, createDirectRequestPaymentChallenge, createDirectRequestPaymentChallengeSignature, createDirectRequestPaymentRecurringChallenge, createDirectRequestPaymentRecurringChallengeSignature, createExternal402Challenge, createExternal402RecurringChallenge, directRequestPaymentChallengeHash, directRequestPaymentRequestHash, directRequestPaymentRequestHashV2, parseDirectRequestPaymentChallenge, parseDirectRequestPaymentWebhookEvent, verifyDirectRequestPaymentChallenge, verifyDirectRequestPaymentRecurringChallenge, verifyDirectRequestPaymentWebhook, verifyExternal402Challenge, verifyExternal402RecurringChallenge, verifyWebhookSignature };

package/dist/index.d.ts

@@ -6,7 +6,7 @@ declare const DIRECT_REQUEST_PAYMENT_RECEIPT_KIND = "sdrp_direct_payment";
 declare const DIRECT_REQUEST_PAYMENT_ALLOWANCE_RECEIPT_KIND = "sdrp_direct_payment_allowance";
 declare const DIRECT_REQUEST_PAYMENT_REFERENCE_TYPE = "sdrp_direct_payment_requirement";
 declare const DEFAULT_WEBHOOK_TOLERANCE_SECONDS = 300;
-declare const DIRECT_REQUEST_PAYMENT_SDK_VERSION = "0.4.15";
+declare const DIRECT_REQUEST_PAYMENT_SDK_VERSION = "0.4.17";
 declare const DIRECT_REQUEST_PAYMENT_STANDARD_SETTLED_STATUS = "settled";
 declare const DIRECT_REQUEST_PAYMENT_METERED_ACCEPTED_STATUS = "pending_settlement";
 declare const DIRECT_REQUEST_PAYMENT_STANDARD_FINALITY = "per_payment_onchain";
@@ -14,6 +14,7 @@ declare const DIRECT_REQUEST_PAYMENT_METERED_FINALITY = "aggregated_onchain_sett
 type DirectRequestPaymentCurrency = "JPY" | "USD";
 type DirectRequestPaymentToken = "JPYC" | "USDC";
 type DirectRequestPaymentMeteredPlanType = "micro" | "nano";
+type DirectRequestPaymentSettlementTrigger = "amount_threshold" | "scheduled_close";
 type DirectRequestPaymentMinorAmount = string;
 type DirectRequestPaymentRawWebhookBody = Uint8Array | ArrayBuffer | string;
 type DirectRequestPaymentWebhookSignatureBody = DirectRequestPaymentRawWebhookBody | Record<string, unknown>;
@@ -95,7 +96,7 @@ interface DirectRequestPaymentSettlementBatch {
     plan_type: string;
     settlement_cadence: string;
     status: string;
-    settlement_trigger?: "amount_threshold" | "scheduled_close" | string | null;
+    settlement_trigger?: DirectRequestPaymentSettlementTrigger | null;
     settlement_threshold_minor?: DirectRequestPaymentMinorAmount | null;
     threshold_reached_at?: string | null;
     total_unsettled_exposure_minor?: DirectRequestPaymentMinorAmount | null;
@@ -122,6 +123,12 @@ interface DirectRequestPaymentSettlementBatch {
     settled_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
     unsettled_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
     past_due_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    terminal_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    uncollectible_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    written_off_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    terminal_status?: "uncollectible" | "written_off" | string | null;
+    terminal_marked_at?: string | null;
+    terminal_reason_code?: string | null;
     buyer_period_ref?: string | null;
     failure_reason_code?: string | null;
     failure_reason_label?: string | null;
@@ -129,21 +136,68 @@ interface DirectRequestPaymentSettlementBatch {
     support_reference?: string | null;
     [key: string]: unknown;
 }
+interface DirectRequestPaymentMeteredOpenPeriod {
+    plan_type?: DirectRequestPaymentMeteredPlanType | string;
+    settlement_cadence?: "weekly" | "monthly" | string;
+    currency?: DirectRequestPaymentCurrency | string;
+    token_symbol?: DirectRequestPaymentToken | string;
+    period_start?: string | null;
+    period_end?: string | null;
+    close_at?: string | null;
+    settlement_trigger?: DirectRequestPaymentSettlementTrigger | null;
+    settlement_threshold_minor?: DirectRequestPaymentMinorAmount | null;
+    threshold_reached_at?: string | null;
+    provider_gross_amount_minor?: DirectRequestPaymentMinorAmount;
+    provider_usage_amount_minor?: DirectRequestPaymentMinorAmount;
+    protocol_fee_minor?: DirectRequestPaymentMinorAmount;
+    provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    buyer_debit_minor?: DirectRequestPaymentMinorAmount;
+    total_unsettled_exposure_minor?: DirectRequestPaymentMinorAmount | null;
+    [key: string]: unknown;
+}
+interface DirectRequestPaymentPastDueBlock {
+    settlement_batch_id?: string;
+    plan_type?: DirectRequestPaymentMeteredPlanType | string;
+    currency?: DirectRequestPaymentCurrency | string;
+    token_symbol?: DirectRequestPaymentToken | string;
+    total_unsettled_exposure_minor?: DirectRequestPaymentMinorAmount | null;
+    past_due_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    failure_reason_code?: string | null;
+    support_reference?: string | null;
+    [key: string]: unknown;
+}
+interface DirectRequestPaymentBalanceSufficiency {
+    sufficient?: boolean;
+    currency?: DirectRequestPaymentCurrency | string;
+    token_symbol?: DirectRequestPaymentToken | string;
+    required_minor?: DirectRequestPaymentMinorAmount;
+    available_minor?: DirectRequestPaymentMinorAmount;
+    [key: string]: unknown;
+}
+interface DirectRequestPaymentProviderMeteredTotals {
+    settled_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    unsettled_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    past_due_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    terminal_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    uncollectible_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    written_off_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    [key: string]: DirectRequestPaymentMinorAmount | undefined;
+}
 interface DirectRequestPaymentBuyerMeteredSummary {
     role: "buyer";
-    open_periods: Array<Record<string, unknown>>;
+    open_periods: DirectRequestPaymentMeteredOpenPeriod[];
     settlement_batches: DirectRequestPaymentSettlementBatch[];
-    past_due_blocks: Array<Record<string, unknown>>;
-    balance_sufficiency?: Record<string, unknown>;
+    past_due_blocks: DirectRequestPaymentPastDueBlock[];
+    balance_sufficiency?: DirectRequestPaymentBalanceSufficiency;
     [key: string]: unknown;
 }
 interface DirectRequestPaymentProviderMeteredSummary {
     role: "provider";
     timezone?: string | null;
     filters?: Record<string, unknown>;
-    open_periods: Array<Record<string, unknown>>;
+    open_periods: DirectRequestPaymentMeteredOpenPeriod[];
     periods: DirectRequestPaymentSettlementBatch[];
-    totals: Record<string, DirectRequestPaymentMinorAmount>;
+    totals: DirectRequestPaymentProviderMeteredTotals;
     [key: string]: unknown;
 }
 interface DirectRequestPaymentChallengeInput {
@@ -420,6 +474,14 @@ interface DirectRequestPaymentWebhookEvent {
         settlement_cadence?: "per_payment" | "weekly" | "monthly" | string | null;
         finality?: string | null;
         protocol_fee_minor?: DirectRequestPaymentMinorAmount | null;
+        provider_gross_amount_minor?: DirectRequestPaymentMinorAmount | null;
+        provider_usage_amount_minor?: DirectRequestPaymentMinorAmount | null;
+        provider_receivable_minor?: DirectRequestPaymentMinorAmount | null;
+        buyer_debit_minor?: DirectRequestPaymentMinorAmount | null;
+        settlement_trigger?: DirectRequestPaymentSettlementTrigger | string | null;
+        settlement_threshold_minor?: DirectRequestPaymentMinorAmount | null;
+        threshold_reached_at?: string | null;
+        total_unsettled_exposure_minor?: DirectRequestPaymentMinorAmount | null;
         settlement_status?: string | null;
         settlement_batch_id?: string | null;
         chain_receipt_id?: string | null;
@@ -430,7 +492,7 @@ interface DirectRequestPaymentWebhookEvent {
     [key: string]: unknown;
 }
 type DirectPaymentConfirmationKind = "standard_settled" | "metered_usage_accepted" | "metered_batch_settled" | "unknown";
-type DirectPaymentConfirmationUnknownReason = "not_direct_payment_confirmed" | "invalid_metered_settlement_confirmation" | "missing_standard_settlement_fields" | "missing_metered_usage_fields" | "unknown_confirmation_shape";
+type DirectPaymentConfirmationUnknownReason = "not_direct_payment_confirmed" | "unsupported_confirmation_mode" | "invalid_metered_settlement_confirmation" | "missing_standard_settlement_fields" | "missing_metered_usage_fields" | "unknown_confirmation_shape";
 interface DirectPaymentStandardSettledClassification {
     kind: "standard_settled";
     event: DirectRequestPaymentWebhookEvent;
@@ -497,7 +559,7 @@ declare class SiglumeWebhookPayloadError extends SiglumeDirectRequestPaymentErro
     constructor(message: string);
 }
 declare class DirectRequestPaymentClient {
-    readonly auth_token: string;
+    #private;
     readonly base_url: string;
     readonly timeout_ms: number;
     readonly user_agent: string;
@@ -525,7 +587,7 @@ declare class DirectRequestPaymentClient {
     request<T>(method: string, path: string, json_body?: unknown): Promise<T>;
 }
 declare class DirectRequestPaymentMerchantClient {
-    readonly auth_token: string;
+    #private;
     readonly base_url: string;
     readonly timeout_ms: number;
     readonly user_agent: string;
@@ -638,4 +700,4 @@ declare const verifyExternal402Challenge: typeof verifyDirectRequestPaymentChall
 declare const createExternal402RecurringChallenge: typeof createDirectRequestPaymentRecurringChallenge;
 declare const verifyExternal402RecurringChallenge: typeof verifyDirectRequestPaymentRecurringChallenge;
 
-export { DEFAULT_SIGLUME_API_BASE, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, DIRECT_REQUEST_PAYMENT_ALLOWANCE_RECEIPT_KIND, DIRECT_REQUEST_PAYMENT_CHALLENGE_SCHEME, DIRECT_REQUEST_PAYMENT_METERED_ACCEPTED_STATUS, DIRECT_REQUEST_PAYMENT_METERED_FINALITY, DIRECT_REQUEST_PAYMENT_MODE, DIRECT_REQUEST_PAYMENT_RECEIPT_KIND, DIRECT_REQUEST_PAYMENT_RECURRING_CHALLENGE_SCHEME, DIRECT_REQUEST_PAYMENT_REFERENCE_TYPE, DIRECT_REQUEST_PAYMENT_SDK_VERSION, DIRECT_REQUEST_PAYMENT_STANDARD_FINALITY, DIRECT_REQUEST_PAYMENT_STANDARD_SETTLED_STATUS, type DirectPaymentConfirmationClassification, type DirectPaymentConfirmationKind, type DirectPaymentConfirmationUnknownReason, type DirectPaymentMeteredBatchSettledClassification, type DirectPaymentMeteredUsageAcceptedClassification, type DirectPaymentRequirement, type DirectPaymentRequirementCreateInput, type DirectPaymentStandardSettledClassification, type DirectPaymentUnknownClassification, type DirectPaymentVerifyInput, type DirectRequestPaymentBillingPlan, type DirectRequestPaymentBuyerMeteredQuery, type DirectRequestPaymentBuyerMeteredSummary, type DirectRequestPaymentBuyerUsageEvent, type DirectRequestPaymentChallenge, type DirectRequestPaymentChallengeInput, type DirectRequestPaymentCheckoutSetupInput, type DirectRequestPaymentCheckoutSetupResult, DirectRequestPaymentClient, type DirectRequestPaymentClientOptions, type DirectRequestPaymentCurrency, type DirectRequestPaymentListResponse, type DirectRequestPaymentMerchantAccount, type DirectRequestPaymentMerchantBillingMandateInput, DirectRequestPaymentMerchantClient, type DirectRequestPaymentMerchantResponse, type DirectRequestPaymentMerchantSetupInput, type DirectRequestPaymentMeteredListQuery, type DirectRequestPaymentMeteredPlanType, type DirectRequestPaymentMinorAmount, type DirectRequestPaymentProviderMeteredListQuery, type DirectRequestPaymentProviderMeteredQuery, type DirectRequestPaymentProviderMeteredSummary, type DirectRequestPaymentProviderUsageEvent, type DirectRequestPaymentRawWebhookBody, type DirectRequestPaymentRecurringCadence, type DirectRequestPaymentRecurringChallenge, type DirectRequestPaymentRecurringChallengeInput, type DirectRequestPaymentSettlementBatch, type DirectRequestPaymentToken, type DirectRequestPaymentWebhookEvent, type DirectRequestPaymentWebhookSignatureBody, type DirectRequestPaymentWebhookSubscription, type DirectRequestPaymentWebhookSubscriptionInput, HostedCheckoutNotAvailableError, type HostedCheckoutSession, type HostedCheckoutSessionCreateInput, type HostedCheckoutSessionCreateResult, type ParsedDirectRequestPaymentChallenge, SiglumeApiError, SiglumeDirectRequestPaymentError, type SiglumeEnvelopeMeta, SiglumeWebhookPayloadError, SiglumeWebhookSignatureError, type Web3PreparedTransactionExecutePayload, type Web3PreparedTransactionExecuteResult, type Web3TransactionRequest, type WebhookSignatureVerification, buildAllowanceExecutionPayload, buildPaymentExecutionPayload, buildPreparedTransactionExecutionPayload, buildWebhookSignatureHeader, classifyDirectPaymentConfirmation, computeWebhookSignature, createDirectRequestPaymentChallenge, createDirectRequestPaymentChallengeSignature, createDirectRequestPaymentRecurringChallenge, createDirectRequestPaymentRecurringChallengeSignature, createExternal402Challenge, createExternal402RecurringChallenge, directRequestPaymentChallengeHash, directRequestPaymentRequestHash, directRequestPaymentRequestHashV2, parseDirectRequestPaymentChallenge, parseDirectRequestPaymentWebhookEvent, verifyDirectRequestPaymentChallenge, verifyDirectRequestPaymentRecurringChallenge, verifyDirectRequestPaymentWebhook, verifyExternal402Challenge, verifyExternal402RecurringChallenge, verifyWebhookSignature };
+export { DEFAULT_SIGLUME_API_BASE, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, DIRECT_REQUEST_PAYMENT_ALLOWANCE_RECEIPT_KIND, DIRECT_REQUEST_PAYMENT_CHALLENGE_SCHEME, DIRECT_REQUEST_PAYMENT_METERED_ACCEPTED_STATUS, DIRECT_REQUEST_PAYMENT_METERED_FINALITY, DIRECT_REQUEST_PAYMENT_MODE, DIRECT_REQUEST_PAYMENT_RECEIPT_KIND, DIRECT_REQUEST_PAYMENT_RECURRING_CHALLENGE_SCHEME, DIRECT_REQUEST_PAYMENT_REFERENCE_TYPE, DIRECT_REQUEST_PAYMENT_SDK_VERSION, DIRECT_REQUEST_PAYMENT_STANDARD_FINALITY, DIRECT_REQUEST_PAYMENT_STANDARD_SETTLED_STATUS, type DirectPaymentConfirmationClassification, type DirectPaymentConfirmationKind, type DirectPaymentConfirmationUnknownReason, type DirectPaymentMeteredBatchSettledClassification, type DirectPaymentMeteredUsageAcceptedClassification, type DirectPaymentRequirement, type DirectPaymentRequirementCreateInput, type DirectPaymentStandardSettledClassification, type DirectPaymentUnknownClassification, type DirectPaymentVerifyInput, type DirectRequestPaymentBalanceSufficiency, type DirectRequestPaymentBillingPlan, type DirectRequestPaymentBuyerMeteredQuery, type DirectRequestPaymentBuyerMeteredSummary, type DirectRequestPaymentBuyerUsageEvent, type DirectRequestPaymentChallenge, type DirectRequestPaymentChallengeInput, type DirectRequestPaymentCheckoutSetupInput, type DirectRequestPaymentCheckoutSetupResult, DirectRequestPaymentClient, type DirectRequestPaymentClientOptions, type DirectRequestPaymentCurrency, type DirectRequestPaymentListResponse, type DirectRequestPaymentMerchantAccount, type DirectRequestPaymentMerchantBillingMandateInput, DirectRequestPaymentMerchantClient, type DirectRequestPaymentMerchantResponse, type DirectRequestPaymentMerchantSetupInput, type DirectRequestPaymentMeteredListQuery, type DirectRequestPaymentMeteredOpenPeriod, type DirectRequestPaymentMeteredPlanType, type DirectRequestPaymentMinorAmount, type DirectRequestPaymentPastDueBlock, type DirectRequestPaymentProviderMeteredListQuery, type DirectRequestPaymentProviderMeteredQuery, type DirectRequestPaymentProviderMeteredSummary, type DirectRequestPaymentProviderMeteredTotals, type DirectRequestPaymentProviderUsageEvent, type DirectRequestPaymentRawWebhookBody, type DirectRequestPaymentRecurringCadence, type DirectRequestPaymentRecurringChallenge, type DirectRequestPaymentRecurringChallengeInput, type DirectRequestPaymentSettlementBatch, type DirectRequestPaymentSettlementTrigger, type DirectRequestPaymentToken, type DirectRequestPaymentWebhookEvent, type DirectRequestPaymentWebhookSignatureBody, type DirectRequestPaymentWebhookSubscription, type DirectRequestPaymentWebhookSubscriptionInput, HostedCheckoutNotAvailableError, type HostedCheckoutSession, type HostedCheckoutSessionCreateInput, type HostedCheckoutSessionCreateResult, type ParsedDirectRequestPaymentChallenge, SiglumeApiError, SiglumeDirectRequestPaymentError, type SiglumeEnvelopeMeta, SiglumeWebhookPayloadError, SiglumeWebhookSignatureError, type Web3PreparedTransactionExecutePayload, type Web3PreparedTransactionExecuteResult, type Web3TransactionRequest, type WebhookSignatureVerification, buildAllowanceExecutionPayload, buildPaymentExecutionPayload, buildPreparedTransactionExecutionPayload, buildWebhookSignatureHeader, classifyDirectPaymentConfirmation, computeWebhookSignature, createDirectRequestPaymentChallenge, createDirectRequestPaymentChallengeSignature, createDirectRequestPaymentRecurringChallenge, createDirectRequestPaymentRecurringChallengeSignature, createExternal402Challenge, createExternal402RecurringChallenge, directRequestPaymentChallengeHash, directRequestPaymentRequestHash, directRequestPaymentRequestHashV2, parseDirectRequestPaymentChallenge, parseDirectRequestPaymentWebhookEvent, verifyDirectRequestPaymentChallenge, verifyDirectRequestPaymentRecurringChallenge, verifyDirectRequestPaymentWebhook, verifyExternal402Challenge, verifyExternal402RecurringChallenge, verifyWebhookSignature };

package/dist/index.js

@@ -7,7 +7,7 @@ var DIRECT_REQUEST_PAYMENT_RECEIPT_KIND = "sdrp_direct_payment";
 var DIRECT_REQUEST_PAYMENT_ALLOWANCE_RECEIPT_KIND = "sdrp_direct_payment_allowance";
 var DIRECT_REQUEST_PAYMENT_REFERENCE_TYPE = "sdrp_direct_payment_requirement";
 var DEFAULT_WEBHOOK_TOLERANCE_SECONDS = 300;
-var DIRECT_REQUEST_PAYMENT_SDK_VERSION = "0.4.15";
+var DIRECT_REQUEST_PAYMENT_SDK_VERSION = "0.4.17";
 var DIRECT_REQUEST_PAYMENT_STANDARD_SETTLED_STATUS = "settled";
 var DIRECT_REQUEST_PAYMENT_METERED_ACCEPTED_STATUS = "pending_settlement";
 var DIRECT_REQUEST_PAYMENT_STANDARD_FINALITY = "per_payment_onchain";
@@ -50,7 +50,7 @@ var SiglumeWebhookPayloadError = class extends SiglumeDirectRequestPaymentError
   }
 };
 var DirectRequestPaymentClient = class {
-  auth_token;
+  #authToken;
   base_url;
   timeout_ms;
   user_agent;
@@ -66,8 +66,8 @@ var DirectRequestPaymentClient = class {
     if (!fetchImpl) {
       throw new SiglumeDirectRequestPaymentError("A fetch implementation is required in this runtime.");
     }
-    this.auth_token = authToken;
-    this.base_url = (options.base_url ?? envValue("SIGLUME_API_BASE") ?? DEFAULT_SIGLUME_API_BASE).replace(/\/+$/, "");
+    this.#authToken = authToken;
+    this.base_url = normalizeApiBaseUrl(options.base_url ?? envValue("SIGLUME_API_BASE") ?? DEFAULT_SIGLUME_API_BASE);
     this.timeout_ms = Math.max(1, Math.trunc(options.timeout_ms ?? 15e3));
     this.user_agent = options.user_agent ?? `@siglume/direct-request-payment/${DIRECT_REQUEST_PAYMENT_SDK_VERSION}`;
     this.fetch_impl = fetchImpl;
@@ -170,7 +170,7 @@ var DirectRequestPaymentClient = class {
     try {
       const headers = {
         "Accept": "application/json",
-        "Authorization": `Bearer ${this.auth_token}`,
+        "Authorization": `Bearer ${this.#authToken}`,
         "User-Agent": this.user_agent
       };
       let body;
@@ -202,7 +202,7 @@ var DirectRequestPaymentClient = class {
   }
 };
 var DirectRequestPaymentMerchantClient = class {
-  auth_token;
+  #authToken;
   base_url;
   timeout_ms;
   user_agent;
@@ -218,8 +218,8 @@ var DirectRequestPaymentMerchantClient = class {
     if (!fetchImpl) {
       throw new SiglumeDirectRequestPaymentError("A fetch implementation is required in this runtime.");
     }
-    this.auth_token = authToken;
-    this.base_url = (options.base_url ?? envValue("SIGLUME_API_BASE") ?? DEFAULT_SIGLUME_API_BASE).replace(/\/+$/, "");
+    this.#authToken = authToken;
+    this.base_url = normalizeApiBaseUrl(options.base_url ?? envValue("SIGLUME_API_BASE") ?? DEFAULT_SIGLUME_API_BASE);
     this.timeout_ms = Math.max(1, Math.trunc(options.timeout_ms ?? 15e3));
     this.user_agent = options.user_agent ?? `@siglume/direct-request-payment/${DIRECT_REQUEST_PAYMENT_SDK_VERSION}`;
     this.fetch_impl = fetchImpl;
@@ -237,7 +237,7 @@ var DirectRequestPaymentMerchantClient = class {
       payload.allowed_currencies = normalizeAllowedCurrencies(input.allowed_currencies);
     }
     if (input.webhook_callback_url !== void 0) {
-      payload.webhook_callback_url = requireNonEmpty(input.webhook_callback_url, "webhook_callback_url");
+      payload.webhook_callback_url = normalizeHttpsUrl(input.webhook_callback_url, "webhook_callback_url");
     }
     if (input.billing_mandate_cap_minor !== void 0) {
       payload.billing_mandate_cap_minor = positiveInteger(input.billing_mandate_cap_minor, "billing_mandate_cap_minor");
@@ -317,7 +317,7 @@ var DirectRequestPaymentMerchantClient = class {
   }
   async createWebhookSubscription(input) {
     const payload = {
-      callback_url: requireNonEmpty(input.callback_url, "callback_url"),
+      callback_url: normalizeHttpsUrl(input.callback_url, "callback_url"),
       event_types: input.event_types?.length ? input.event_types.map((eventType) => requireNonEmpty(eventType, "event_type")) : ["direct_payment.confirmed", "direct_payment.spent"]
     };
     if (input.description !== void 0) {
@@ -360,7 +360,7 @@ var DirectRequestPaymentMerchantClient = class {
     try {
       const headers = {
         "Accept": "application/json",
-        "Authorization": `Bearer ${this.auth_token}`,
+        "Authorization": `Bearer ${this.#authToken}`,
         "User-Agent": this.user_agent
       };
       let body;
@@ -598,11 +598,6 @@ function parseDirectRequestPaymentWebhookEvent(payload) {
     occurred_at: requireNonEmpty(stringOrNull(event.occurred_at) ?? "", "webhook occurred_at"),
     data: { ...data }
   };
-  if (parsed.type === "direct_payment.confirmed" && !DIRECT_REQUEST_PAYMENT_CONFIRMED_WEBHOOK_MODES.has(String(parsed.data.mode ?? ""))) {
-    throw new SiglumeWebhookPayloadError(
-      "direct_payment.confirmed webhook must carry a supported Direct Request Payment mode."
-    );
-  }
   return parsed;
 }
 function classifyDirectPaymentConfirmation(event) {
@@ -613,6 +608,7 @@ function classifyDirectPaymentConfirmation(event) {
   const settlementCadence = stringOrNull(data.settlement_cadence);
   const finality = stringOrNull(data.finality);
   const settlementStatus = stringOrNull(data.settlement_status);
+  const mode = stringOrNull(data.mode);
   if (event.type !== "direct_payment.confirmed") {
     return {
       kind: "unknown",
@@ -627,7 +623,21 @@ function classifyDirectPaymentConfirmation(event) {
       finality
     };
   }
-  if (data.mode === "metered_settlement_batch") {
+  if (!DIRECT_REQUEST_PAYMENT_CONFIRMED_WEBHOOK_MODES.has(mode ?? "")) {
+    return {
+      kind: "unknown",
+      event,
+      data,
+      reason: "unsupported_confirmation_mode",
+      requirement_id: requirementId,
+      settlement_batch_id: stringOrNull(data.settlement_batch_id),
+      pricing_band: pricingBand,
+      settlement_cadence: settlementCadence,
+      settlement_status: settlementStatus,
+      finality
+    };
+  }
+  if (mode === "metered_settlement_batch") {
     const settlementBatchId = stringOrNull(data.settlement_batch_id);
     const chainReceiptId = stringOrNull(data.chain_receipt_id);
     const usageEventDigest = stringOrNull(data.usage_event_digest);
@@ -799,6 +809,38 @@ function normalizeAllowedCurrencies(value) {
 function defaultTokenForCurrency(currency) {
   return currency === "JPY" ? "JPYC" : "USDC";
 }
+function normalizeApiBaseUrl(value) {
+  let url;
+  try {
+    url = new URL(requireNonEmpty(value, "base_url"));
+  } catch {
+    throw new SiglumeDirectRequestPaymentError("base_url must be an absolute URL such as https://siglume.com/v1.");
+  }
+  if (url.username || url.password) {
+    throw new SiglumeDirectRequestPaymentError("base_url must not include userinfo.");
+  }
+  if (!isAllowedCheckoutOriginScheme(url)) {
+    throw new SiglumeDirectRequestPaymentError(
+      "base_url must use https, except http is allowed for localhost, 127.0.0.1, or [::1]."
+    );
+  }
+  return url.toString().replace(/\/+$/, "");
+}
+function normalizeHttpsUrl(value, name) {
+  let url;
+  try {
+    url = new URL(requireNonEmpty(value, name));
+  } catch {
+    throw new SiglumeDirectRequestPaymentError(`${name} must be an absolute https URL.`);
+  }
+  if (url.username || url.password) {
+    throw new SiglumeDirectRequestPaymentError(`${name} must not include userinfo.`);
+  }
+  if (url.protocol !== "https:" || !url.hostname) {
+    throw new SiglumeDirectRequestPaymentError(`${name} must use https.`);
+  }
+  return url.toString();
+}
 function normalizeOriginList(value) {
   if (!Array.isArray(value)) {
     throw new SiglumeDirectRequestPaymentError("checkout_allowed_origins must be an array of origin URLs.");