@siglume/direct-request-payment 0.4.3 → 0.4.5

package/dist/index.d.ts

@@ -6,8 +6,128 @@ 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.5";
 type DirectRequestPaymentCurrency = "JPY" | "USD";
 type DirectRequestPaymentToken = "JPYC" | "USDC";
+type DirectRequestPaymentMeteredPlanType = "micro" | "nano";
+type DirectRequestPaymentMinorAmount = string;
+interface DirectRequestPaymentBuyerMeteredQuery {
+    plan_type?: DirectRequestPaymentMeteredPlanType | string;
+    token_symbol?: DirectRequestPaymentToken | string;
+}
+interface DirectRequestPaymentMeteredListQuery extends DirectRequestPaymentBuyerMeteredQuery {
+    status?: string;
+    cursor?: string;
+    limit?: number;
+}
+interface DirectRequestPaymentProviderMeteredQuery extends DirectRequestPaymentBuyerMeteredQuery {
+    listing_id?: string;
+    capability_key?: string;
+}
+interface DirectRequestPaymentProviderMeteredListQuery extends DirectRequestPaymentProviderMeteredQuery {
+    status?: string;
+    cursor?: string;
+    limit?: number;
+}
+interface DirectRequestPaymentListResponse<T> {
+    items: T[];
+    next_cursor?: string | null;
+    [key: string]: unknown;
+}
+interface DirectRequestPaymentBuyerUsageEvent {
+    metered_usage_id: string;
+    created_at?: string | null;
+    plan_type: string;
+    settlement_cadence: string;
+    product_listing_id?: string | null;
+    listing_id?: string | null;
+    capability_key?: string | null;
+    operation_key?: string | null;
+    currency: string;
+    token_symbol: string;
+    provider_usage_amount_minor: DirectRequestPaymentMinorAmount;
+    protocol_fee_minor: DirectRequestPaymentMinorAmount;
+    gross_buyer_debit_minor: DirectRequestPaymentMinorAmount;
+    status: string;
+    period_start?: string | null;
+    period_end?: string | null;
+    settlement_batch_id?: string | null;
+    expected_scheduled_debit_at?: string | null;
+    [key: string]: unknown;
+}
+interface DirectRequestPaymentProviderUsageEvent {
+    metered_usage_id: string;
+    created_at?: string | null;
+    plan_type: string;
+    settlement_cadence: string;
+    product_listing_id?: string | null;
+    listing_id?: string | null;
+    capability_key?: string | null;
+    operation_key?: string | null;
+    currency: string;
+    token_symbol: string;
+    provider_receivable_minor: DirectRequestPaymentMinorAmount;
+    protocol_fee_minor: DirectRequestPaymentMinorAmount;
+    gross_buyer_debit_minor: DirectRequestPaymentMinorAmount;
+    status: string;
+    period_start?: string | null;
+    period_end?: string | null;
+    expected_scheduled_debit_at?: string | null;
+    settlement_batch_id?: string | null;
+    buyer_period_ref?: string | null;
+    [key: string]: unknown;
+}
+interface DirectRequestPaymentSettlementBatch {
+    settlement_batch_id: string;
+    plan_type: string;
+    settlement_cadence: string;
+    status: string;
+    notice_status?: string | null;
+    period_start?: string | null;
+    period_end?: string | null;
+    close_at?: string | null;
+    expected_scheduled_debit_at?: string | null;
+    scheduled_debit_at?: string | null;
+    not_before_attempt_at?: string | null;
+    execution_status?: string | null;
+    latest_execution_attempt_status?: string | null;
+    attempt_count?: number | null;
+    next_attempt_at?: string | null;
+    chain_receipt_id?: string | null;
+    usage_event_digest?: string | null;
+    protocol_fee_minor?: DirectRequestPaymentMinorAmount;
+    gross_buyer_debit_minor?: DirectRequestPaymentMinorAmount;
+    rounding_delta_minor?: DirectRequestPaymentMinorAmount;
+    buyer_debit_minor?: DirectRequestPaymentMinorAmount;
+    provider_usage_amount_minor?: DirectRequestPaymentMinorAmount;
+    provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    settled_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    unsettled_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    past_due_provider_receivable_minor?: DirectRequestPaymentMinorAmount;
+    buyer_period_ref?: string | null;
+    failure_reason_code?: string | null;
+    failure_reason_label?: string | null;
+    failure_reason_help?: string | null;
+    support_reference?: string | null;
+    [key: string]: unknown;
+}
+interface DirectRequestPaymentBuyerMeteredSummary {
+    role: "buyer";
+    open_periods: Array<Record<string, unknown>>;
+    settlement_batches: DirectRequestPaymentSettlementBatch[];
+    past_due_blocks: Array<Record<string, unknown>>;
+    balance_sufficiency?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface DirectRequestPaymentProviderMeteredSummary {
+    role: "provider";
+    timezone?: string | null;
+    filters?: Record<string, unknown>;
+    open_periods: Array<Record<string, unknown>>;
+    periods: DirectRequestPaymentSettlementBatch[];
+    totals: Record<string, DirectRequestPaymentMinorAmount>;
+    [key: string]: unknown;
+}
 interface DirectRequestPaymentChallengeInput {
     merchant: string;
     amount_minor: number;
@@ -78,11 +198,17 @@ interface DirectPaymentRequirement {
     capability_key: string;
     requirement_hash: string;
     request_hash: string;
+    request_hash_v2?: string | null;
     siglume_signature: string;
     token_symbol: string;
     currency: string;
     amount_minor: number;
     fee_bps: number;
+    pricing_band?: "standard" | DirectRequestPaymentMeteredPlanType | string | null;
+    settlement_cadence?: "per_payment" | "weekly" | "monthly" | string | null;
+    finality?: string | null;
+    protocol_fee_minor?: DirectRequestPaymentMinorAmount | null;
+    settlement_status?: string | null;
     status: string;
     expires_at?: string | null;
     confirmed_at?: string | null;
@@ -265,6 +391,12 @@ interface DirectRequestPaymentWebhookEvent {
         currency?: string;
         token_symbol?: string;
         status?: string;
+        request_hash_v2?: string | null;
+        pricing_band?: "standard" | DirectRequestPaymentMeteredPlanType | string | null;
+        settlement_cadence?: "per_payment" | "weekly" | "monthly" | string | null;
+        finality?: string | null;
+        protocol_fee_minor?: DirectRequestPaymentMinorAmount | null;
+        settlement_status?: string | null;
         [key: string]: unknown;
     };
     [key: string]: unknown;
@@ -310,6 +442,13 @@ declare class DirectRequestPaymentClient {
         await_finality?: boolean;
         metadata?: Record<string, unknown>;
     }): Promise<Web3PreparedTransactionExecuteResult>;
+    getBuyerMeteredSummary(input?: DirectRequestPaymentBuyerMeteredQuery): Promise<DirectRequestPaymentBuyerMeteredSummary>;
+    listBuyerUsageEvents(input?: DirectRequestPaymentMeteredListQuery): Promise<DirectRequestPaymentListResponse<DirectRequestPaymentBuyerUsageEvent>>;
+    listBuyerSettlementBatches(input?: DirectRequestPaymentMeteredListQuery): Promise<DirectRequestPaymentListResponse<DirectRequestPaymentSettlementBatch>>;
+    getProviderMeteredSummary(input?: DirectRequestPaymentProviderMeteredQuery): Promise<DirectRequestPaymentProviderMeteredSummary>;
+    listProviderUsageEvents(input?: DirectRequestPaymentProviderMeteredListQuery): Promise<DirectRequestPaymentListResponse<DirectRequestPaymentProviderUsageEvent>>;
+    listProviderSettlementBatches(input?: DirectRequestPaymentProviderMeteredListQuery): Promise<DirectRequestPaymentListResponse<DirectRequestPaymentSettlementBatch>>;
+    getProviderSettlementBatch(settlement_batch_id: string, input?: Pick<DirectRequestPaymentProviderMeteredQuery, "listing_id" | "capability_key">): Promise<DirectRequestPaymentSettlementBatch>;
     request<T>(method: string, path: string, json_body?: unknown): Promise<T>;
 }
 declare class DirectRequestPaymentMerchantClient {
@@ -383,6 +522,12 @@ declare function directRequestPaymentRequestHash(input: {
     currency: DirectRequestPaymentCurrency | string;
     challenge: string;
 }): Promise<string>;
+declare function directRequestPaymentRequestHashV2(input: {
+    merchant: string;
+    amount_minor: number;
+    currency: DirectRequestPaymentCurrency | string;
+    challenge: string;
+}): Promise<string>;
 declare function buildPaymentExecutionPayload(requirement: DirectPaymentRequirement, options?: {
     await_finality?: boolean;
     metadata?: Record<string, unknown>;
@@ -419,4 +564,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_MODE, DIRECT_REQUEST_PAYMENT_RECEIPT_KIND, DIRECT_REQUEST_PAYMENT_RECURRING_CHALLENGE_SCHEME, DIRECT_REQUEST_PAYMENT_REFERENCE_TYPE, type DirectPaymentRequirement, type DirectPaymentRequirementCreateInput, type DirectPaymentVerifyInput, type DirectRequestPaymentBillingPlan, type DirectRequestPaymentChallenge, type DirectRequestPaymentChallengeInput, type DirectRequestPaymentCheckoutSetupInput, type DirectRequestPaymentCheckoutSetupResult, DirectRequestPaymentClient, type DirectRequestPaymentClientOptions, type DirectRequestPaymentCurrency, type DirectRequestPaymentMerchantAccount, type DirectRequestPaymentMerchantBillingMandateInput, DirectRequestPaymentMerchantClient, type DirectRequestPaymentMerchantResponse, type DirectRequestPaymentMerchantSetupInput, type DirectRequestPaymentRecurringCadence, type DirectRequestPaymentRecurringChallenge, type DirectRequestPaymentRecurringChallengeInput, type DirectRequestPaymentToken, type DirectRequestPaymentWebhookEvent, 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, computeWebhookSignature, createDirectRequestPaymentChallenge, createDirectRequestPaymentChallengeSignature, createDirectRequestPaymentRecurringChallenge, createDirectRequestPaymentRecurringChallengeSignature, createExternal402Challenge, createExternal402RecurringChallenge, directRequestPaymentChallengeHash, directRequestPaymentRequestHash, 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_MODE, DIRECT_REQUEST_PAYMENT_RECEIPT_KIND, DIRECT_REQUEST_PAYMENT_RECURRING_CHALLENGE_SCHEME, DIRECT_REQUEST_PAYMENT_REFERENCE_TYPE, DIRECT_REQUEST_PAYMENT_SDK_VERSION, type DirectPaymentRequirement, type DirectPaymentRequirementCreateInput, 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 DirectRequestPaymentRecurringCadence, type DirectRequestPaymentRecurringChallenge, type DirectRequestPaymentRecurringChallengeInput, type DirectRequestPaymentSettlementBatch, type DirectRequestPaymentToken, type DirectRequestPaymentWebhookEvent, 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, computeWebhookSignature, createDirectRequestPaymentChallenge, createDirectRequestPaymentChallengeSignature, createDirectRequestPaymentRecurringChallenge, createDirectRequestPaymentRecurringChallengeSignature, createExternal402Challenge, createExternal402RecurringChallenge, directRequestPaymentChallengeHash, directRequestPaymentRequestHash, directRequestPaymentRequestHashV2, parseDirectRequestPaymentChallenge, parseDirectRequestPaymentWebhookEvent, verifyDirectRequestPaymentChallenge, verifyDirectRequestPaymentRecurringChallenge, verifyDirectRequestPaymentWebhook, verifyExternal402Challenge, verifyExternal402RecurringChallenge, verifyWebhookSignature };

package/dist/index.js

@@ -7,6 +7,8 @@ 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.5";
+var DIRECT_REQUEST_PAYMENT_CONFIRMED_WEBHOOK_MODES = /* @__PURE__ */ new Set([DIRECT_REQUEST_PAYMENT_MODE, "metered_settlement_batch"]);
 var SiglumeDirectRequestPaymentError = class extends Error {
   constructor(message) {
     super(message);
@@ -53,7 +55,7 @@ var DirectRequestPaymentClient = class {
     const authToken = options.auth_token ?? envValue("SIGLUME_AUTH_TOKEN");
     if (!authToken) {
       throw new SiglumeDirectRequestPaymentError(
-        "A buyer Siglume bearer token is required for Direct Request Payment API calls. Developer Portal API keys are not accepted."
+        "A buyer or provider Siglume user bearer token is required for Direct Request Payment API calls. Developer Portal API keys are not accepted."
       );
     }
     const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -63,7 +65,7 @@ var DirectRequestPaymentClient = class {
     this.auth_token = authToken;
     this.base_url = (options.base_url ?? envValue("SIGLUME_API_BASE") ?? DEFAULT_SIGLUME_API_BASE).replace(/\/+$/, "");
     this.timeout_ms = Math.max(1, Math.trunc(options.timeout_ms ?? 15e3));
-    this.user_agent = options.user_agent ?? "@siglume/direct-request-payment/0.4.3";
+    this.user_agent = options.user_agent ?? `@siglume/direct-request-payment/${DIRECT_REQUEST_PAYMENT_SDK_VERSION}`;
     this.fetch_impl = fetchImpl;
   }
   async createPaymentRequirement(input) {
@@ -111,6 +113,53 @@ var DirectRequestPaymentClient = class {
   async executeAllowanceTransaction(requirement, options = {}) {
     return this.executePreparedTransaction(buildAllowanceExecutionPayload(requirement, options));
   }
+  async getBuyerMeteredSummary(input = {}) {
+    return this.request(
+      "GET",
+      meteredQueryPath("/sdrp/metered/my-summary", input)
+    );
+  }
+  async listBuyerUsageEvents(input = {}) {
+    return this.request(
+      "GET",
+      meteredQueryPath("/sdrp/metered/my-usage-events", input)
+    );
+  }
+  async listBuyerSettlementBatches(input = {}) {
+    return this.request(
+      "GET",
+      meteredQueryPath("/sdrp/metered/my-settlement-batches", input)
+    );
+  }
+  async getProviderMeteredSummary(input = {}) {
+    return this.request(
+      "GET",
+      meteredQueryPath("/sdrp/metered/provider/summary", input)
+    );
+  }
+  async listProviderUsageEvents(input = {}) {
+    return this.request(
+      "GET",
+      meteredQueryPath("/sdrp/metered/provider/usage-events", input)
+    );
+  }
+  async listProviderSettlementBatches(input = {}) {
+    return this.request(
+      "GET",
+      meteredQueryPath("/sdrp/metered/provider/settlement-batches", input)
+    );
+  }
+  async getProviderSettlementBatch(settlement_batch_id, input = {}) {
+    return this.request(
+      "GET",
+      meteredQueryPath(
+        `/sdrp/metered/provider/settlement-batches/${encodeURIComponent(
+          requireNonEmpty(settlement_batch_id, "settlement_batch_id")
+        )}`,
+        input
+      )
+    );
+  }
   async request(method, path, json_body) {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), this.timeout_ms);
@@ -168,7 +217,7 @@ var DirectRequestPaymentMerchantClient = class {
     this.auth_token = authToken;
     this.base_url = (options.base_url ?? envValue("SIGLUME_API_BASE") ?? DEFAULT_SIGLUME_API_BASE).replace(/\/+$/, "");
     this.timeout_ms = Math.max(1, Math.trunc(options.timeout_ms ?? 15e3));
-    this.user_agent = options.user_agent ?? "@siglume/direct-request-payment/0.4.3";
+    this.user_agent = options.user_agent ?? `@siglume/direct-request-payment/${DIRECT_REQUEST_PAYMENT_SDK_VERSION}`;
     this.fetch_impl = fetchImpl;
   }
   async setupMerchant(input) {
@@ -461,6 +510,16 @@ async function directRequestPaymentRequestHash(input) {
   const material = `${normalizeMerchant(input.merchant)}${positiveInteger(input.amount_minor, "amount_minor")}${normalizeCurrency(input.currency)}${requireNonEmpty(input.challenge, "challenge")}`;
   return sha256Prefixed(material);
 }
+async function directRequestPaymentRequestHashV2(input) {
+  const material = JSON.stringify({
+    amount_minor: positiveInteger(input.amount_minor, "amount_minor"),
+    challenge: requireNonEmpty(input.challenge, "challenge"),
+    currency: normalizeCurrency(input.currency),
+    merchant: normalizeMerchant(input.merchant),
+    version: 2
+  });
+  return sha256Prefixed(material);
+}
 function buildPaymentExecutionPayload(requirement, options = {}) {
   return buildPreparedTransactionExecutionPayload(requirement, requirement.transaction_request, {
     receipt_kind: DIRECT_REQUEST_PAYMENT_RECEIPT_KIND,
@@ -534,8 +593,10 @@ function parseDirectRequestPaymentWebhookEvent(payload) {
     occurred_at: requireNonEmpty(stringOrNull(event.occurred_at) ?? "", "webhook occurred_at"),
     data: { ...data }
   };
-  if (parsed.type === "direct_payment.confirmed" && parsed.data.mode !== DIRECT_REQUEST_PAYMENT_MODE) {
-    throw new SiglumeWebhookPayloadError("direct_payment.confirmed webhook must carry data.mode='external_402'.");
+  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;
 }
@@ -589,6 +650,13 @@ function normalizeToken(value) {
   }
   return token;
 }
+function normalizeMeteredPlanType(value) {
+  const planType = requireNonEmpty(value, "plan_type").toLowerCase();
+  if (planType === "micro" || planType === "nano") {
+    return planType;
+  }
+  throw new SiglumeDirectRequestPaymentError("plan_type must be micro or nano.");
+}
 function normalizeAllowedCurrencies(value) {
   const normalized = {};
   if (Array.isArray(value)) {
@@ -626,7 +694,15 @@ function normalizeOriginList(value) {
         "each checkout_allowed_origins entry must be an absolute origin such as https://shop.example.com."
       );
     }
-    const origin = `${url.protocol.toLowerCase()}//${url.host.toLowerCase()}`;
+    if (url.username || url.password) {
+      throw new SiglumeDirectRequestPaymentError("checkout_allowed_origins entries must not include userinfo.");
+    }
+    if (!isAllowedCheckoutOriginScheme(url)) {
+      throw new SiglumeDirectRequestPaymentError(
+        "checkout_allowed_origins entries must use https, except http is allowed for localhost, 127.0.0.1, or [::1]."
+      );
+    }
+    const origin = url.origin.toLowerCase();
     if (!seen.has(origin)) {
       seen.add(origin);
       origins.push(origin);
@@ -634,8 +710,47 @@ function normalizeOriginList(value) {
   }
   return origins;
 }
+function isAllowedCheckoutOriginScheme(url) {
+  if (url.protocol === "https:") {
+    return Boolean(url.hostname);
+  }
+  if (url.protocol !== "http:") {
+    return false;
+  }
+  const hostname = url.hostname.toLowerCase();
+  return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]" || hostname === "::1";
+}
+function meteredQueryPath(path, input) {
+  const params = new URLSearchParams();
+  if (input.plan_type !== void 0) {
+    params.set("plan_type", normalizeMeteredPlanType(input.plan_type));
+  }
+  if (input.token_symbol !== void 0) {
+    params.set("token_symbol", normalizeToken(input.token_symbol));
+  }
+  if ("status" in input && input.status !== void 0) {
+    params.set("status", requireNonEmpty(input.status, "status"));
+  }
+  if ("listing_id" in input && input.listing_id !== void 0) {
+    params.set("listing_id", requireNonEmpty(input.listing_id, "listing_id"));
+  }
+  if ("capability_key" in input && input.capability_key !== void 0) {
+    params.set("capability_key", requireNonEmpty(input.capability_key, "capability_key"));
+  }
+  if ("limit" in input && input.limit !== void 0) {
+    params.set("limit", String(positiveInteger(input.limit, "limit")));
+  }
+  if ("cursor" in input && input.cursor !== void 0) {
+    params.set("cursor", requireNonEmpty(input.cursor, "cursor"));
+  }
+  const query = params.toString();
+  return query ? `${path}?${query}` : path;
+}
 function positiveInteger(value, name) {
-  const parsed = Number(value);
+  if (typeof value !== "number") {
+    throw new SiglumeDirectRequestPaymentError(`${name} must be a positive safe integer.`);
+  }
+  const parsed = value;
   if (!Number.isSafeInteger(parsed) || parsed <= 0) {
     throw new SiglumeDirectRequestPaymentError(`${name} must be a positive safe integer.`);
   }
@@ -837,6 +952,7 @@ export {
   DIRECT_REQUEST_PAYMENT_RECEIPT_KIND,
   DIRECT_REQUEST_PAYMENT_RECURRING_CHALLENGE_SCHEME,
   DIRECT_REQUEST_PAYMENT_REFERENCE_TYPE,
+  DIRECT_REQUEST_PAYMENT_SDK_VERSION,
   DirectRequestPaymentClient,
   DirectRequestPaymentMerchantClient,
   HostedCheckoutNotAvailableError,
@@ -857,6 +973,7 @@ export {
   createExternal402RecurringChallenge,
   directRequestPaymentChallengeHash,
   directRequestPaymentRequestHash,
+  directRequestPaymentRequestHashV2,
   parseDirectRequestPaymentChallenge,
   parseDirectRequestPaymentWebhookEvent,
   verifyDirectRequestPaymentChallenge,