@4mica/sdk-next 1.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 4mica Network
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# @4mica/sdk-next
+
+Next.js App Router helpers for gating routes behind a [4Mica](https://4mica.io) x402 payment.
+
+These helpers are **Web-standard and edge-safe** — `NextRequest`/`NextResponse` extend the Web
+`Request`/`Response`, so no `next` import is needed and they run on both the Edge and Node runtimes.
+
+## Install
+
+```bash
+pnpm add @4mica/sdk-next @4mica/sdk-node
+```
+
+## Route handler
+
+```ts
+// app/api/protected/route.ts
+import { withPaywall } from "@4mica/sdk-next";
+import { createClient } from "@4mica/sdk-node";
+
+const client = await createClient(); // reads 4MICA_* env
+
+export const GET = withPaywall(
+  async () => Response.json({ data: "premium content" }),
+  client.rpc,
+  {
+    payTo: "0x…",
+    asset: "0x0000000000000000000000000000000000000000",
+    network: "base-sepolia",
+    amount: "1000",
+    tabEndpoint: "https://your-recipient.example/tab",
+  },
+);
+```
+
+No `X-PAYMENT` header → `402` with the x402 payment requirements. Valid payment → your handler runs
+and `X-PAYMENT-RESPONSE` is added to the response.
+
+## Middleware
+
+```ts
+// middleware.ts
+import { NextResponse } from "next/server";
+import { paywallMiddleware } from "@4mica/sdk-next";
+import { createClient } from "@4mica/sdk-node";
+
+const client = await createClient();
+const gate = paywallMiddleware(client.rpc, {
+  payTo: "0x…",
+  asset: "0x0000000000000000000000000000000000000000",
+  network: "base-sepolia",
+  amount: "1000",
+  tabEndpoint: "https://your-recipient.example/tab",
+});
+
+export const config = { matcher: "/api/protected/:path*" };
+
+export async function middleware(request: Request) {
+  return (await gate(request)) ?? NextResponse.next();
+}
+```
+
+## Notes
+
+- The paywall only **verifies** payment (issues a guarantee). On-chain settlement (`remunerate`) is
+  an out-of-band recipient operation.
+- All heavy lifting lives in `@4mica/sdk/server`'s runtime-neutral `createPaywall`; this package is
+  a thin mapping to Next's route/middleware shapes.

package/dist/index.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+var server = require('@4mica/sdk/server');
+
+// src/index.ts
+function withPaywall(handler, verifier, config) {
+  const pw = server.createPaywall(verifier, config);
+  return async (request, context) => {
+    const result = await pw.handle(request);
+    if (result instanceof Response) {
+      return result;
+    }
+    const response = await handler(request, context);
+    result.headers.forEach((value, key) => {
+      response.headers.set(key, value);
+    });
+    return response;
+  };
+}
+function paywallMiddleware(verifier, config) {
+  const pw = server.createPaywall(verifier, config);
+  return async (request) => {
+    const result = await pw.handle(request);
+    return result instanceof Response ? result : void 0;
+  };
+}
+
+exports.paywallMiddleware = paywallMiddleware;
+exports.withPaywall = withPaywall;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["createPaywall"],"mappings":";;;;;AA+BO,SAAS,WAAA,CACd,OAAA,EACA,QAAA,EACA,MAAA,EACc;AACd,EAAA,MAAM,EAAA,GAAKA,oBAAA,CAAc,QAAA,EAAU,MAAM,CAAA;AACzC,EAAA,OAAO,OAAO,SAAS,OAAA,KAAY;AACjC,IAAA,MAAM,MAAA,GAAS,MAAM,EAAA,CAAG,MAAA,CAAO,OAAO,CAAA;AACtC,IAAA,IAAI,kBAAkB,QAAA,EAAU;AAC9B,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,MAAM,QAAA,GAAW,MAAM,OAAA,CAAQ,OAAA,EAAS,OAAO,CAAA;AAC/C,IAAA,MAAA,CAAO,OAAA,CAAQ,OAAA,CAAQ,CAAC,KAAA,EAAO,GAAA,KAAQ;AACrC,MAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AAAA,IACjC,CAAC,CAAA;AACD,IAAA,OAAO,QAAA;AAAA,EACT,CAAA;AACF;AAgBO,SAAS,iBAAA,CACd,UACA,MAAA,EACqD;AACrD,EAAA,MAAM,EAAA,GAAKA,oBAAA,CAAc,QAAA,EAAU,MAAM,CAAA;AACzC,EAAA,OAAO,OAAO,OAAA,KAAY;AACxB,IAAA,MAAM,MAAA,GAAS,MAAM,EAAA,CAAG,MAAA,CAAO,OAAO,CAAA;AACtC,IAAA,OAAO,MAAA,YAAkB,WAAW,MAAA,GAAS,MAAA;AAAA,EAC/C,CAAA;AACF","file":"index.cjs","sourcesContent":["import type {\n  PaywallConfig,\n  PaywallGuarantee,\n  PaywallVerifier,\n} from \"@4mica/sdk/server\";\nimport { createPaywall } from \"@4mica/sdk/server\";\n\nexport type { PaywallConfig, PaywallGuarantee, PaywallVerifier };\n\n/**\n * A Next.js App Router route handler. `NextRequest` extends the Web `Request`\n * and `NextResponse` extends `Response`, so these helpers are Web-standard and\n * edge-safe — no `next` import required.\n */\nexport type RouteHandler = (\n  request: Request,\n  context?: unknown,\n) => Response | Promise<Response>;\n\n/**\n * Wrap an App Router route handler so it is gated behind a 4Mica x402 payment.\n *\n * When no valid `X-PAYMENT` header is present, returns a `402` with the x402\n * payment requirements. Otherwise verifies the payment, runs `handler`, and\n * merges the `X-PAYMENT-RESPONSE` header onto its response.\n *\n * @example\n * ```ts\n * export const GET = withPaywall(async () => Response.json({ ok: true }), client.rpc, config);\n * ```\n */\nexport function withPaywall(\n  handler: RouteHandler,\n  verifier: PaywallVerifier,\n  config: PaywallConfig,\n): RouteHandler {\n  const pw = createPaywall(verifier, config);\n  return async (request, context) => {\n    const result = await pw.handle(request);\n    if (result instanceof Response) {\n      return result;\n    }\n    const response = await handler(request, context);\n    result.headers.forEach((value, key) => {\n      response.headers.set(key, value);\n    });\n    return response;\n  };\n}\n\n/**\n * Build a `middleware.ts` handler that gates matched routes behind a payment.\n *\n * Returns a `402` `Response` when payment is required/invalid, or `undefined`\n * to let the request continue. Edge-safe — usable without `export const runtime\n * = \"nodejs\"` (Node runtime remains a supported fallback).\n *\n * @example\n * ```ts\n * // middleware.ts\n * const gate = paywallMiddleware(client.rpc, config);\n * export async function middleware(req: Request) { return (await gate(req)) ?? NextResponse.next(); }\n * ```\n */\nexport function paywallMiddleware(\n  verifier: PaywallVerifier,\n  config: PaywallConfig,\n): (request: Request) => Promise<Response | undefined> {\n  const pw = createPaywall(verifier, config);\n  return async (request) => {\n    const result = await pw.handle(request);\n    return result instanceof Response ? result : undefined;\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,39 @@
+import { PaywallVerifier, PaywallConfig } from '@4mica/sdk/server';
+export { PaywallConfig, PaywallGuarantee, PaywallVerifier } from '@4mica/sdk/server';
+
+/**
+ * A Next.js App Router route handler. `NextRequest` extends the Web `Request`
+ * and `NextResponse` extends `Response`, so these helpers are Web-standard and
+ * edge-safe — no `next` import required.
+ */
+type RouteHandler = (request: Request, context?: unknown) => Response | Promise<Response>;
+/**
+ * Wrap an App Router route handler so it is gated behind a 4Mica x402 payment.
+ *
+ * When no valid `X-PAYMENT` header is present, returns a `402` with the x402
+ * payment requirements. Otherwise verifies the payment, runs `handler`, and
+ * merges the `X-PAYMENT-RESPONSE` header onto its response.
+ *
+ * @example
+ * ```ts
+ * export const GET = withPaywall(async () => Response.json({ ok: true }), client.rpc, config);
+ * ```
+ */
+declare function withPaywall(handler: RouteHandler, verifier: PaywallVerifier, config: PaywallConfig): RouteHandler;
+/**
+ * Build a `middleware.ts` handler that gates matched routes behind a payment.
+ *
+ * Returns a `402` `Response` when payment is required/invalid, or `undefined`
+ * to let the request continue. Edge-safe — usable without `export const runtime
+ * = "nodejs"` (Node runtime remains a supported fallback).
+ *
+ * @example
+ * ```ts
+ * // middleware.ts
+ * const gate = paywallMiddleware(client.rpc, config);
+ * export async function middleware(req: Request) { return (await gate(req)) ?? NextResponse.next(); }
+ * ```
+ */
+declare function paywallMiddleware(verifier: PaywallVerifier, config: PaywallConfig): (request: Request) => Promise<Response | undefined>;
+
+export { type RouteHandler, paywallMiddleware, withPaywall };

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { PaywallVerifier, PaywallConfig } from '@4mica/sdk/server';
+export { PaywallConfig, PaywallGuarantee, PaywallVerifier } from '@4mica/sdk/server';
+
+/**
+ * A Next.js App Router route handler. `NextRequest` extends the Web `Request`
+ * and `NextResponse` extends `Response`, so these helpers are Web-standard and
+ * edge-safe — no `next` import required.
+ */
+type RouteHandler = (request: Request, context?: unknown) => Response | Promise<Response>;
+/**
+ * Wrap an App Router route handler so it is gated behind a 4Mica x402 payment.
+ *
+ * When no valid `X-PAYMENT` header is present, returns a `402` with the x402
+ * payment requirements. Otherwise verifies the payment, runs `handler`, and
+ * merges the `X-PAYMENT-RESPONSE` header onto its response.
+ *
+ * @example
+ * ```ts
+ * export const GET = withPaywall(async () => Response.json({ ok: true }), client.rpc, config);
+ * ```
+ */
+declare function withPaywall(handler: RouteHandler, verifier: PaywallVerifier, config: PaywallConfig): RouteHandler;
+/**
+ * Build a `middleware.ts` handler that gates matched routes behind a payment.
+ *
+ * Returns a `402` `Response` when payment is required/invalid, or `undefined`
+ * to let the request continue. Edge-safe — usable without `export const runtime
+ * = "nodejs"` (Node runtime remains a supported fallback).
+ *
+ * @example
+ * ```ts
+ * // middleware.ts
+ * const gate = paywallMiddleware(client.rpc, config);
+ * export async function middleware(req: Request) { return (await gate(req)) ?? NextResponse.next(); }
+ * ```
+ */
+declare function paywallMiddleware(verifier: PaywallVerifier, config: PaywallConfig): (request: Request) => Promise<Response | undefined>;
+
+export { type RouteHandler, paywallMiddleware, withPaywall };

package/dist/index.js

@@ -0,0 +1,28 @@
+import { createPaywall } from '@4mica/sdk/server';
+
+// src/index.ts
+function withPaywall(handler, verifier, config) {
+  const pw = createPaywall(verifier, config);
+  return async (request, context) => {
+    const result = await pw.handle(request);
+    if (result instanceof Response) {
+      return result;
+    }
+    const response = await handler(request, context);
+    result.headers.forEach((value, key) => {
+      response.headers.set(key, value);
+    });
+    return response;
+  };
+}
+function paywallMiddleware(verifier, config) {
+  const pw = createPaywall(verifier, config);
+  return async (request) => {
+    const result = await pw.handle(request);
+    return result instanceof Response ? result : void 0;
+  };
+}
+
+export { paywallMiddleware, withPaywall };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AA+BO,SAAS,WAAA,CACd,OAAA,EACA,QAAA,EACA,MAAA,EACc;AACd,EAAA,MAAM,EAAA,GAAK,aAAA,CAAc,QAAA,EAAU,MAAM,CAAA;AACzC,EAAA,OAAO,OAAO,SAAS,OAAA,KAAY;AACjC,IAAA,MAAM,MAAA,GAAS,MAAM,EAAA,CAAG,MAAA,CAAO,OAAO,CAAA;AACtC,IAAA,IAAI,kBAAkB,QAAA,EAAU;AAC9B,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,MAAM,QAAA,GAAW,MAAM,OAAA,CAAQ,OAAA,EAAS,OAAO,CAAA;AAC/C,IAAA,MAAA,CAAO,OAAA,CAAQ,OAAA,CAAQ,CAAC,KAAA,EAAO,GAAA,KAAQ;AACrC,MAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AAAA,IACjC,CAAC,CAAA;AACD,IAAA,OAAO,QAAA;AAAA,EACT,CAAA;AACF;AAgBO,SAAS,iBAAA,CACd,UACA,MAAA,EACqD;AACrD,EAAA,MAAM,EAAA,GAAK,aAAA,CAAc,QAAA,EAAU,MAAM,CAAA;AACzC,EAAA,OAAO,OAAO,OAAA,KAAY;AACxB,IAAA,MAAM,MAAA,GAAS,MAAM,EAAA,CAAG,MAAA,CAAO,OAAO,CAAA;AACtC,IAAA,OAAO,MAAA,YAAkB,WAAW,MAAA,GAAS,MAAA;AAAA,EAC/C,CAAA;AACF","file":"index.js","sourcesContent":["import type {\n  PaywallConfig,\n  PaywallGuarantee,\n  PaywallVerifier,\n} from \"@4mica/sdk/server\";\nimport { createPaywall } from \"@4mica/sdk/server\";\n\nexport type { PaywallConfig, PaywallGuarantee, PaywallVerifier };\n\n/**\n * A Next.js App Router route handler. `NextRequest` extends the Web `Request`\n * and `NextResponse` extends `Response`, so these helpers are Web-standard and\n * edge-safe — no `next` import required.\n */\nexport type RouteHandler = (\n  request: Request,\n  context?: unknown,\n) => Response | Promise<Response>;\n\n/**\n * Wrap an App Router route handler so it is gated behind a 4Mica x402 payment.\n *\n * When no valid `X-PAYMENT` header is present, returns a `402` with the x402\n * payment requirements. Otherwise verifies the payment, runs `handler`, and\n * merges the `X-PAYMENT-RESPONSE` header onto its response.\n *\n * @example\n * ```ts\n * export const GET = withPaywall(async () => Response.json({ ok: true }), client.rpc, config);\n * ```\n */\nexport function withPaywall(\n  handler: RouteHandler,\n  verifier: PaywallVerifier,\n  config: PaywallConfig,\n): RouteHandler {\n  const pw = createPaywall(verifier, config);\n  return async (request, context) => {\n    const result = await pw.handle(request);\n    if (result instanceof Response) {\n      return result;\n    }\n    const response = await handler(request, context);\n    result.headers.forEach((value, key) => {\n      response.headers.set(key, value);\n    });\n    return response;\n  };\n}\n\n/**\n * Build a `middleware.ts` handler that gates matched routes behind a payment.\n *\n * Returns a `402` `Response` when payment is required/invalid, or `undefined`\n * to let the request continue. Edge-safe — usable without `export const runtime\n * = \"nodejs\"` (Node runtime remains a supported fallback).\n *\n * @example\n * ```ts\n * // middleware.ts\n * const gate = paywallMiddleware(client.rpc, config);\n * export async function middleware(req: Request) { return (await gate(req)) ?? NextResponse.next(); }\n * ```\n */\nexport function paywallMiddleware(\n  verifier: PaywallVerifier,\n  config: PaywallConfig,\n): (request: Request) => Promise<Response | undefined> {\n  const pw = createPaywall(verifier, config);\n  return async (request) => {\n    const result = await pw.handle(request);\n    return result instanceof Response ? result : undefined;\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@4mica/sdk-next",
+  "version": "1.3.1",
+  "description": "Next.js App Router helpers for gating routes behind a 4Mica x402 payment",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/4mica-Network/homepage.git",
+    "directory": "packages/sdk-next"
+  },
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "4mica",
+    "sdk",
+    "next",
+    "nextjs",
+    "x402",
+    "payments"
+  ],
+  "dependencies": {
+    "@4mica/sdk": "1.3.1"
+  },
+  "peerDependencies": {
+    "next": ">=14"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "@types/node": "^24.10.1",
+    "publint": "^0.3.14",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.0",
+    "vitest": "^4.1.8",
+    "@4mica/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "check:exports": "attw --pack . --profile node16 && publint --strict"
+  }
+}