@solvapay/server 1.0.7 → 1.0.8-preview.10

package/dist/edge.d.ts

@@ -2488,6 +2488,26 @@ interface ProcessPaymentResult {
     status: 'completed';
 }
 type ActivatePlanResult = components['schemas']['ActivatePlanResponseDto'];
+/**
+ * SDK-facing merchant identity (source: GET /v1/sdk/merchant).
+ *
+ * Hand-typed here until the OpenAPI generator picks up the new endpoint.
+ * Fields match `SdkMerchantResponseDto` on the backend.
+ */
+type SdkMerchantResponse = {
+    displayName: string;
+    legalName: string;
+    supportEmail?: string;
+    supportUrl?: string;
+    termsUrl?: string;
+    privacyUrl?: string;
+    country?: string;
+    defaultCurrency?: string;
+    statementDescriptor?: string;
+    logoUrl?: string;
+};
+/** SDK-facing product projection. Sourced from the existing OpenAPI spec. */
+type SdkProductResponse = components['schemas']['SdkProductResponse'];
 type McpBootstrapRequest = components['schemas']['McpBootstrapDto'];
 interface McpBootstrapResponse {
     product: components['schemas']['SdkProductResponse'];
@@ -2553,6 +2573,13 @@ interface SolvaPayClient {
         externalRef?: string;
         email?: string;
     }): Promise<CustomerResponseMapped>;
+    /**
+     * SDK-facing merchant identity (GET /v1/sdk/merchant).
+     * Returns the subset of provider fields safe for browser consumption —
+     * used by `<MandateText>`, `<CheckoutSummary>`, and trust signals.
+     */
+    getMerchant?(): Promise<SdkMerchantResponse>;
+    getProduct?(productRef: string): Promise<SdkProductResponse>;
     listProducts?(): Promise<Array<{
         reference: string;
         name: string;
@@ -3693,8 +3720,16 @@ declare function handleRouteError(error: unknown, operationName: string, default
  * and name from authenticated requests. Works with any framework that uses
  * the standard Web API Request (Express, Fastify, Next.js, Edge Functions, etc.).
  *
- * Uses dynamic imports to avoid requiring @solvapay/auth at build time,
- * making it suitable for edge runtime environments.
+ * Resolution order:
+ * 1. `x-user-id` header — set by Next.js-style middleware (unchanged).
+ * 2. `Authorization: Bearer <jwt>` — verified via HS256 when a secret is
+ *    configured (`SOLVAPAY_JWT_SECRET` or `SUPABASE_JWT_SECRET`), or
+ *    unverified-decoded when no secret is configured. The unverified path
+ *    covers platforms that verify JWTs at the gateway (e.g. Supabase Edge
+ *    with `verify_jwt = true`, which is the default) and asymmetric signing
+ *    keys (ES256/RS256) that the SDK does not have keys for.
+ * 3. Set `SOLVAPAY_AUTH_STRICT=true` to require cryptographic verification
+ *    inside the handler (the unverified-decode fallback is then disabled).
  *
  * @param request - Standard Web API Request object
  * @param options - Configuration options
@@ -3733,6 +3768,13 @@ declare function getAuthenticatedUserCore(request: Request, options?: {
  * Works with standard Web API Request (works everywhere).
  */
 
+type CustomerBalanceResult = {
+    customerRef: string;
+    credits: number;
+    displayCurrency: string;
+    creditsPerMinorUnit: number;
+    displayExchangeRate: number;
+};
 /**
  * Sync customer with SolvaPay backend (ensure customer exists).
  *
@@ -3775,6 +3817,18 @@ declare function syncCustomerCore(request: Request, options?: {
     includeEmail?: boolean;
     includeName?: boolean;
 }): Promise<string | ErrorResult>;
+/**
+ * Get credits for the authenticated customer.
+ *
+ * Authenticates the request, syncs the customer, then fetches credits.
+ *
+ * @param request - Standard Web API Request object
+ * @param options - Configuration options
+ * @returns Customer credits result or error result
+ */
+declare function getCustomerBalanceCore(request: Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<CustomerBalanceResult | ErrorResult>;
 
 /**
  * Create a payment intent for a customer to purchase a plan.
@@ -3969,6 +4023,31 @@ declare function cancelPurchaseCore(request: Request, body: {
 }, options?: {
     solvaPay?: SolvaPay;
 }): Promise<Record<string, unknown> | ErrorResult>;
+/**
+ * Reactivate purchase - core implementation
+ *
+ * Undoes a pending cancellation, restoring auto-renewal and clearing cancellation fields.
+ * Only works while the purchase is still active and the end date hasn't passed.
+ *
+ * @param request - Standard Web API Request
+ * @param body - Reactivation parameters
+ * @param options - Configuration options
+ * @returns Reactivated purchase response or error result
+ */
+declare function reactivatePurchaseCore(request: Request, body: {
+    purchaseRef: string;
+}, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<Record<string, unknown> | ErrorResult>;
+
+declare function activatePlanCore(request: Request, body: {
+    productRef: string;
+    planRef: string;
+}, options?: {
+    solvaPay?: SolvaPay;
+    includeEmail?: boolean;
+    includeName?: boolean;
+}): Promise<ActivatePlanResult | ErrorResult>;
 
 /**
  * Plans Helper (Core)
@@ -3980,13 +4059,85 @@ declare function cancelPurchaseCore(request: Request, body: {
 
 type Plan = components['schemas']['Plan'];
 /**
- * List plans - core implementation
+ * List plans - core implementation.
+ *
+ * Pass `options.solvaPay` to route through a pre-configured SolvaPay instance
+ * (e.g. stub-backed in examples). When omitted, the helper reads
+ * `SOLVAPAY_SECRET_KEY` from environment and constructs a real API client.
  */
-declare function listPlansCore(request: Request): Promise<{
+declare function listPlansCore(request: Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<{
     plans: Plan[];
     productRef: string;
 } | ErrorResult>;
 
+/**
+ * Merchant Helper (Core)
+ *
+ * Generic helper for GET /api/merchant — returns the SDK-facing merchant
+ * identity used by `<MandateText>`, `<CheckoutSummary>`, and trust signals.
+ * Works with standard Web API Request (Express, Fastify, Next.js, Edge).
+ */
+
+declare function getMerchantCore(_request: Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<SdkMerchantResponse | ErrorResult>;
+
+/**
+ * Product Helper (Core)
+ *
+ * Generic helper for GET /api/get-product?productRef=...
+ * Returns a single product by reference, used by the `useProduct` React hook.
+ */
+
+declare function getProductCore(request: Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<SdkProductResponse | ErrorResult>;
+
+interface PurchaseCheckResult {
+    customerRef: string;
+    email?: string;
+    name?: string;
+    purchases: Array<{
+        reference: string;
+        productName?: string;
+        productRef?: string;
+        status?: string;
+        startDate?: string;
+        planSnapshot?: {
+            meterId?: string;
+            limit?: number;
+            freeUnits?: number;
+        };
+        usage?: {
+            used?: number;
+            overageUnits?: number;
+            overageCost?: number;
+            periodStart?: string;
+            periodEnd?: string;
+        };
+        [key: string]: unknown;
+    }>;
+}
+declare function checkPurchaseCore(request: Request, options?: {
+    solvaPay?: SolvaPay;
+    includeEmail?: boolean;
+    includeName?: boolean;
+}): Promise<PurchaseCheckResult | ErrorResult>;
+
+declare function trackUsageCore(request: Request, body: {
+    actionType?: 'transaction' | 'api_call' | 'hour' | 'email' | 'storage' | 'custom';
+    units?: number;
+    productRef?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<{
+    success: true;
+} | ErrorResult>;
+
 /**
  * SolvaPay Server SDK - Edge Runtime Entry Point
  *
@@ -4000,4 +4151,4 @@ declare function verifyWebhook({ body, signature, secret, }: {
     secret: string;
 }): Promise<WebhookEvent>;
 
-export { type AuthenticatedUser, type CreateSolvaPayConfig, type CustomerWebhookObject, type ErrorResult, type HttpAdapterOptions, type LimitActivationBalance, type LimitActivationProduct, type LimitPlanSummary, type McpAdapterOptions, type NextAdapterOptions, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type RetryOptions, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, cancelPurchaseCore, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createTopupPaymentIntentCore, getAuthenticatedUserCore, handleRouteError, isErrorResult, listPlansCore, paywallErrorToClientPayload, processPaymentIntentCore, syncCustomerCore, verifyWebhook, withRetry };
+export { type AuthenticatedUser, type CreateSolvaPayConfig, type CustomerBalanceResult, type CustomerWebhookObject, type ErrorResult, type HttpAdapterOptions, type LimitActivationBalance, type LimitActivationProduct, type LimitPlanSummary, type McpAdapterOptions, type NextAdapterOptions, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type PurchaseCheckResult, type RetryOptions, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, activatePlanCore, cancelPurchaseCore, checkPurchaseCore, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createTopupPaymentIntentCore, getAuthenticatedUserCore, getCustomerBalanceCore, getMerchantCore, getProductCore, handleRouteError, isErrorResult, listPlansCore, paywallErrorToClientPayload, processPaymentIntentCore, reactivatePurchaseCore, syncCustomerCore, trackUsageCore, verifyWebhook, withRetry };