@closeloop/sdk 0.1.1 → 0.1.3

package/README.md

@@ -213,8 +213,8 @@ app.post("/webhook", (req, res) => {
 
     // Type-safe event handling
     if (client.webhooks.isPaymentSuccess(event)) {
-      const { creditAmount, payerAddress, planId } = event.data
-      console.log(`${payerAddress} purchased ${creditAmount} credits`)
+      const { type, walletAddress, planId, amount } = event.data
+      console.log(`${walletAddress} purchased plan ${planId} for $${amount} (${type})`)
     }
 
     if (client.webhooks.isCreditsLow(event)) {
@@ -257,55 +257,108 @@ export async function POST(request: Request) {
 
 ## Next.js Integration
 
-### Middleware
+### Proxy (Next.js 16+)
 
-Protect routes by requiring credits:
+Protect routes by verifying credits:
 
 ```typescript
-// middleware.ts
-import { CloseLoop, creditGate } from "@closeloop/sdk/nextjs"
+// proxy.ts (Next.js 16+)
+import { NextRequest, NextResponse } from "next/server"
+import { CloseLoop } from "@closeloop/sdk"
 
 const client = new CloseLoop({ apiKey: process.env.CLOSELOOP_API_KEY! })
 
-export default creditGate({
-  client,
-  planId: "plan_abc123",
-  creditsPerRequest: 1,
-  getWalletAddress: (req) => req.headers.get("x-wallet-address")
-})
+// Define routes that require credit verification
+const creditProtectedRoutes = ["/api/ai", "/api/generate"]
+
+export default async function proxy(req: NextRequest) {
+  const path = req.nextUrl.pathname
+  const isCreditProtectedRoute = creditProtectedRoutes.some(route => 
+    path.startsWith(route)
+  )
+
+  if (!isCreditProtectedRoute) {
+    return NextResponse.next()
+  }
+
+  // Get wallet address from header or session
+  const walletAddress = req.headers.get("x-wallet-address")
+
+  if (!walletAddress) {
+    return NextResponse.json(
+      { error: "Wallet address required" },
+      { status: 401 }
+    )
+  }
+
+  // Verify credits before allowing the request
+  const verification = await client.credits.verify({
+    walletAddress,
+    planId: "plan_abc123",
+    amount: 1
+  })
+
+  if (!verification.hasEnoughCredits) {
+    return NextResponse.json(
+      { error: "Insufficient credits" },
+      { status: 402 }
+    )
+  }
+
+  return NextResponse.next()
+}
 
 export const config = {
-  matcher: ["/api/protected/:path*"]
+  matcher: ["/((?!_next/static|_next/image|.*\\.png$).*)"]
 }
 ```
 
-### API Route Helper
+### Route Handler
 
-Consume credits after processing:
+Verify and consume credits atomically in API routes:
 
 ```typescript
-// app/api/ai/route.ts
+// app/api/ai/route.ts (Next.js 16+)
 import { NextRequest, NextResponse } from "next/server"
-import { CloseLoop, consumeCreditsAfterRequest } from "@closeloop/sdk/nextjs"
+import { CloseLoop, InsufficientCreditsError } from "@closeloop/sdk"
 
 const client = new CloseLoop({ apiKey: process.env.CLOSELOOP_API_KEY! })
 
 export async function POST(request: NextRequest) {
-  const wallet = request.headers.get("x-wallet-address")!
-  
-  // Process request...
-  const result = await processAIRequest()
+  const wallet = request.headers.get("x-wallet-address")
   
-  // Consume credit after successful processing
-  await consumeCreditsAfterRequest(client, {
-    walletAddress: wallet,
-    planId: "plan_abc123",
-    amount: 1,
-    consumedBy: "ai-text-generation",
-    metadata: { requestId: result.id }
-  })
+  if (!wallet) {
+    return NextResponse.json(
+      { error: "Wallet address required" },
+      { status: 401 }
+    )
+  }
   
-  return NextResponse.json(result)
+  // Verify and consume credits atomically
+  try {
+    const result = await client.credits.verifyAndConsume({
+      walletAddress: wallet,
+      planId: "plan_abc123",
+      amount: 1,
+      consumedBy: "ai-text-generation"
+    })
+    
+    // Process request after credit verification
+    const aiResult = await processAIRequest()
+    
+    return NextResponse.json({
+      ...aiResult,
+      remainingCredits: result.remainingCredits
+    })
+  } catch (error) {
+    if (error instanceof InsufficientCreditsError) {
+      return NextResponse.json(
+        { error: "Insufficient credits", remaining: error.remainingCredits },
+        { status: 402 }
+      )
+    }
+    throw error
+  }
 }
 ```
 
@@ -369,11 +422,12 @@ All inputs are validated using Zod schemas before being sent to the API:
 
 ### Rate Limiting
 
-The `creditGate` middleware does **not** include rate limiting. We strongly recommend combining it with a rate limiter:
+The proxy does **not** include rate limiting. We strongly recommend combining it with a rate limiter:
 
 ```typescript
-// middleware.ts - With rate limiting (RECOMMENDED)
-import { CloseLoop, creditGate } from "@closeloop/sdk/nextjs"
+// proxy.ts - With rate limiting (RECOMMENDED)
+import { NextRequest, NextResponse } from "next/server"
+import { CloseLoop } from "@closeloop/sdk"
 import { Ratelimit } from "@upstash/ratelimit"
 import { Redis } from "@upstash/redis"
 
@@ -381,31 +435,59 @@ const client = new CloseLoop({ apiKey: process.env.CLOSELOOP_API_KEY! })
 
 const ratelimit = new Ratelimit({
   redis: Redis.fromEnv(),
-  limiter: Ratelimit.slidingWindow(10, "10 s"), // 10 requests per 10 seconds
+  limiter: Ratelimit.slidingWindow(10, "10 s"),
 })
 
-const creditGateMiddleware = creditGate({
-  client,
-  planId: "plan_abc123",
-  creditsPerRequest: 1,
-  getWalletAddress: (req) => req.headers.get("x-wallet-address")
-})
+const creditProtectedRoutes = ["/api/ai", "/api/generate"]
+
+export default async function proxy(request: NextRequest) {
+  const path = request.nextUrl.pathname
+  const isCreditProtectedRoute = creditProtectedRoutes.some(route =>
+    path.startsWith(route)
+  )
+
+  if (!isCreditProtectedRoute) {
+    return NextResponse.next()
+  }
 
-export default async function middleware(request: NextRequest) {
   // Rate limit by IP first
-  const ip = request.ip ?? "127.0.0.1"
+  const ip = request.headers.get("x-forwarded-for") ?? "127.0.0.1"
   const { success } = await ratelimit.limit(ip)
 
   if (!success) {
-    return NextResponse.json({ error: "Rate limit exceeded" }, { status: 429 })
+    return NextResponse.json(
+      { error: "Rate limit exceeded" },
+      { status: 429 }
+    )
+  }
+
+  // Then verify credits
+  const walletAddress = request.headers.get("x-wallet-address")
+  if (!walletAddress) {
+    return NextResponse.json(
+      { error: "Wallet address required" },
+      { status: 401 }
+    )
+  }
+
+  const verification = await client.credits.verify({
+    walletAddress,
+    planId: "plan_abc123",
+    amount: 1
+  })
+
+  if (!verification.hasEnoughCredits) {
+    return NextResponse.json(
+      { error: "Insufficient credits" },
+      { status: 402 }
+    )
   }
 
-  // Then check credits
-  return creditGateMiddleware(request)
+  return NextResponse.next()
 }
 
 export const config = {
-  matcher: ["/api/protected/:path*"]
+  matcher: ["/((?!_next/static|_next/image|.*\\.png$).*)"]
 }
 ```
 

package/dist/{errors-B0i1OvBd.d.mts → errors-CmMqVxNU.d.mts}

@@ -568,9 +568,9 @@ interface WebhookEvent<T = WebhookPayload> {
  */
 interface PaymentSuccessPayload {
     /**
-     * Transaction ID
+     * Access type of the plan (API, CREDIT, DISCORD, etc.)
      */
-    transactionId: string;
+    type: string;
     /**
      * Plan ID that was purchased
      */
@@ -584,25 +584,17 @@ interface PaymentSuccessPayload {
      */
     amount: number;
     /**
-     * Number of API requests (for API access type)
-     */
-    requests: number | null;
-    /**
-     * Number of credits (for CREDIT access type)
-     */
-    creditAmount: number | null;
-    /**
-     * Blockchain transaction hash
+     * Wallet address of the payer
      */
-    transactionHash: string;
+    walletAddress: string;
     /**
-     * Wallet address of the payer
+     * Transaction ID
      */
-    payerAddress: string;
+    transactionId: string;
     /**
-     * Access type of the plan
+     * Allow additional properties for extensibility
      */
-    accessType: string;
+    [key: string]: unknown;
 }
 /**
  * Payload for credits.low events
@@ -687,8 +679,8 @@ declare class Webhooks {
      *     })
      *
      *     if (client.webhooks.isPaymentSuccess(event)) {
-     *       const { creditAmount, payerAddress } = event.data
-     *       // Handle credit purchase
+     *       const { type, walletAddress, planId, amount } = event.data
+     *       // Handle payment success
      *     }
      *
      *     res.json({ received: true })
@@ -727,7 +719,7 @@ declare class Webhooks {
      * ```typescript
      * if (client.webhooks.isPaymentSuccess(event)) {
      *   // TypeScript knows event.data is PaymentSuccessPayload
-     *   console.log(event.data.creditAmount)
+     *   console.log(event.data.planId, event.data.walletAddress)
      * }
      * ```
      */

package/dist/{errors-B0i1OvBd.d.ts → errors-CmMqVxNU.d.ts}

@@ -568,9 +568,9 @@ interface WebhookEvent<T = WebhookPayload> {
  */
 interface PaymentSuccessPayload {
     /**
-     * Transaction ID
+     * Access type of the plan (API, CREDIT, DISCORD, etc.)
      */
-    transactionId: string;
+    type: string;
     /**
      * Plan ID that was purchased
      */
@@ -584,25 +584,17 @@ interface PaymentSuccessPayload {
      */
     amount: number;
     /**
-     * Number of API requests (for API access type)
-     */
-    requests: number | null;
-    /**
-     * Number of credits (for CREDIT access type)
-     */
-    creditAmount: number | null;
-    /**
-     * Blockchain transaction hash
+     * Wallet address of the payer
      */
-    transactionHash: string;
+    walletAddress: string;
     /**
-     * Wallet address of the payer
+     * Transaction ID
      */
-    payerAddress: string;
+    transactionId: string;
     /**
-     * Access type of the plan
+     * Allow additional properties for extensibility
      */
-    accessType: string;
+    [key: string]: unknown;
 }
 /**
  * Payload for credits.low events
@@ -687,8 +679,8 @@ declare class Webhooks {
      *     })
      *
      *     if (client.webhooks.isPaymentSuccess(event)) {
-     *       const { creditAmount, payerAddress } = event.data
-     *       // Handle credit purchase
+     *       const { type, walletAddress, planId, amount } = event.data
+     *       // Handle payment success
      *     }
      *
      *     res.json({ received: true })
@@ -727,7 +719,7 @@ declare class Webhooks {
      * ```typescript
      * if (client.webhooks.isPaymentSuccess(event)) {
      *   // TypeScript knows event.data is PaymentSuccessPayload
-     *   console.log(event.data.creditAmount)
+     *   console.log(event.data.planId, event.data.walletAddress)
      * }
      * ```
      */

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-export { A as AuthenticationError, B as Balances, k as BatchConsumeParams, l as BatchConsumeResponse, C as CloseLoop, c as CloseLoopError, a as CloseLoopOptions, i as ConsumeCreditsParams, j as ConsumeCreditsResponse, m as CreditBalance, r as CreditStats, o as CreditTransaction, b as Credits, d as CreditsExpiredError, v as CreditsExpiredPayload, u as CreditsLowPayload, G as GetBalanceParams, I as InsufficientCreditsError, L as ListBalancesParams, n as ListBalancesResponse, p as ListTransactionsParams, q as ListTransactionsResponse, N as NetworkError, e as NotFoundError, P as PaymentSuccessPayload, R as RateLimitError, f as ValidationError, g as VerifyCreditsParams, h as VerifyCreditsResponse, V as VerifyWebhookParams, t as WebhookEvent, s as WebhookEventType, w as WebhookPayload, W as Webhooks } from './errors-B0i1OvBd.mjs';
+export { A as AuthenticationError, B as Balances, k as BatchConsumeParams, l as BatchConsumeResponse, C as CloseLoop, c as CloseLoopError, a as CloseLoopOptions, i as ConsumeCreditsParams, j as ConsumeCreditsResponse, m as CreditBalance, r as CreditStats, o as CreditTransaction, b as Credits, d as CreditsExpiredError, v as CreditsExpiredPayload, u as CreditsLowPayload, G as GetBalanceParams, I as InsufficientCreditsError, L as ListBalancesParams, n as ListBalancesResponse, p as ListTransactionsParams, q as ListTransactionsResponse, N as NetworkError, e as NotFoundError, P as PaymentSuccessPayload, R as RateLimitError, f as ValidationError, g as VerifyCreditsParams, h as VerifyCreditsResponse, V as VerifyWebhookParams, t as WebhookEvent, s as WebhookEventType, w as WebhookPayload, W as Webhooks } from './errors-CmMqVxNU.mjs';
 
 /**
  * Generic schema interface for validation

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AuthenticationError, B as Balances, k as BatchConsumeParams, l as BatchConsumeResponse, C as CloseLoop, c as CloseLoopError, a as CloseLoopOptions, i as ConsumeCreditsParams, j as ConsumeCreditsResponse, m as CreditBalance, r as CreditStats, o as CreditTransaction, b as Credits, d as CreditsExpiredError, v as CreditsExpiredPayload, u as CreditsLowPayload, G as GetBalanceParams, I as InsufficientCreditsError, L as ListBalancesParams, n as ListBalancesResponse, p as ListTransactionsParams, q as ListTransactionsResponse, N as NetworkError, e as NotFoundError, P as PaymentSuccessPayload, R as RateLimitError, f as ValidationError, g as VerifyCreditsParams, h as VerifyCreditsResponse, V as VerifyWebhookParams, t as WebhookEvent, s as WebhookEventType, w as WebhookPayload, W as Webhooks } from './errors-B0i1OvBd.js';
+export { A as AuthenticationError, B as Balances, k as BatchConsumeParams, l as BatchConsumeResponse, C as CloseLoop, c as CloseLoopError, a as CloseLoopOptions, i as ConsumeCreditsParams, j as ConsumeCreditsResponse, m as CreditBalance, r as CreditStats, o as CreditTransaction, b as Credits, d as CreditsExpiredError, v as CreditsExpiredPayload, u as CreditsLowPayload, G as GetBalanceParams, I as InsufficientCreditsError, L as ListBalancesParams, n as ListBalancesResponse, p as ListTransactionsParams, q as ListTransactionsResponse, N as NetworkError, e as NotFoundError, P as PaymentSuccessPayload, R as RateLimitError, f as ValidationError, g as VerifyCreditsParams, h as VerifyCreditsResponse, V as VerifyWebhookParams, t as WebhookEvent, s as WebhookEventType, w as WebhookPayload, W as Webhooks } from './errors-CmMqVxNU.js';
 
 /**
  * Generic schema interface for validation

package/dist/index.js

@@ -122,7 +122,7 @@ var paymentSuccessPayloadSchema = import_zod.z.object({
   planId: import_zod.z.string(),
   planName: import_zod.z.string(),
   amount: import_zod.z.number(),
-  wallet: import_zod.z.string(),
+  walletAddress: import_zod.z.string(),
   transactionId: import_zod.z.string()
 }).loose();
 var creditsLowPayloadSchema = import_zod.z.object({
@@ -590,8 +590,8 @@ var Webhooks = class {
    *     })
    *
    *     if (client.webhooks.isPaymentSuccess(event)) {
-   *       const { creditAmount, payerAddress } = event.data
-   *       // Handle credit purchase
+   *       const { type, walletAddress, planId, amount } = event.data
+   *       // Handle payment success
    *     }
    *
    *     res.json({ received: true })
@@ -636,7 +636,7 @@ var Webhooks = class {
    * ```typescript
    * if (client.webhooks.isPaymentSuccess(event)) {
    *   // TypeScript knows event.data is PaymentSuccessPayload
-   *   console.log(event.data.creditAmount)
+   *   console.log(event.data.planId, event.data.walletAddress)
    * }
    * ```
    */
@@ -773,7 +773,7 @@ var HttpClient = class {
         headers: {
           "Content-Type": "application/json",
           "User-Agent": USER_AGENT,
-          "X-API-Key": this.apiKey,
+          Authorization: `Bearer ${this.apiKey}`,
           ...options.headers
         },
         body: options.body ? JSON.stringify(options.body) : void 0,