@4mica/sdk-hono 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/dist/index.cjs

@@ -0,0 +1,23 @@
+'use strict';
+
+var server = require('@4mica/sdk/server');
+
+// src/index.ts
+function paywall(verifier, config) {
+  const pw = server.createPaywall(verifier, config);
+  return async (c, next) => {
+    const result = await pw.handle(c.req.raw);
+    if (result instanceof Response) {
+      return result;
+    }
+    c.set("paymentGuarantee", result.guarantee);
+    await next();
+    result.headers.forEach((value, key) => {
+      c.res.headers.set(key, value);
+    });
+  };
+}
+
+exports.paywall = paywall;
+//# 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":";;;;;AA4BO,SAAS,OAAA,CACd,UACA,MAAA,EACmB;AACnB,EAAA,MAAM,EAAA,GAAKA,oBAAA,CAAc,QAAA,EAAU,MAAM,CAAA;AACzC,EAAA,OAAO,OAAO,GAAG,IAAA,KAAS;AACxB,IAAA,MAAM,SAAS,MAAM,EAAA,CAAG,MAAA,CAAO,CAAA,CAAE,IAAI,GAAG,CAAA;AACxC,IAAA,IAAI,kBAAkB,QAAA,EAAU;AAC9B,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,CAAA,CAAE,GAAA,CAAI,kBAAA,EAAoB,MAAA,CAAO,SAAS,CAAA;AAC1C,IAAA,MAAM,IAAA,EAAK;AACX,IAAA,MAAA,CAAO,OAAA,CAAQ,OAAA,CAAQ,CAAC,KAAA,EAAO,GAAA,KAAQ;AACrC,MAAA,CAAA,CAAE,GAAA,CAAI,OAAA,CAAQ,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AAAA,IAC9B,CAAC,CAAA;AAAA,EACH,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\";\nimport type { MiddlewareHandler } from \"hono\";\n\nexport type { PaywallConfig, PaywallGuarantee, PaywallVerifier };\n\ndeclare module \"hono\" {\n  interface ContextVariableMap {\n    /** The verified 4Mica payment guarantee, set by the {@link paywall} middleware. */\n    paymentGuarantee: PaywallGuarantee;\n  }\n}\n\n/**\n * Hono middleware that gates a route behind a 4Mica x402 payment.\n *\n * Returns a `402` response with the x402 payment requirements when no valid\n * `X-PAYMENT` header is present; otherwise verifies the payment, exposes the\n * guarantee via `c.get(\"paymentGuarantee\")`, runs the handler, and merges the\n * `X-PAYMENT-RESPONSE` header onto the response.\n *\n * @param verifier - `client`, `client.rpc`, or any guarantee verifier.\n * @param config - Advertised payment requirements for the protected resource.\n */\nexport function paywall(\n  verifier: PaywallVerifier,\n  config: PaywallConfig,\n): MiddlewareHandler {\n  const pw = createPaywall(verifier, config);\n  return async (c, next) => {\n    const result = await pw.handle(c.req.raw);\n    if (result instanceof Response) {\n      return result;\n    }\n    c.set(\"paymentGuarantee\", result.guarantee);\n    await next();\n    result.headers.forEach((value, key) => {\n      c.res.headers.set(key, value);\n    });\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,24 @@
+import { PaywallGuarantee, PaywallVerifier, PaywallConfig } from '@4mica/sdk/server';
+export { PaywallConfig, PaywallGuarantee, PaywallVerifier } from '@4mica/sdk/server';
+import { MiddlewareHandler } from 'hono';
+
+declare module "hono" {
+    interface ContextVariableMap {
+        /** The verified 4Mica payment guarantee, set by the {@link paywall} middleware. */
+        paymentGuarantee: PaywallGuarantee;
+    }
+}
+/**
+ * Hono middleware that gates a route behind a 4Mica x402 payment.
+ *
+ * Returns a `402` response with the x402 payment requirements when no valid
+ * `X-PAYMENT` header is present; otherwise verifies the payment, exposes the
+ * guarantee via `c.get("paymentGuarantee")`, runs the handler, and merges the
+ * `X-PAYMENT-RESPONSE` header onto the response.
+ *
+ * @param verifier - `client`, `client.rpc`, or any guarantee verifier.
+ * @param config - Advertised payment requirements for the protected resource.
+ */
+declare function paywall(verifier: PaywallVerifier, config: PaywallConfig): MiddlewareHandler;
+
+export { paywall };

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { PaywallGuarantee, PaywallVerifier, PaywallConfig } from '@4mica/sdk/server';
+export { PaywallConfig, PaywallGuarantee, PaywallVerifier } from '@4mica/sdk/server';
+import { MiddlewareHandler } from 'hono';
+
+declare module "hono" {
+    interface ContextVariableMap {
+        /** The verified 4Mica payment guarantee, set by the {@link paywall} middleware. */
+        paymentGuarantee: PaywallGuarantee;
+    }
+}
+/**
+ * Hono middleware that gates a route behind a 4Mica x402 payment.
+ *
+ * Returns a `402` response with the x402 payment requirements when no valid
+ * `X-PAYMENT` header is present; otherwise verifies the payment, exposes the
+ * guarantee via `c.get("paymentGuarantee")`, runs the handler, and merges the
+ * `X-PAYMENT-RESPONSE` header onto the response.
+ *
+ * @param verifier - `client`, `client.rpc`, or any guarantee verifier.
+ * @param config - Advertised payment requirements for the protected resource.
+ */
+declare function paywall(verifier: PaywallVerifier, config: PaywallConfig): MiddlewareHandler;
+
+export { paywall };

package/dist/index.js

@@ -0,0 +1,21 @@
+import { createPaywall } from '@4mica/sdk/server';
+
+// src/index.ts
+function paywall(verifier, config) {
+  const pw = createPaywall(verifier, config);
+  return async (c, next) => {
+    const result = await pw.handle(c.req.raw);
+    if (result instanceof Response) {
+      return result;
+    }
+    c.set("paymentGuarantee", result.guarantee);
+    await next();
+    result.headers.forEach((value, key) => {
+      c.res.headers.set(key, value);
+    });
+  };
+}
+
+export { paywall };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AA4BO,SAAS,OAAA,CACd,UACA,MAAA,EACmB;AACnB,EAAA,MAAM,EAAA,GAAK,aAAA,CAAc,QAAA,EAAU,MAAM,CAAA;AACzC,EAAA,OAAO,OAAO,GAAG,IAAA,KAAS;AACxB,IAAA,MAAM,SAAS,MAAM,EAAA,CAAG,MAAA,CAAO,CAAA,CAAE,IAAI,GAAG,CAAA;AACxC,IAAA,IAAI,kBAAkB,QAAA,EAAU;AAC9B,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,CAAA,CAAE,GAAA,CAAI,kBAAA,EAAoB,MAAA,CAAO,SAAS,CAAA;AAC1C,IAAA,MAAM,IAAA,EAAK;AACX,IAAA,MAAA,CAAO,OAAA,CAAQ,OAAA,CAAQ,CAAC,KAAA,EAAO,GAAA,KAAQ;AACrC,MAAA,CAAA,CAAE,GAAA,CAAI,OAAA,CAAQ,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AAAA,IAC9B,CAAC,CAAA;AAAA,EACH,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\";\nimport type { MiddlewareHandler } from \"hono\";\n\nexport type { PaywallConfig, PaywallGuarantee, PaywallVerifier };\n\ndeclare module \"hono\" {\n  interface ContextVariableMap {\n    /** The verified 4Mica payment guarantee, set by the {@link paywall} middleware. */\n    paymentGuarantee: PaywallGuarantee;\n  }\n}\n\n/**\n * Hono middleware that gates a route behind a 4Mica x402 payment.\n *\n * Returns a `402` response with the x402 payment requirements when no valid\n * `X-PAYMENT` header is present; otherwise verifies the payment, exposes the\n * guarantee via `c.get(\"paymentGuarantee\")`, runs the handler, and merges the\n * `X-PAYMENT-RESPONSE` header onto the response.\n *\n * @param verifier - `client`, `client.rpc`, or any guarantee verifier.\n * @param config - Advertised payment requirements for the protected resource.\n */\nexport function paywall(\n  verifier: PaywallVerifier,\n  config: PaywallConfig,\n): MiddlewareHandler {\n  const pw = createPaywall(verifier, config);\n  return async (c, next) => {\n    const result = await pw.handle(c.req.raw);\n    if (result instanceof Response) {\n      return result;\n    }\n    c.set(\"paymentGuarantee\", result.guarantee);\n    await next();\n    result.headers.forEach((value, key) => {\n      c.res.headers.set(key, value);\n    });\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@4mica/sdk-hono",
+  "version": "1.3.1",
+  "description": "Hono middleware 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-hono"
+  },
+  "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",
+    "hono",
+    "x402",
+    "middleware",
+    "payments"
+  ],
+  "dependencies": {
+    "@4mica/sdk": "1.3.1"
+  },
+  "peerDependencies": {
+    "hono": ">=4"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "@types/node": "^24.10.1",
+    "hono": "^4.6.0",
+    "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"
+  }
+}