@solvapay/next 1.0.6 → 1.0.8-preview.1

package/dist/index.cjs

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  activatePlan: () => activatePlan,
   cancelRenewal: () => cancelRenewal,
   checkPurchase: () => checkPurchase,
   clearAllPurchaseCache: () => clearAllPurchaseCache,
@@ -39,16 +40,21 @@ __export(index_exports, {
   createCustomerSession: () => createCustomerSession,
   createPaymentIntent: () => createPaymentIntent,
   createSupabaseAuthMiddleware: () => createSupabaseAuthMiddleware,
+  createTopupPaymentIntent: () => createTopupPaymentIntent,
   getAuthenticatedUser: () => getAuthenticatedUser,
+  getCustomerBalance: () => getCustomerBalance,
+  getMerchant: () => getMerchant,
+  getProduct: () => getProduct,
   getPurchaseCacheStats: () => getPurchaseCacheStats,
   listPlans: () => listPlans,
   processPaymentIntent: () => processPaymentIntent,
-  syncCustomer: () => syncCustomer
+  reactivateRenewal: () => reactivateRenewal,
+  syncCustomer: () => syncCustomer,
+  trackUsage: () => trackUsage
 });
 module.exports = __toCommonJS(index_exports);
-var import_server16 = require("next/server");
-var import_server17 = require("@solvapay/server");
-var import_core = require("@solvapay/core");
+var import_server24 = require("next/server");
+var import_server25 = require("@solvapay/server");
 
 // src/cache.ts
 function createRequestDeduplicator(options = {}) {
@@ -207,6 +213,16 @@ async function syncCustomer(request, options = {}) {
   }
   return result;
 }
+async function getCustomerBalance(request, options = {}) {
+  const result = await (0, import_server4.getCustomerBalanceCore)(request, options);
+  if ((0, import_server4.isErrorResult)(result)) {
+    return import_server3.NextResponse.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  return result;
+}
 
 // src/helpers/payment.ts
 var import_server5 = require("next/server");
@@ -229,6 +245,23 @@ async function createPaymentIntent(request, body, options = {}) {
   }
   return result;
 }
+async function createTopupPaymentIntent(request, body, options = {}) {
+  const result = await (0, import_server6.createTopupPaymentIntentCore)(request, body, options);
+  if ((0, import_server6.isErrorResult)(result)) {
+    return import_server5.NextResponse.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  try {
+    const userResult = await (0, import_server7.getAuthenticatedUserCore)(request);
+    if (!(0, import_server6.isErrorResult)(userResult)) {
+      clearPurchaseCache(userResult.userId);
+    }
+  } catch {
+  }
+  return result;
+}
 async function processPaymentIntent(request, body, options = {}) {
   const result = await (0, import_server6.processPaymentIntentCore)(request, body, options);
   if ((0, import_server6.isErrorResult)(result)) {
@@ -271,12 +304,12 @@ async function createCustomerSession(request, options = {}) {
   return result;
 }
 
-// src/helpers/renewal.ts
+// src/helpers/activation.ts
 var import_server10 = require("next/server");
 var import_server11 = require("@solvapay/server");
 var import_server12 = require("@solvapay/server");
-async function cancelRenewal(request, body, options = {}) {
-  const result = await (0, import_server11.cancelPurchaseCore)(request, body, options);
+async function activatePlan(request, body, options = {}) {
+  const result = await (0, import_server11.activatePlanCore)(request, body, options);
   if ((0, import_server11.isErrorResult)(result)) {
     return import_server10.NextResponse.json(
       { error: result.error, details: result.details },
@@ -293,29 +326,109 @@ async function cancelRenewal(request, body, options = {}) {
   return result;
 }
 
-// src/helpers/plans.ts
+// src/helpers/renewal.ts
 var import_server13 = require("next/server");
 var import_server14 = require("@solvapay/server");
-async function listPlans(request) {
-  const result = await (0, import_server14.listPlansCore)(request);
+async function cancelRenewal(request, body, options = {}) {
+  const result = await (0, import_server14.cancelPurchaseCore)(request, body, options);
   if ((0, import_server14.isErrorResult)(result)) {
     return import_server13.NextResponse.json(
       { error: result.error, details: result.details },
       { status: result.status }
     );
   }
+  try {
+    const userResult = await (0, import_server14.getAuthenticatedUserCore)(request);
+    if (!(0, import_server14.isErrorResult)(userResult)) {
+      clearPurchaseCache(userResult.userId);
+    }
+  } catch {
+  }
+  return result;
+}
+async function reactivateRenewal(request, body, options = {}) {
+  const result = await (0, import_server14.reactivatePurchaseCore)(request, body, options);
+  if ((0, import_server14.isErrorResult)(result)) {
+    return import_server13.NextResponse.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  try {
+    const userResult = await (0, import_server14.getAuthenticatedUserCore)(request);
+    if (!(0, import_server14.isErrorResult)(userResult)) {
+      clearPurchaseCache(userResult.userId);
+    }
+  } catch {
+  }
   return result;
 }
 
-// src/helpers/middleware.ts
+// src/helpers/plans.ts
 var import_server15 = require("next/server");
+var import_server16 = require("@solvapay/server");
+async function listPlans(request, options = {}) {
+  const result = await (0, import_server16.listPlansCore)(request, options);
+  if ((0, import_server16.isErrorResult)(result)) {
+    return import_server15.NextResponse.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  return result;
+}
+
+// src/helpers/merchant.ts
+var import_server17 = require("next/server");
+var import_server18 = require("@solvapay/server");
+async function getMerchant(request, options = {}) {
+  const result = await (0, import_server18.getMerchantCore)(request, options);
+  if ((0, import_server18.isErrorResult)(result)) {
+    return import_server17.NextResponse.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  return result;
+}
+
+// src/helpers/product.ts
+var import_server19 = require("next/server");
+var import_server20 = require("@solvapay/server");
+async function getProduct(request, options = {}) {
+  const result = await (0, import_server20.getProductCore)(request, options);
+  if ((0, import_server20.isErrorResult)(result)) {
+    return import_server19.NextResponse.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  return result;
+}
+
+// src/helpers/usage.ts
+var import_server21 = require("next/server");
+var import_server22 = require("@solvapay/server");
+async function trackUsage(request, body, options = {}) {
+  const result = await (0, import_server22.trackUsageCore)(request, body, options);
+  if ((0, import_server22.isErrorResult)(result)) {
+    return import_server21.NextResponse.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  return import_server21.NextResponse.json(result);
+}
+
+// src/helpers/middleware.ts
+var import_server23 = require("next/server");
 function createAuthMiddleware(options) {
   const { adapter, publicRoutes = [], userIdHeader = "x-user-id" } = options;
   return async function middleware(request) {
     const req = request;
     const { pathname } = req.nextUrl;
     if (!pathname.startsWith("/api")) {
-      return import_server15.NextResponse.next();
+      return import_server23.NextResponse.next();
     }
     const isPublicRoute = publicRoutes.some((route) => pathname.startsWith(route));
     const userId = await adapter.getUserIdFromRequest(req);
@@ -324,21 +437,21 @@ function createAuthMiddleware(options) {
       if (userId) {
         requestHeaders2.set(userIdHeader, userId);
       }
-      return import_server15.NextResponse.next({
+      return import_server23.NextResponse.next({
         request: {
           headers: requestHeaders2
         }
       });
     }
     if (!userId) {
-      return import_server15.NextResponse.json(
+      return import_server23.NextResponse.json(
         { error: "Unauthorized", details: "Valid authentication required" },
         { status: 401 }
       );
     }
     const requestHeaders = new Headers(req.headers);
     requestHeaders.set(userIdHeader, userId);
-    return import_server15.NextResponse.next({
+    return import_server23.NextResponse.next({
       request: {
         headers: requestHeaders
       }
@@ -379,72 +492,37 @@ function createSupabaseAuthMiddleware(options = {}) {
 
 // src/index.ts
 async function checkPurchase(request, options = {}) {
+  const deduplicator = getSharedDeduplicator(options.deduplication);
   try {
-    const { requireUserId, getUserEmailFromRequest, getUserNameFromRequest } = await import("@solvapay/auth");
+    const { requireUserId } = await import("@solvapay/auth");
     const userIdOrError = requireUserId(request);
     if (userIdOrError instanceof Response) {
       const clonedResponse = userIdOrError.clone();
       const body = await clonedResponse.json().catch(() => ({ error: "Unauthorized" }));
-      return import_server16.NextResponse.json(body, { status: userIdOrError.status });
+      return import_server24.NextResponse.json(body, { status: userIdOrError.status });
     }
     const userId = userIdOrError;
-    const email = options.includeEmail !== false ? await getUserEmailFromRequest(request) : null;
-    const name = options.includeName !== false ? await getUserNameFromRequest(request) : null;
-    const cachedCustomerRef = request.headers.get("x-solvapay-customer-ref");
-    const solvaPay = options.solvaPay || (0, import_server17.createSolvaPay)();
-    if (cachedCustomerRef) {
-      try {
-        const customer = await solvaPay.getCustomer({ customerRef: cachedCustomerRef });
-        if (customer && customer.customerRef) {
-          if (customer.externalRef && customer.externalRef === userId) {
-            const filteredPurchases = (customer.purchases || []).filter(
-              (p) => p.status === "active"
-            );
-            return {
-              customerRef: customer.customerRef,
-              email: customer.email,
-              name: customer.name,
-              purchases: filteredPurchases
-            };
-          }
-        }
-      } catch {
-      }
-    }
-    const deduplicator = getSharedDeduplicator(options.deduplication);
-    const response = await deduplicator.deduplicate(userId, async () => {
-      try {
-        const ensuredCustomerRef = await solvaPay.ensureCustomer(userId, userId, {
-          email: email || void 0,
-          name: name || void 0
+    const response = await deduplicator.deduplicate(
+      userId,
+      async () => {
+        return await (0, import_server25.checkPurchaseCore)(request, {
+          solvaPay: options.solvaPay,
+          includeEmail: options.includeEmail,
+          includeName: options.includeName
         });
-        const customer = await solvaPay.getCustomer({ customerRef: ensuredCustomerRef });
-        const filteredPurchases = (customer.purchases || []).filter(
-          (p) => p.status === "active"
-        );
-        const result = {
-          customerRef: customer.customerRef || userId,
-          email: customer.email,
-          name: customer.name,
-          purchases: filteredPurchases
-        };
-        return result;
-      } catch (error) {
-        console.error("[checkPurchase] Error fetching customer:", error);
-        return {
-          customerRef: userId,
-          purchases: []
-        };
       }
-    });
+    );
+    if ((0, import_server25.isErrorResult)(response)) {
+      return import_server24.NextResponse.json(
+        { error: response.error, details: response.details },
+        { status: response.status }
+      );
+    }
     return response;
   } catch (error) {
     console.error("Check purchase failed:", error);
-    if (error instanceof import_core.SolvaPayError) {
-      return import_server16.NextResponse.json({ error: error.message }, { status: 500 });
-    }
     const errorMessage = error instanceof Error ? error.message : "Unknown error";
-    return import_server16.NextResponse.json(
+    return import_server24.NextResponse.json(
       { error: "Failed to check purchase", details: errorMessage },
       { status: 500 }
     );
@@ -452,6 +530,7 @@ async function checkPurchase(request, options = {}) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  activatePlan,
   cancelRenewal,
   checkPurchase,
   clearAllPurchaseCache,
@@ -461,9 +540,15 @@ async function checkPurchase(request, options = {}) {
   createCustomerSession,
   createPaymentIntent,
   createSupabaseAuthMiddleware,
+  createTopupPaymentIntent,
   getAuthenticatedUser,
+  getCustomerBalance,
+  getMerchant,
+  getProduct,
   getPurchaseCacheStats,
   listPlans,
   processPaymentIntent,
-  syncCustomer
+  reactivateRenewal,
+  syncCustomer,
+  trackUsage
 });

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { NextResponse } from 'next/server';
 import * as _solvapay_server from '@solvapay/server';
-import { AuthenticatedUser, SolvaPay } from '@solvapay/server';
+import { AuthenticatedUser, SolvaPay, CustomerBalanceResult, ActivatePlanResult, listPlansCore, getMerchantCore, getProductCore } from '@solvapay/server';
 export { AuthMiddlewareOptions, SupabaseAuthMiddlewareOptions, createAuthMiddleware, createSupabaseAuthMiddleware } from './middleware.cjs';
 import '@solvapay/auth';
 
@@ -40,7 +40,7 @@ interface PurchaseCheckResult {
     purchases: Array<{
         reference: string;
         productName?: string;
-        productReference?: string;
+        productRef?: string;
         status?: string;
         startDate?: string;
         planSnapshot?: {
@@ -200,6 +200,16 @@ declare function syncCustomer(request: globalThis.Request, options?: {
     includeEmail?: boolean;
     includeName?: boolean;
 }): Promise<string | NextResponse>;
+/**
+ * Get customer credits - Next.js wrapper
+ *
+ * @param request - Next.js request object
+ * @param options - Configuration options
+ * @returns Customer credits result or NextResponse error
+ */
+declare function getCustomerBalance(request: globalThis.Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<CustomerBalanceResult | NextResponse>;
 
 declare function createPaymentIntent(request: globalThis.Request, body: {
     planRef: string;
@@ -209,7 +219,22 @@ declare function createPaymentIntent(request: globalThis.Request, body: {
     includeEmail?: boolean;
     includeName?: boolean;
 }): Promise<{
-    id: string;
+    processorPaymentId: string;
+    clientSecret: string;
+    publishableKey: string;
+    accountId?: string;
+    customerRef: string;
+} | NextResponse>;
+declare function createTopupPaymentIntent(request: globalThis.Request, body: {
+    amount: number;
+    currency: string;
+    description?: string;
+}, options?: {
+    solvaPay?: SolvaPay;
+    includeEmail?: boolean;
+    includeName?: boolean;
+}): Promise<{
+    processorPaymentId: string;
     clientSecret: string;
     publishableKey: string;
     accountId?: string;
@@ -249,8 +274,17 @@ declare function createCustomerSession(request: globalThis.Request, options?: {
     customerUrl: string;
 } | NextResponse>;
 
+declare function activatePlan(request: globalThis.Request, body: {
+    productRef: string;
+    planRef: string;
+}, options?: {
+    solvaPay?: SolvaPay;
+    includeEmail?: boolean;
+    includeName?: boolean;
+}): Promise<ActivatePlanResult | NextResponse>;
+
 /**
- * Next.js Purchase Cancellation Helpers
+ * Next.js Purchase Cancellation & Reactivation Helpers
  */
 /**
  * Cancel purchase - Next.js wrapper
@@ -266,14 +300,75 @@ declare function cancelRenewal(request: globalThis.Request, body: {
 }, options?: {
     solvaPay?: SolvaPay;
 }): Promise<Record<string, unknown> | NextResponse>;
+/**
+ * Reactivate purchase - Next.js wrapper
+ *
+ * Undoes a pending cancellation, restoring auto-renewal.
+ *
+ * @param request - Next.js request object
+ * @param body - Reactivation parameters
+ * @param options - Configuration options
+ * @returns Reactivated purchase response or NextResponse error
+ */
+declare function reactivateRenewal(request: globalThis.Request, body: {
+    purchaseRef: string;
+}, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<Record<string, unknown> | NextResponse>;
 
+type ListPlansSuccess = Exclude<Awaited<ReturnType<typeof listPlansCore>>, {
+    error: string;
+}>;
 /**
  * Next.js Plans Helper
  */
-declare function listPlans(request: globalThis.Request): Promise<{
-    plans: Array<Record<string, unknown>>;
-    productRef: string;
-} | NextResponse>;
+declare function listPlans(request: globalThis.Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<ListPlansSuccess | NextResponse>;
+
+type GetMerchantSuccess = Exclude<Awaited<ReturnType<typeof getMerchantCore>>, {
+    error: string;
+}>;
+/**
+ * Next.js route wrapper for GET /api/merchant.
+ *
+ * @example
+ * ```ts
+ * // app/api/merchant/route.ts
+ * import { getMerchant } from '@solvapay/next/helpers'
+ * export const GET = (request: Request) => getMerchant(request)
+ * ```
+ */
+declare function getMerchant(request: globalThis.Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<GetMerchantSuccess | NextResponse>;
+
+type GetProductSuccess = Exclude<Awaited<ReturnType<typeof getProductCore>>, {
+    error: string;
+}>;
+/**
+ * Next.js route wrapper for GET /api/get-product?productRef=...
+ *
+ * @example
+ * ```ts
+ * // app/api/get-product/route.ts
+ * import { getProduct } from '@solvapay/next/helpers'
+ * export const GET = (request: Request) => getProduct(request)
+ * ```
+ */
+declare function getProduct(request: globalThis.Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<GetProductSuccess | NextResponse>;
+
+declare function trackUsage(request: globalThis.Request, body: {
+    actionType?: 'transaction' | 'api_call' | 'hour' | 'email' | 'storage' | 'custom';
+    units?: number;
+    productRef?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<NextResponse>;
 
 /**
  * SolvaPay Next.js SDK
@@ -321,41 +416,9 @@ interface CheckPurchaseOptions {
  * - Fast path optimization using cached customer references from client
  * - Automatic customer creation if needed
  *
- * The function:
- * 1. Extracts user ID from request (via requireUserId from @solvapay/auth)
- * 2. Gets user email and name from Supabase JWT token (if available)
- * 3. Validates cached customer reference (if provided via header)
- * 4. Ensures customer exists in SolvaPay backend
- * 5. Returns customer purchase information
- *
- * @param request - Next.js request object (NextRequest extends Request)
- * @param options - Configuration options
- * @param options.deduplication - Request deduplication options (see {@link RequestDeduplicationOptions})
- * @param options.solvaPay - Optional SolvaPay instance (creates new one if not provided)
- * @param options.includeEmail - Whether to include email in response (default: true)
- * @param options.includeName - Whether to include name in response (default: true)
- * @returns Purchase check result with customer data and purchases, or NextResponse error
- *
- * @example
- * ```typescript
- * import { NextRequest, NextResponse } from 'next/server';
- * import { checkPurchase } from '@solvapay/next';
- *
- * export async function GET(request: NextRequest) {
- *   const result = await checkPurchase(request);
- *
- *   if (result instanceof NextResponse) {
- *     return result; // Error response
- *   }
- *
- *   return NextResponse.json(result);
- * }
- * ```
- *
- * @see {@link clearPurchaseCache} for cache management
- * @see {@link getPurchaseCacheStats} for cache monitoring
- * @since 1.0.0
+ * Delegates to `checkPurchaseCore` from `@solvapay/server` for the actual logic,
+ * wrapping with Next.js-specific deduplication and response formatting.
  */
 declare function checkPurchase(request: Request, options?: CheckPurchaseOptions): Promise<PurchaseCheckResult | NextResponse>;
 
-export { type CheckPurchaseOptions, type PurchaseCheckResult, type RequestDeduplicationOptions, cancelRenewal, checkPurchase, clearAllPurchaseCache, clearPurchaseCache, createCheckoutSession, createCustomerSession, createPaymentIntent, getAuthenticatedUser, getPurchaseCacheStats, listPlans, processPaymentIntent, syncCustomer };
+export { type CheckPurchaseOptions, type PurchaseCheckResult, type RequestDeduplicationOptions, activatePlan, cancelRenewal, checkPurchase, clearAllPurchaseCache, clearPurchaseCache, createCheckoutSession, createCustomerSession, createPaymentIntent, createTopupPaymentIntent, getAuthenticatedUser, getCustomerBalance, getMerchant, getProduct, getPurchaseCacheStats, listPlans, processPaymentIntent, reactivateRenewal, syncCustomer, trackUsage };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { NextResponse } from 'next/server';
 import * as _solvapay_server from '@solvapay/server';
-import { AuthenticatedUser, SolvaPay } from '@solvapay/server';
+import { AuthenticatedUser, SolvaPay, CustomerBalanceResult, ActivatePlanResult, listPlansCore, getMerchantCore, getProductCore } from '@solvapay/server';
 export { AuthMiddlewareOptions, SupabaseAuthMiddlewareOptions, createAuthMiddleware, createSupabaseAuthMiddleware } from './middleware.js';
 import '@solvapay/auth';
 
@@ -40,7 +40,7 @@ interface PurchaseCheckResult {
     purchases: Array<{
         reference: string;
         productName?: string;
-        productReference?: string;
+        productRef?: string;
         status?: string;
         startDate?: string;
         planSnapshot?: {
@@ -200,6 +200,16 @@ declare function syncCustomer(request: globalThis.Request, options?: {
     includeEmail?: boolean;
     includeName?: boolean;
 }): Promise<string | NextResponse>;
+/**
+ * Get customer credits - Next.js wrapper
+ *
+ * @param request - Next.js request object
+ * @param options - Configuration options
+ * @returns Customer credits result or NextResponse error
+ */
+declare function getCustomerBalance(request: globalThis.Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<CustomerBalanceResult | NextResponse>;
 
 declare function createPaymentIntent(request: globalThis.Request, body: {
     planRef: string;
@@ -209,7 +219,22 @@ declare function createPaymentIntent(request: globalThis.Request, body: {
     includeEmail?: boolean;
     includeName?: boolean;
 }): Promise<{
-    id: string;
+    processorPaymentId: string;
+    clientSecret: string;
+    publishableKey: string;
+    accountId?: string;
+    customerRef: string;
+} | NextResponse>;
+declare function createTopupPaymentIntent(request: globalThis.Request, body: {
+    amount: number;
+    currency: string;
+    description?: string;
+}, options?: {
+    solvaPay?: SolvaPay;
+    includeEmail?: boolean;
+    includeName?: boolean;
+}): Promise<{
+    processorPaymentId: string;
     clientSecret: string;
     publishableKey: string;
     accountId?: string;
@@ -249,8 +274,17 @@ declare function createCustomerSession(request: globalThis.Request, options?: {
     customerUrl: string;
 } | NextResponse>;
 
+declare function activatePlan(request: globalThis.Request, body: {
+    productRef: string;
+    planRef: string;
+}, options?: {
+    solvaPay?: SolvaPay;
+    includeEmail?: boolean;
+    includeName?: boolean;
+}): Promise<ActivatePlanResult | NextResponse>;
+
 /**
- * Next.js Purchase Cancellation Helpers
+ * Next.js Purchase Cancellation & Reactivation Helpers
  */
 /**
  * Cancel purchase - Next.js wrapper
@@ -266,14 +300,75 @@ declare function cancelRenewal(request: globalThis.Request, body: {
 }, options?: {
     solvaPay?: SolvaPay;
 }): Promise<Record<string, unknown> | NextResponse>;
+/**
+ * Reactivate purchase - Next.js wrapper
+ *
+ * Undoes a pending cancellation, restoring auto-renewal.
+ *
+ * @param request - Next.js request object
+ * @param body - Reactivation parameters
+ * @param options - Configuration options
+ * @returns Reactivated purchase response or NextResponse error
+ */
+declare function reactivateRenewal(request: globalThis.Request, body: {
+    purchaseRef: string;
+}, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<Record<string, unknown> | NextResponse>;
 
+type ListPlansSuccess = Exclude<Awaited<ReturnType<typeof listPlansCore>>, {
+    error: string;
+}>;
 /**
  * Next.js Plans Helper
  */
-declare function listPlans(request: globalThis.Request): Promise<{
-    plans: Array<Record<string, unknown>>;
-    productRef: string;
-} | NextResponse>;
+declare function listPlans(request: globalThis.Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<ListPlansSuccess | NextResponse>;
+
+type GetMerchantSuccess = Exclude<Awaited<ReturnType<typeof getMerchantCore>>, {
+    error: string;
+}>;
+/**
+ * Next.js route wrapper for GET /api/merchant.
+ *
+ * @example
+ * ```ts
+ * // app/api/merchant/route.ts
+ * import { getMerchant } from '@solvapay/next/helpers'
+ * export const GET = (request: Request) => getMerchant(request)
+ * ```
+ */
+declare function getMerchant(request: globalThis.Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<GetMerchantSuccess | NextResponse>;
+
+type GetProductSuccess = Exclude<Awaited<ReturnType<typeof getProductCore>>, {
+    error: string;
+}>;
+/**
+ * Next.js route wrapper for GET /api/get-product?productRef=...
+ *
+ * @example
+ * ```ts
+ * // app/api/get-product/route.ts
+ * import { getProduct } from '@solvapay/next/helpers'
+ * export const GET = (request: Request) => getProduct(request)
+ * ```
+ */
+declare function getProduct(request: globalThis.Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<GetProductSuccess | NextResponse>;
+
+declare function trackUsage(request: globalThis.Request, body: {
+    actionType?: 'transaction' | 'api_call' | 'hour' | 'email' | 'storage' | 'custom';
+    units?: number;
+    productRef?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<NextResponse>;
 
 /**
  * SolvaPay Next.js SDK
@@ -321,41 +416,9 @@ interface CheckPurchaseOptions {
  * - Fast path optimization using cached customer references from client
  * - Automatic customer creation if needed
  *
- * The function:
- * 1. Extracts user ID from request (via requireUserId from @solvapay/auth)
- * 2. Gets user email and name from Supabase JWT token (if available)
- * 3. Validates cached customer reference (if provided via header)
- * 4. Ensures customer exists in SolvaPay backend
- * 5. Returns customer purchase information
- *
- * @param request - Next.js request object (NextRequest extends Request)
- * @param options - Configuration options
- * @param options.deduplication - Request deduplication options (see {@link RequestDeduplicationOptions})
- * @param options.solvaPay - Optional SolvaPay instance (creates new one if not provided)
- * @param options.includeEmail - Whether to include email in response (default: true)
- * @param options.includeName - Whether to include name in response (default: true)
- * @returns Purchase check result with customer data and purchases, or NextResponse error
- *
- * @example
- * ```typescript
- * import { NextRequest, NextResponse } from 'next/server';
- * import { checkPurchase } from '@solvapay/next';
- *
- * export async function GET(request: NextRequest) {
- *   const result = await checkPurchase(request);
- *
- *   if (result instanceof NextResponse) {
- *     return result; // Error response
- *   }
- *
- *   return NextResponse.json(result);
- * }
- * ```
- *
- * @see {@link clearPurchaseCache} for cache management
- * @see {@link getPurchaseCacheStats} for cache monitoring
- * @since 1.0.0
+ * Delegates to `checkPurchaseCore` from `@solvapay/server` for the actual logic,
+ * wrapping with Next.js-specific deduplication and response formatting.
  */
 declare function checkPurchase(request: Request, options?: CheckPurchaseOptions): Promise<PurchaseCheckResult | NextResponse>;
 
-export { type CheckPurchaseOptions, type PurchaseCheckResult, type RequestDeduplicationOptions, cancelRenewal, checkPurchase, clearAllPurchaseCache, clearPurchaseCache, createCheckoutSession, createCustomerSession, createPaymentIntent, getAuthenticatedUser, getPurchaseCacheStats, listPlans, processPaymentIntent, syncCustomer };
+export { type CheckPurchaseOptions, type PurchaseCheckResult, type RequestDeduplicationOptions, activatePlan, cancelRenewal, checkPurchase, clearAllPurchaseCache, clearPurchaseCache, createCheckoutSession, createCustomerSession, createPaymentIntent, createTopupPaymentIntent, getAuthenticatedUser, getCustomerBalance, getMerchant, getProduct, getPurchaseCacheStats, listPlans, processPaymentIntent, reactivateRenewal, syncCustomer, trackUsage };

package/dist/index.js

@@ -4,9 +4,8 @@ import {
 } from "./chunk-F7TBIH6W.js";
 
 // src/index.ts
-import { NextResponse as NextResponse7 } from "next/server";
-import { createSolvaPay } from "@solvapay/server";
-import { SolvaPayError } from "@solvapay/core";
+import { NextResponse as NextResponse11 } from "next/server";
+import { checkPurchaseCore, isErrorResult as isErrorResult11 } from "@solvapay/server";
 
 // src/cache.ts
 function createRequestDeduplicator(options = {}) {
@@ -157,7 +156,7 @@ async function getAuthenticatedUser(request, options = {}) {
 
 // src/helpers/customer.ts
 import { NextResponse as NextResponse2 } from "next/server";
-import { syncCustomerCore, isErrorResult as isErrorResult2 } from "@solvapay/server";
+import { syncCustomerCore, getCustomerBalanceCore, isErrorResult as isErrorResult2 } from "@solvapay/server";
 async function syncCustomer(request, options = {}) {
   const result = await syncCustomerCore(request, options);
   if (isErrorResult2(result)) {
@@ -168,11 +167,22 @@ async function syncCustomer(request, options = {}) {
   }
   return result;
 }
+async function getCustomerBalance(request, options = {}) {
+  const result = await getCustomerBalanceCore(request, options);
+  if (isErrorResult2(result)) {
+    return NextResponse2.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  return result;
+}
 
 // src/helpers/payment.ts
 import { NextResponse as NextResponse3 } from "next/server";
 import {
   createPaymentIntentCore,
+  createTopupPaymentIntentCore,
   processPaymentIntentCore,
   isErrorResult as isErrorResult3
 } from "@solvapay/server";
@@ -194,6 +204,23 @@ async function createPaymentIntent(request, body, options = {}) {
   }
   return result;
 }
+async function createTopupPaymentIntent(request, body, options = {}) {
+  const result = await createTopupPaymentIntentCore(request, body, options);
+  if (isErrorResult3(result)) {
+    return NextResponse3.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  try {
+    const userResult = await getAuthenticatedUserCore2(request);
+    if (!isErrorResult3(userResult)) {
+      clearPurchaseCache(userResult.userId);
+    }
+  } catch {
+  }
+  return result;
+}
 async function processPaymentIntent(request, body, options = {}) {
   const result = await processPaymentIntentCore(request, body, options);
   if (isErrorResult3(result)) {
@@ -240,12 +267,12 @@ async function createCustomerSession(request, options = {}) {
   return result;
 }
 
-// src/helpers/renewal.ts
+// src/helpers/activation.ts
 import { NextResponse as NextResponse5 } from "next/server";
-import { cancelPurchaseCore, isErrorResult as isErrorResult5 } from "@solvapay/server";
+import { activatePlanCore, isErrorResult as isErrorResult5 } from "@solvapay/server";
 import { getAuthenticatedUserCore as getAuthenticatedUserCore3 } from "@solvapay/server";
-async function cancelRenewal(request, body, options = {}) {
-  const result = await cancelPurchaseCore(request, body, options);
+async function activatePlan(request, body, options = {}) {
+  const result = await activatePlanCore(request, body, options);
   if (isErrorResult5(result)) {
     return NextResponse5.json(
       { error: result.error, details: result.details },
@@ -262,94 +289,145 @@ async function cancelRenewal(request, body, options = {}) {
   return result;
 }
 
-// src/helpers/plans.ts
+// src/helpers/renewal.ts
 import { NextResponse as NextResponse6 } from "next/server";
-import { listPlansCore, isErrorResult as isErrorResult6 } from "@solvapay/server";
-async function listPlans(request) {
-  const result = await listPlansCore(request);
+import {
+  cancelPurchaseCore,
+  reactivatePurchaseCore,
+  isErrorResult as isErrorResult6,
+  getAuthenticatedUserCore as getAuthenticatedUserCore4
+} from "@solvapay/server";
+async function cancelRenewal(request, body, options = {}) {
+  const result = await cancelPurchaseCore(request, body, options);
+  if (isErrorResult6(result)) {
+    return NextResponse6.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  try {
+    const userResult = await getAuthenticatedUserCore4(request);
+    if (!isErrorResult6(userResult)) {
+      clearPurchaseCache(userResult.userId);
+    }
+  } catch {
+  }
+  return result;
+}
+async function reactivateRenewal(request, body, options = {}) {
+  const result = await reactivatePurchaseCore(request, body, options);
   if (isErrorResult6(result)) {
     return NextResponse6.json(
       { error: result.error, details: result.details },
       { status: result.status }
     );
   }
+  try {
+    const userResult = await getAuthenticatedUserCore4(request);
+    if (!isErrorResult6(userResult)) {
+      clearPurchaseCache(userResult.userId);
+    }
+  } catch {
+  }
+  return result;
+}
+
+// src/helpers/plans.ts
+import { NextResponse as NextResponse7 } from "next/server";
+import { listPlansCore, isErrorResult as isErrorResult7 } from "@solvapay/server";
+async function listPlans(request, options = {}) {
+  const result = await listPlansCore(request, options);
+  if (isErrorResult7(result)) {
+    return NextResponse7.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  return result;
+}
+
+// src/helpers/merchant.ts
+import { NextResponse as NextResponse8 } from "next/server";
+import { getMerchantCore, isErrorResult as isErrorResult8 } from "@solvapay/server";
+async function getMerchant(request, options = {}) {
+  const result = await getMerchantCore(request, options);
+  if (isErrorResult8(result)) {
+    return NextResponse8.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
   return result;
 }
 
+// src/helpers/product.ts
+import { NextResponse as NextResponse9 } from "next/server";
+import { getProductCore, isErrorResult as isErrorResult9 } from "@solvapay/server";
+async function getProduct(request, options = {}) {
+  const result = await getProductCore(request, options);
+  if (isErrorResult9(result)) {
+    return NextResponse9.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  return result;
+}
+
+// src/helpers/usage.ts
+import { NextResponse as NextResponse10 } from "next/server";
+import { trackUsageCore, isErrorResult as isErrorResult10 } from "@solvapay/server";
+async function trackUsage(request, body, options = {}) {
+  const result = await trackUsageCore(request, body, options);
+  if (isErrorResult10(result)) {
+    return NextResponse10.json(
+      { error: result.error, details: result.details },
+      { status: result.status }
+    );
+  }
+  return NextResponse10.json(result);
+}
+
 // src/index.ts
 async function checkPurchase(request, options = {}) {
+  const deduplicator = getSharedDeduplicator(options.deduplication);
   try {
-    const { requireUserId, getUserEmailFromRequest, getUserNameFromRequest } = await import("@solvapay/auth");
+    const { requireUserId } = await import("@solvapay/auth");
     const userIdOrError = requireUserId(request);
     if (userIdOrError instanceof Response) {
       const clonedResponse = userIdOrError.clone();
       const body = await clonedResponse.json().catch(() => ({ error: "Unauthorized" }));
-      return NextResponse7.json(body, { status: userIdOrError.status });
+      return NextResponse11.json(body, { status: userIdOrError.status });
     }
     const userId = userIdOrError;
-    const email = options.includeEmail !== false ? await getUserEmailFromRequest(request) : null;
-    const name = options.includeName !== false ? await getUserNameFromRequest(request) : null;
-    const cachedCustomerRef = request.headers.get("x-solvapay-customer-ref");
-    const solvaPay = options.solvaPay || createSolvaPay();
-    if (cachedCustomerRef) {
-      try {
-        const customer = await solvaPay.getCustomer({ customerRef: cachedCustomerRef });
-        if (customer && customer.customerRef) {
-          if (customer.externalRef && customer.externalRef === userId) {
-            const filteredPurchases = (customer.purchases || []).filter(
-              (p) => p.status === "active"
-            );
-            return {
-              customerRef: customer.customerRef,
-              email: customer.email,
-              name: customer.name,
-              purchases: filteredPurchases
-            };
-          }
-        }
-      } catch {
-      }
-    }
-    const deduplicator = getSharedDeduplicator(options.deduplication);
-    const response = await deduplicator.deduplicate(userId, async () => {
-      try {
-        const ensuredCustomerRef = await solvaPay.ensureCustomer(userId, userId, {
-          email: email || void 0,
-          name: name || void 0
+    const response = await deduplicator.deduplicate(
+      userId,
+      async () => {
+        return await checkPurchaseCore(request, {
+          solvaPay: options.solvaPay,
+          includeEmail: options.includeEmail,
+          includeName: options.includeName
         });
-        const customer = await solvaPay.getCustomer({ customerRef: ensuredCustomerRef });
-        const filteredPurchases = (customer.purchases || []).filter(
-          (p) => p.status === "active"
-        );
-        const result = {
-          customerRef: customer.customerRef || userId,
-          email: customer.email,
-          name: customer.name,
-          purchases: filteredPurchases
-        };
-        return result;
-      } catch (error) {
-        console.error("[checkPurchase] Error fetching customer:", error);
-        return {
-          customerRef: userId,
-          purchases: []
-        };
       }
-    });
+    );
+    if (isErrorResult11(response)) {
+      return NextResponse11.json(
+        { error: response.error, details: response.details },
+        { status: response.status }
+      );
+    }
     return response;
   } catch (error) {
     console.error("Check purchase failed:", error);
-    if (error instanceof SolvaPayError) {
-      return NextResponse7.json({ error: error.message }, { status: 500 });
-    }
     const errorMessage = error instanceof Error ? error.message : "Unknown error";
-    return NextResponse7.json(
+    return NextResponse11.json(
       { error: "Failed to check purchase", details: errorMessage },
       { status: 500 }
     );
   }
 }
 export {
+  activatePlan,
   cancelRenewal,
   checkPurchase,
   clearAllPurchaseCache,
@@ -359,9 +437,15 @@ export {
   createCustomerSession,
   createPaymentIntent,
   createSupabaseAuthMiddleware,
+  createTopupPaymentIntent,
   getAuthenticatedUser,
+  getCustomerBalance,
+  getMerchant,
+  getProduct,
   getPurchaseCacheStats,
   listPlans,
   processPaymentIntent,
-  syncCustomer
+  reactivateRenewal,
+  syncCustomer,
+  trackUsage
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvapay/next",
-  "version": "1.0.6",
+  "version": "1.0.8-preview.1",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -34,9 +34,9 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@solvapay/auth": "1.0.6",
-    "@solvapay/core": "1.0.6",
-    "@solvapay/server": "1.0.6"
+    "@solvapay/auth": "1.0.8-preview.1",
+    "@solvapay/server": "1.0.8-preview.1",
+    "@solvapay/core": "1.0.8-preview.1"
   },
   "peerDependencies": {
     "next": ">=13.0.0"