@cryptonly/x402-nestjs 0.0.0-stage → 0.5.0

package/README.md

@@ -1,3 +1,134 @@
-# Temporary Holding Version
+<img src="https://raw.githubusercontent.com/cryptonly-net/.github/main/profile/assets/header-banner.svg" alt="Cryptonly" width="100%" />
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<div align="center">
+
+# Cryptonly x402 for NestJS
+
+Accept x402 payments in NestJS, with Cryptonly as the facilitator.
+
+[Website](https://cryptonly.net) · [Documentation](https://docs.cryptonly.net/guides/x402/) · [Contact](https://cryptonly.net/contact/)
+
+</div>
+
+---
+
+Cryptonly verifies and settles each payment, and pays the network fee. Payments go straight to your wallet. Mark a handler with `@X402()` and its price comes from the Cryptonly dashboard, so a price change needs no deploy. Works on the Express and the Fastify platform.
+
+You need a Cryptonly API key with the `x402.verify` and `x402.settle` scopes. The [quickstart](https://docs.cryptonly.net/guides/x402/quickstart/) covers getting one.
+
+## Install
+
+```bash
+npm install @cryptonly/x402-nestjs @x402/core @x402/evm
+```
+
+## Use
+
+Register the module once:
+
+```ts
+import { Module } from '@nestjs/common';
+import { X402Module } from '@cryptonly/x402-nestjs';
+
+@Module({
+  imports: [X402Module.forRoot({ apiKey: process.env.CRYPTONLY_API_KEY!, isGlobal: true })],
+  controllers: [WeatherController],
+})
+export class AppModule {}
+```
+
+Then mark the paid handlers:
+
+```ts
+import { Controller, Get, Param } from '@nestjs/common';
+import { X402, X402Payment, type X402VerifiedPayment } from '@cryptonly/x402-nestjs';
+
+@Controller('weather')
+export class WeatherController {
+  @X402() // priced in the dashboard as GET /weather/:city
+  @Get(':city')
+  get(@Param('city') city: string, @X402Payment() payment: X402VerifiedPayment) {
+    return { city, temperatureC: 21, paidBy: payment.payer };
+  }
+}
+```
+
+With `@nestjs/config`, use `forRootAsync`:
+
+```ts
+X402Module.forRootAsync({
+  isGlobal: true,
+  imports: [ConfigModule],
+  inject: [ConfigService],
+  useFactory: (config: ConfigService) => ({ apiKey: config.getOrThrow('CRYPTONLY_API_KEY') }),
+});
+```
+
+## How it works
+
+- **Only `@X402()` routes are paid.** Put it on a handler, or on a controller to cover all its handlers. A route without it is served for free, even if the dashboard prices it.
+- **Price in the dashboard.** The handler's method and path must match a dashboard endpoint. Price the full public path, including any `setGlobalPrefix()` or version prefix.
+- **Fails closed.**
+  - An `@X402()` route the dashboard doesn't price answers `503` (`x402_route_unpriced`).
+  - Until the prices first load, paid routes answer `503` with `Retry-After`.
+  - At startup, and on each price change, the module logs a warning for each mismatch between the dashboard and the handlers.
+- **Order.** Guards run first, then the payment check, then pipes and the handler. A request your auth guard rejects is never asked to pay.
+- **Charging.** The payment is verified before the handler and settled after it returns. An exception, including a `ValidationPipe` error, cancels it, so the buyer isn't charged.
+- **`@X402Payment()`** gives the verified payment: `payer`, `network`, `amount`, `asset`, `payTo`. It is verified but not yet settled.
+
+## Price in code
+
+Pass a stock `@x402/core` route config to `@X402()`. That route then needs no dashboard price:
+
+```ts
+@X402({
+  accepts: { scheme: 'exact', price: '$0.01', network: 'eip155:8453', payTo: process.env.PAY_TO! },
+  description: 'Current weather',
+})
+@Get('now')
+now() {
+  return { temperatureC: 21 };
+}
+```
+
+`payTo` must be a wallet you added in the dashboard.
+
+## Options
+
+| Option | Default | |
+| --- | --- | --- |
+| `apiKey` | required | Your Cryptonly API key. |
+| `sandbox` | `false` | Use the sandbox. |
+| `baseUrl` | production | Another API origin. Takes precedence over `sandbox`. |
+| `refreshIntervalMs` | `60000` | How often to reload prices. `0` turns it off. |
+| `retryAfterMs` | `5000` | After a failed first load, how long to answer `503` before the next try. |
+| `schemes` | `[new ExactEvmScheme()]` | Schemes for Base. |
+| `svmSchemes` | `[new ExactSvmScheme()]` if `@x402/svm` is installed | Schemes for Solana. |
+| `logger` | Nest `Logger` | Gets reload failures and skipped routes. |
+| `waitForConfig` | `false` | Load the prices during bootstrap, so a bad key fails startup. When `false`, they load on the first paid request. |
+| `isGlobal` | `false` | Make the module global, so any module's controllers can use `@X402()`. |
+
+Inject `X402Service` for `ready()`, `refresh()`, `routes()` and the `facilitator` client.
+
+## Not supported
+
+- Handlers that take `@Res()` without `passthrough: true`: the payment can't be settled before the response is sent.
+- The HTML paywall for browsers. Paid routes answer `402` with JSON, for x402 clients.
+
+## Solana
+
+Install `@x402/svm` and `@solana/kit`, and add a Solana payout wallet in the dashboard. Solana prices then work with no other change.
+
+## Sandbox
+
+Pass `sandbox: true` and use a key from your [sandbox account](https://docs.cryptonly.net/guides/sandbox-environment/). The sandbox settles on Base Sepolia (`eip155:84532`) and Solana Devnet.
+
+## Learn more
+
+- [x402 quickstart](https://docs.cryptonly.net/guides/x402/quickstart/)
+- [Discovery](https://docs.cryptonly.net/guides/x402/discovery/): list your endpoints for AI agents
+- [Reference](https://docs.cryptonly.net/guides/x402/reference/): key scopes, limits and reason codes
+
+## License
+
+[MIT](https://github.com/cryptonly-net/x402/blob/main/LICENSE)

package/dist/decorators.d.ts

@@ -0,0 +1,36 @@
+import type { RouteConfig } from '@x402/core/server';
+import type { PaymentPayload, PaymentRequirements } from '@x402/core/types';
+/** What {@link X402} stores on a handler or controller. */
+export type X402RouteMetadata = {
+    /** The price in code; without it the price comes from the dashboard. */
+    route?: RouteConfig;
+};
+/**
+ * Requires an x402 payment for a handler, or for every handler of a
+ * controller.
+ *
+ * - `@X402()`: the price comes from the dashboard resource with the same
+ *   method and path. A route the dashboard doesn't price answers 503.
+ * - `@X402({ accepts: { scheme, price, network, payTo } })`: the price is
+ *   in code, as a stock `@x402/core` `RouteConfig`.
+ *
+ * The payment is verified before the handler runs and settled after it
+ * succeeds. An exception, including a validation error, cancels it.
+ */
+export declare function X402(route?: RouteConfig): ClassDecorator & MethodDecorator;
+/** The payment of a request, as verified before the handler. Not yet settled. */
+export type X402VerifiedPayment = {
+    /** The paying wallet, as the facilitator verified it. */
+    payer?: string;
+    scheme: string;
+    network: string;
+    /** Atomic units of {@link asset}. */
+    amount: string;
+    asset: string;
+    payTo: string;
+    payload: PaymentPayload;
+    requirements: PaymentRequirements;
+};
+/** Injects the {@link X402VerifiedPayment} of the request into an `@X402()` handler. */
+export declare const X402Payment: (...dataOrPipes: unknown[]) => ParameterDecorator;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAI5E,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,wEAAwE;IACxE,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,cAAc,GAAG,eAAe,CAK1E;AAED,iFAAiF;AACjF,MAAM,MAAM,mBAAmB,GAAG;IAChC,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,mBAAmB,CAAC;CACnC,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,WAAW,mDAGvB,CAAC"}

package/dist/decorators.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X402Payment = void 0;
+exports.X402 = X402;
+const common_1 = require("@nestjs/common");
+const x402_options_js_1 = require("./x402.options.js");
+const x402_interceptor_js_1 = require("./x402.interceptor.js");
+/**
+ * Requires an x402 payment for a handler, or for every handler of a
+ * controller.
+ *
+ * - `@X402()`: the price comes from the dashboard resource with the same
+ *   method and path. A route the dashboard doesn't price answers 503.
+ * - `@X402({ accepts: { scheme, price, network, payTo } })`: the price is
+ *   in code, as a stock `@x402/core` `RouteConfig`.
+ *
+ * The payment is verified before the handler runs and settled after it
+ * succeeds. An exception, including a validation error, cancels it.
+ */
+function X402(route) {
+    return (0, common_1.applyDecorators)((0, common_1.SetMetadata)(x402_options_js_1.X402_ROUTE_METADATA, { route }), (0, common_1.UseInterceptors)(x402_interceptor_js_1.X402Interceptor));
+}
+/** Injects the {@link X402VerifiedPayment} of the request into an `@X402()` handler. */
+exports.X402Payment = (0, common_1.createParamDecorator)((_data, context) => context.switchToHttp().getRequest()[x402_options_js_1.X402_PAYMENT]);
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":";;;AA8BA,oBAKC;AAnCD,2CAMwB;AAGxB,uDAAsE;AACtE,+DAAwD;AAQxD;;;;;;;;;;;GAWG;AACH,SAAgB,IAAI,CAAC,KAAmB;IACtC,OAAO,IAAA,wBAAe,EACpB,IAAA,oBAAW,EAAC,qCAAmB,EAAE,EAAE,KAAK,EAA8B,CAAC,EACvE,IAAA,wBAAe,EAAC,qCAAe,CAAC,CACjC,CAAC;AACJ,CAAC;AAgBD,wFAAwF;AAC3E,QAAA,WAAW,GAAG,IAAA,6BAAoB,EAC7C,CAAC,KAAc,EAAE,OAAyB,EAAmC,EAAE,CAC7E,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC,8BAAY,CAAC,CACpD,CAAC"}

package/dist/exceptions.d.ts

@@ -0,0 +1,10 @@
+import { HttpException } from '@nestjs/common';
+/**
+ * Thrown for a request that needs payment, or whose payment failed. The
+ * `PAYMENT-REQUIRED` header is already on the response, so the default
+ * exception filter, or yours, sends it with this body and status.
+ */
+export declare class X402PaymentRequiredException extends HttpException {
+    constructor(body?: unknown, status?: number);
+}
+//# sourceMappingURL=exceptions.d.ts.map

package/dist/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../src/exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAc,MAAM,gBAAgB,CAAC;AAE3D;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,aAAa;gBACjD,IAAI,GAAE,OAAY,EAAE,MAAM,GAAE,MAAoC;CAG7E"}

package/dist/exceptions.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X402PaymentRequiredException = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Thrown for a request that needs payment, or whose payment failed. The
+ * `PAYMENT-REQUIRED` header is already on the response, so the default
+ * exception filter, or yours, sends it with this body and status.
+ */
+class X402PaymentRequiredException extends common_1.HttpException {
+    constructor(body = {}, status = common_1.HttpStatus.PAYMENT_REQUIRED) {
+        super((body ?? {}), status);
+    }
+}
+exports.X402PaymentRequiredException = X402PaymentRequiredException;
+//# sourceMappingURL=exceptions.js.map

package/dist/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../src/exceptions.ts"],"names":[],"mappings":";;;AAAA,2CAA2D;AAE3D;;;;GAIG;AACH,MAAa,4BAA6B,SAAQ,sBAAa;IAC7D,YAAY,OAAgB,EAAE,EAAE,SAAiB,mBAAU,CAAC,gBAAgB;QAC1E,KAAK,CAAC,CAAC,IAAI,IAAI,EAAE,CAA4B,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;CACF;AAJD,oEAIC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { X402, X402Payment } from './decorators.js';
+export type { X402RouteMetadata, X402VerifiedPayment } from './decorators.js';
+export { X402PaymentRequiredException } from './exceptions.js';
+export { X402Interceptor } from './x402.interceptor.js';
+export { X402Module } from './x402.module.js';
+export { X402_MODULE_OPTIONS, X402_PAYMENT, X402_ROUTE_METADATA, } from './x402.options.js';
+export type { X402ModuleOptions } from './x402.options.js';
+export { X402Service } from './x402.service.js';
+export { fetchX402Config, routesFromConfig } from '@cryptonly/x402';
+export type { X402Config } from '@cryptonly/x402';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routesFromConfig = exports.fetchX402Config = exports.X402Service = exports.X402_ROUTE_METADATA = exports.X402_PAYMENT = exports.X402_MODULE_OPTIONS = exports.X402Module = exports.X402Interceptor = exports.X402PaymentRequiredException = exports.X402Payment = exports.X402 = void 0;
+var decorators_js_1 = require("./decorators.js");
+Object.defineProperty(exports, "X402", { enumerable: true, get: function () { return decorators_js_1.X402; } });
+Object.defineProperty(exports, "X402Payment", { enumerable: true, get: function () { return decorators_js_1.X402Payment; } });
+var exceptions_js_1 = require("./exceptions.js");
+Object.defineProperty(exports, "X402PaymentRequiredException", { enumerable: true, get: function () { return exceptions_js_1.X402PaymentRequiredException; } });
+var x402_interceptor_js_1 = require("./x402.interceptor.js");
+Object.defineProperty(exports, "X402Interceptor", { enumerable: true, get: function () { return x402_interceptor_js_1.X402Interceptor; } });
+var x402_module_js_1 = require("./x402.module.js");
+Object.defineProperty(exports, "X402Module", { enumerable: true, get: function () { return x402_module_js_1.X402Module; } });
+var x402_options_js_1 = require("./x402.options.js");
+Object.defineProperty(exports, "X402_MODULE_OPTIONS", { enumerable: true, get: function () { return x402_options_js_1.X402_MODULE_OPTIONS; } });
+Object.defineProperty(exports, "X402_PAYMENT", { enumerable: true, get: function () { return x402_options_js_1.X402_PAYMENT; } });
+Object.defineProperty(exports, "X402_ROUTE_METADATA", { enumerable: true, get: function () { return x402_options_js_1.X402_ROUTE_METADATA; } });
+var x402_service_js_1 = require("./x402.service.js");
+Object.defineProperty(exports, "X402Service", { enumerable: true, get: function () { return x402_service_js_1.X402Service; } });
+var x402_1 = require("@cryptonly/x402");
+Object.defineProperty(exports, "fetchX402Config", { enumerable: true, get: function () { return x402_1.fetchX402Config; } });
+Object.defineProperty(exports, "routesFromConfig", { enumerable: true, get: function () { return x402_1.routesFromConfig; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAAoD;AAA3C,qGAAA,IAAI,OAAA;AAAE,4GAAA,WAAW,OAAA;AAE1B,iDAA+D;AAAtD,6HAAA,4BAA4B,OAAA;AACrC,6DAAwD;AAA/C,sHAAA,eAAe,OAAA;AACxB,mDAA8C;AAArC,4GAAA,UAAU,OAAA;AACnB,qDAI2B;AAHzB,sHAAA,mBAAmB,OAAA;AACnB,+GAAA,YAAY,OAAA;AACZ,sHAAA,mBAAmB,OAAA;AAGrB,qDAAgD;AAAvC,8GAAA,WAAW,OAAA;AACpB,wCAAoE;AAA3D,uGAAA,eAAe,OAAA;AAAE,wGAAA,gBAAgB,OAAA"}

package/dist/request-adapter.d.ts

@@ -0,0 +1,45 @@
+import type { HTTPAdapter, HTTPRequestContext } from '@x402/core/server';
+/** What the Express and Fastify request objects have in common. */
+export type PlatformRequest = {
+    method: string;
+    url: string;
+    headers: Record<string, string | string[] | undefined>;
+    query?: unknown;
+    body?: unknown;
+    protocol?: string;
+    /** Express only. */
+    path?: string;
+    /** Express only. */
+    originalUrl?: string;
+};
+/** What the Express response and the Fastify reply have in common. */
+export type PlatformResponse = {
+    statusCode: number;
+    header(name: string, value: string): unknown;
+    getHeader(name: string): unknown;
+    getHeaders(): Record<string, unknown>;
+    removeHeader(name: string): unknown;
+};
+/** `@x402/core`'s view of a request on either Nest platform. */
+export declare class NestRequestAdapter implements HTTPAdapter {
+    private readonly req;
+    constructor(req: PlatformRequest);
+    getHeader(name: string): string | undefined;
+    getMethod(): string;
+    getPath(): string;
+    getUrl(): string;
+    getAcceptHeader(): string;
+    getUserAgent(): string;
+    getQueryParams(): Record<string, string | string[]>;
+    getQueryParam(name: string): string | string[] | undefined;
+    getBody(): unknown;
+}
+/** The `@x402/core` request context of a Nest request. */
+export declare function requestContextOf(req: PlatformRequest): HTTPRequestContext;
+/** Sets each header on the response. */
+export declare function setHeaders(res: PlatformResponse, headers: Record<string, string>): void;
+/** The response's headers as strings. */
+export declare function headersOf(res: PlatformResponse): Record<string, string>;
+/** A header's value as a string, or `null` when unset. */
+export declare function headerOf(res: PlatformResponse, name: string): string | null;
+//# sourceMappingURL=request-adapter.d.ts.map

package/dist/request-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-adapter.d.ts","sourceRoot":"","sources":["../src/request-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACrC,CAAC;AAEF,gEAAgE;AAChE,qBAAa,kBAAmB,YAAW,WAAW;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,eAAe;IAEjD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK3C,SAAS,IAAI,MAAM;IAInB,OAAO,IAAI,MAAM;IAIjB,MAAM,IAAI,MAAM;IAKhB,eAAe,IAAI,MAAM;IAIzB,YAAY,IAAI,MAAM;IAItB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAInD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAI1D,OAAO,IAAI,OAAO;CAGnB;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB,CAgBzE;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEvF;AAED,yCAAyC;AACzC,wBAAgB,SAAS,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMvE;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3E"}

package/dist/request-adapter.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NestRequestAdapter = void 0;
+exports.requestContextOf = requestContextOf;
+exports.setHeaders = setHeaders;
+exports.headersOf = headersOf;
+exports.headerOf = headerOf;
+/** `@x402/core`'s view of a request on either Nest platform. */
+class NestRequestAdapter {
+    req;
+    constructor(req) {
+        this.req = req;
+    }
+    getHeader(name) {
+        const value = this.req.headers[name.toLowerCase()];
+        return Array.isArray(value) ? value[0] : value;
+    }
+    getMethod() {
+        return this.req.method;
+    }
+    getPath() {
+        return this.req.path ?? this.req.url.split('?')[0];
+    }
+    getUrl() {
+        const protocol = this.req.protocol ?? 'http';
+        return `${protocol}://${this.getHeader('host') ?? ''}${this.req.originalUrl ?? this.req.url}`;
+    }
+    getAcceptHeader() {
+        return this.getHeader('accept') ?? '';
+    }
+    getUserAgent() {
+        return this.getHeader('user-agent') ?? '';
+    }
+    getQueryParams() {
+        return (this.req.query ?? {});
+    }
+    getQueryParam(name) {
+        return this.getQueryParams()[name];
+    }
+    getBody() {
+        return this.req.body;
+    }
+}
+exports.NestRequestAdapter = NestRequestAdapter;
+/** The `@x402/core` request context of a Nest request. */
+function requestContextOf(req) {
+    const adapter = new NestRequestAdapter(req);
+    const path = adapter.getPath();
+    let decodedPath = path;
+    try {
+        decodedPath = decodeURIComponent(path);
+    }
+    catch {
+        // Keep the raw path; route matching then fails closed.
+    }
+    return {
+        adapter,
+        path,
+        decodedPath,
+        method: req.method,
+        paymentHeader: adapter.getHeader('payment-signature') ?? adapter.getHeader('x-payment'),
+    };
+}
+/** Sets each header on the response. */
+function setHeaders(res, headers) {
+    for (const [name, value] of Object.entries(headers))
+        res.header(name, String(value));
+}
+/** The response's headers as strings. */
+function headersOf(res) {
+    const headers = {};
+    for (const [name, value] of Object.entries(res.getHeaders())) {
+        if (value != null)
+            headers[name] = String(value);
+    }
+    return headers;
+}
+/** A header's value as a string, or `null` when unset. */
+function headerOf(res, name) {
+    const value = res.getHeader(name);
+    return value == null ? null : String(value);
+}
+//# sourceMappingURL=request-adapter.js.map

package/dist/request-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-adapter.js","sourceRoot":"","sources":["../src/request-adapter.ts"],"names":[],"mappings":";;;AAqEA,4CAgBC;AAGD,gCAEC;AAGD,8BAMC;AAGD,4BAGC;AAhFD,gEAAgE;AAChE,MAAa,kBAAkB;IACA;IAA7B,YAA6B,GAAoB;QAApB,QAAG,GAAH,GAAG,CAAiB;IAAG,CAAC;IAErD,SAAS,CAAC,IAAY;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACjD,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IACzB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,MAAM;QACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC;QAC7C,OAAO,GAAG,QAAQ,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;IAChG,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,cAAc;QACZ,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAsC,CAAC;IACrE,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;CACF;AAxCD,gDAwCC;AAED,0DAA0D;AAC1D,SAAgB,gBAAgB,CAAC,GAAoB;IACnD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAC/B,IAAI,WAAW,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC;QACH,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;IACzD,CAAC;IACD,OAAO;QACL,OAAO;QACP,IAAI;QACJ,WAAW;QACX,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC;KACxF,CAAC;AACJ,CAAC;AAED,wCAAwC;AACxC,SAAgB,UAAU,CAAC,GAAqB,EAAE,OAA+B;IAC/E,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,yCAAyC;AACzC,SAAgB,SAAS,CAAC,GAAqB;IAC7C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;QAC7D,IAAI,KAAK,IAAI,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0DAA0D;AAC1D,SAAgB,QAAQ,CAAC,GAAqB,EAAE,IAAY;IAC1D,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/dist/x402.interceptor.d.ts

@@ -0,0 +1,21 @@
+import { type CallHandler, type ExecutionContext, type NestInterceptor } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { type Observable } from 'rxjs';
+import { X402Service } from './x402.service.js';
+/**
+ * Gates an `@X402()` handler: verifies the payment before the handler and
+ * settles it after the handler succeeds. Added by {@link X402}; it does
+ * nothing on handlers without it.
+ */
+export declare class X402Interceptor implements NestInterceptor {
+    private readonly x402;
+    private readonly reflector;
+    constructor(x402: X402Service, reflector: Reflector);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+    private verify;
+    private settleAfter;
+    private settle;
+    private cancel;
+    private facilitatorFailure;
+}
+//# sourceMappingURL=x402.interceptor.d.ts.map

package/dist/x402.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.interceptor.d.ts","sourceRoot":"","sources":["../src/x402.interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAUzC,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAY/E,OAAO,EAAE,WAAW,EAAuB,MAAM,mBAAmB,CAAC;AAWrE;;;;GAIG;AACH,qBACa,eAAgB,YAAW,eAAe;IAEnD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,SAAS;IAGvC,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;YAgB9D,MAAM;IA0DpB,OAAO,CAAC,WAAW;YAsBL,MAAM;YAqCN,MAAM;IAsBpB,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/x402.interceptor.js

@@ -0,0 +1,182 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X402Interceptor = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const server_1 = require("@x402/core/server");
+const x402_1 = require("@cryptonly/x402");
+const rxjs_1 = require("rxjs");
+const exceptions_js_1 = require("./exceptions.js");
+const request_adapter_js_1 = require("./request-adapter.js");
+const x402_options_js_1 = require("./x402.options.js");
+const x402_service_js_1 = require("./x402.service.js");
+/**
+ * Gates an `@X402()` handler: verifies the payment before the handler and
+ * settles it after the handler succeeds. Added by {@link X402}; it does
+ * nothing on handlers without it.
+ */
+let X402Interceptor = class X402Interceptor {
+    x402;
+    reflector;
+    constructor(x402, reflector) {
+        this.x402 = x402;
+        this.reflector = reflector;
+    }
+    intercept(context, next) {
+        if (context.getType() !== 'http')
+            return next.handle();
+        const meta = this.reflector.getAllAndOverride(x402_options_js_1.X402_ROUTE_METADATA, [context.getHandler(), context.getClass()]);
+        if (!meta)
+            return next.handle();
+        const http = context.switchToHttp();
+        const req = http.getRequest();
+        const res = http.getResponse();
+        return (0, rxjs_1.from)(this.verify(context, meta, req, res)).pipe((0, rxjs_1.mergeMap)((pending) => (pending ? this.settleAfter(pending, res, next) : next.handle())));
+    }
+    async verify(context, meta, req, res) {
+        let server;
+        if (meta.route) {
+            server = this.x402.inCodeServer(context.getHandler(), meta.route);
+        }
+        else {
+            server = await this.x402.dashboardServer();
+            if (!server) {
+                res.header('Retry-After', String(Math.ceil(this.x402.retryAfterMs / 1000)));
+                throw new common_1.ServiceUnavailableException(x402_1.X402_CONFIG_UNAVAILABLE);
+            }
+        }
+        const request = (0, request_adapter_js_1.requestContextOf)(req);
+        if (!server.httpServer.requiresPayment(request)) {
+            // Fail closed: a paid handler is never served for free.
+            this.x402.warnUnpriced(request.method, request.path);
+            throw new common_1.ServiceUnavailableException({
+                error: 'x402_route_unpriced',
+                message: 'This endpoint has no price yet; retry later.',
+            });
+        }
+        let result;
+        try {
+            await server.prepare();
+            result = await server.httpServer.processHTTPRequest(request);
+        }
+        catch (error) {
+            throw this.facilitatorFailure(error);
+        }
+        switch (result.type) {
+            case 'no-payment-required':
+                return undefined;
+            case 'payment-error':
+                (0, request_adapter_js_1.setHeaders)(res, result.response.headers);
+                throw new exceptions_js_1.X402PaymentRequiredException(result.response.body, result.response.status);
+            case 'payment-verified': {
+                const { paymentPayload, paymentRequirements } = result;
+                req[x402_options_js_1.X402_PAYMENT] = {
+                    payer: server.payerOf(paymentPayload) ?? payerFromPayload(paymentPayload.payload),
+                    scheme: paymentRequirements.scheme,
+                    network: paymentRequirements.network,
+                    amount: paymentRequirements.amount,
+                    asset: paymentRequirements.asset,
+                    payTo: paymentRequirements.payTo,
+                    payload: paymentPayload,
+                    requirements: paymentRequirements,
+                };
+                return { server, request, result };
+            }
+        }
+    }
+    settleAfter(pending, res, next) {
+        let settled = false;
+        return next.handle().pipe(
+        // Exceptions from pipes (validation) and the handler: no charge.
+        (0, rxjs_1.catchError)((error) => (0, rxjs_1.from)(this.cancel(pending, res, { reason: 'handler_threw', error })).pipe((0, rxjs_1.mergeMap)(() => (0, rxjs_1.throwError)(() => error)))), (0, rxjs_1.mergeMap)(async (body) => {
+            if (settled)
+                return body;
+            settled = true;
+            await this.settle(pending, res, body);
+            return body;
+        }));
+    }
+    async settle(pending, res, body) {
+        const { server, request, result } = pending;
+        // Set when a handler with `@Res({ passthrough: true })` chose an error status.
+        if (res.statusCode >= 400) {
+            await this.cancel(pending, res, { reason: 'handler_failed', responseStatus: res.statusCode });
+            return;
+        }
+        try {
+            const settlement = await server.httpServer.processSettlement(result.paymentPayload, result.paymentRequirements, result.declaredExtensions, { request, responseBody: bodyBuffer(body), responseHeaders: (0, request_adapter_js_1.headersOf)(res) }, undefined, result.beforeHandlerSettlement);
+            res.removeHeader(server_1.SETTLEMENT_OVERRIDES_HEADER);
+            if (!settlement.success) {
+                (0, request_adapter_js_1.setHeaders)(res, settlement.response.headers);
+                throw new exceptions_js_1.X402PaymentRequiredException(settlement.response.body, settlement.response.status);
+            }
+            (0, request_adapter_js_1.setHeaders)(res, settlement.headers);
+            res.header('Cache-Control', (0, server_1.withPrivateCacheControl)((0, request_adapter_js_1.headerOf)(res, 'Cache-Control')));
+        }
+        catch (error) {
+            res.removeHeader(server_1.SETTLEMENT_OVERRIDES_HEADER);
+            if (error instanceof common_1.HttpException)
+                throw error;
+            if (error instanceof server_1.FacilitatorResponseError) {
+                throw new common_1.BadGatewayException({ error: error.message });
+            }
+            this.x402.logger.error(`${x402_1.X402_LOG_PREFIX} settlement failed: ${(0, x402_1.describeError)(error)}`);
+            throw new exceptions_js_1.X402PaymentRequiredException({});
+        }
+    }
+    async cancel(pending, res, options) {
+        const { server, result } = pending;
+        try {
+            const canceled = await result.cancellationDispatcher.cancel(options);
+            res.removeHeader(server_1.SETTLEMENT_OVERRIDES_HEADER);
+            const headers = server.httpServer.createFailurePathSettlementHeaders(canceled, result.beforeHandlerSettlement, result.paymentPayload, (0, request_adapter_js_1.headerOf)(res, 'Cache-Control'));
+            if (headers)
+                (0, request_adapter_js_1.setHeaders)(res, headers);
+        }
+        catch (error) {
+            // The handler's own error is the one to answer with.
+            this.x402.logger.error(`${x402_1.X402_LOG_PREFIX} cancelling a payment failed: ${(0, x402_1.describeError)(error)}`);
+        }
+    }
+    facilitatorFailure(error) {
+        if (error instanceof common_1.HttpException)
+            return error;
+        if (error instanceof server_1.FacilitatorResponseError) {
+            return new common_1.BadGatewayException({ error: error.message });
+        }
+        this.x402.logger.error(`${x402_1.X402_LOG_PREFIX} payment processing failed: ${(0, x402_1.describeError)(error)}`);
+        return new common_1.InternalServerErrorException();
+    }
+};
+exports.X402Interceptor = X402Interceptor;
+exports.X402Interceptor = X402Interceptor = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [x402_service_js_1.X402Service,
+        core_1.Reflector])
+], X402Interceptor);
+/** The handler's result as the bytes the settlement sees. */
+function bodyBuffer(body) {
+    if (body === undefined || body === null || body instanceof common_1.StreamableFile) {
+        return Buffer.alloc(0);
+    }
+    if (Buffer.isBuffer(body))
+        return body;
+    return Buffer.from(typeof body === 'string' ? body : JSON.stringify(body));
+}
+/** The `from` of an EVM authorization or Permit2 payload, when the facilitator gave no payer. */
+function payerFromPayload(payload) {
+    const authorization = payload.authorization;
+    const permit2 = payload.permit2Authorization;
+    const from = authorization?.from ?? permit2?.from;
+    return typeof from === 'string' ? from : undefined;
+}
+//# sourceMappingURL=x402.interceptor.js.map

package/dist/x402.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.interceptor.js","sourceRoot":"","sources":["../src/x402.interceptor.ts"],"names":[],"mappings":"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"}

package/dist/x402.module.d.ts

@@ -0,0 +1,18 @@
+import { X402ConfigurableModule } from './x402.options.js';
+/**
+ * x402 payments with Cryptonly as the facilitator. Register it once, then
+ * mark paid handlers with `@X402()`.
+ *
+ * @example
+ * ```ts
+ * @Module({
+ *   imports: [
+ *     X402Module.forRoot({ apiKey: process.env.CRYPTONLY_API_KEY!, isGlobal: true }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare class X402Module extends X402ConfigurableModule {
+}
+//# sourceMappingURL=x402.module.d.ts.map

package/dist/x402.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.module.d.ts","sourceRoot":"","sources":["../src/x402.module.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAG3D;;;;;;;;;;;;;GAaG;AACH,qBAKa,UAAW,SAAQ,sBAAsB;CAAG"}

package/dist/x402.module.js

@@ -0,0 +1,39 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X402Module = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const x402_interceptor_js_1 = require("./x402.interceptor.js");
+const x402_options_js_1 = require("./x402.options.js");
+const x402_service_js_1 = require("./x402.service.js");
+/**
+ * x402 payments with Cryptonly as the facilitator. Register it once, then
+ * mark paid handlers with `@X402()`.
+ *
+ * @example
+ * ```ts
+ * @Module({
+ *   imports: [
+ *     X402Module.forRoot({ apiKey: process.env.CRYPTONLY_API_KEY!, isGlobal: true }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+let X402Module = class X402Module extends x402_options_js_1.X402ConfigurableModule {
+};
+exports.X402Module = X402Module;
+exports.X402Module = X402Module = __decorate([
+    (0, common_1.Module)({
+        imports: [core_1.DiscoveryModule],
+        providers: [x402_service_js_1.X402Service, x402_interceptor_js_1.X402Interceptor],
+        exports: [x402_service_js_1.X402Service, x402_interceptor_js_1.X402Interceptor],
+    })
+], X402Module);
+//# sourceMappingURL=x402.module.js.map

package/dist/x402.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.module.js","sourceRoot":"","sources":["../src/x402.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,uCAA+C;AAC/C,+DAAwD;AACxD,uDAA2D;AAC3D,uDAAgD;AAEhD;;;;;;;;;;;;;GAaG;AAMI,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,wCAAsB;CAAG,CAAA;AAA5C,gCAAU;qBAAV,UAAU;IALtB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,sBAAe,CAAC;QAC1B,SAAS,EAAE,CAAC,6BAAW,EAAE,qCAAe,CAAC;QACzC,OAAO,EAAE,CAAC,6BAAW,EAAE,qCAAe,CAAC;KACxC,CAAC;GACW,UAAU,CAAkC"}

package/dist/x402.options.d.ts

@@ -0,0 +1,37 @@
+import type { X402RouteSourceOptions } from '@cryptonly/x402';
+/** Options for `X402Module.forRoot()` and `forRootAsync()`. */
+export type X402ModuleOptions = X402RouteSourceOptions & {
+    /**
+     * Await the dashboard configuration during application bootstrap, so a bad
+     * key or an inactive account fails startup. Defaults to `false`: it loads
+     * on the first paid request, which answers 503 until it does.
+     */
+    waitForConfig?: boolean;
+};
+export declare const X402ConfigurableModule: import("@nestjs/common").ConfigurableModuleCls<X402ModuleOptions, "forRoot", "create", {
+    isGlobal: boolean;
+}>, X402_MODULE_OPTIONS: string | symbol, X402_OPTIONS_TYPE: import("@cryptonly/x402").CryptonlyFacilitatorConfig & {
+    refreshIntervalMs?: number;
+    schemes?: readonly import("@x402/core/types").SchemeNetworkServer[];
+    svmSchemes?: readonly import("@x402/core/types").SchemeNetworkServer[];
+    fetch?: typeof fetch;
+    retryAfterMs?: number;
+    logger?: import("@cryptonly/x402").X402Logger;
+    extensions?: import("@cryptonly/x402").X402ExtensionsModule | null;
+} & {
+    /**
+     * Await the dashboard configuration during application bootstrap, so a bad
+     * key or an inactive account fails startup. Defaults to `false`: it loads
+     * on the first paid request, which answers 503 until it does.
+     */
+    waitForConfig?: boolean;
+} & Partial<{
+    isGlobal: boolean;
+}>, X402_ASYNC_OPTIONS_TYPE: import("@nestjs/common").ConfigurableModuleAsyncOptions<X402ModuleOptions, "create"> & Partial<{
+    isGlobal: boolean;
+}>;
+/** Metadata key of {@link X402} on handlers and controllers. */
+export declare const X402_ROUTE_METADATA = "cryptonly:x402:route";
+/** Where the interceptor puts the verified payment on the request. */
+export declare const X402_PAYMENT: unique symbol;
+//# sourceMappingURL=x402.options.d.ts.map

package/dist/x402.options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.options.d.ts","sourceRoot":"","sources":["../src/x402.options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,GAAG;IACvD;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,eAAO,MACoB,sBAAsB;;IACzB,mBAAmB,mBAC3B,iBAAiB;;;;;;;;;IAX/B;;;;OAIG;oBACa,OAAO;;;IAOH,uBAAuB;;EAOnC,CAAC;AAEX,gEAAgE;AAChE,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,sEAAsE;AACtE,eAAO,MAAM,YAAY,eAAuC,CAAC"}

package/dist/x402.options.js

@@ -0,0 +1,17 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X402_PAYMENT = exports.X402_ROUTE_METADATA = exports.X402_ASYNC_OPTIONS_TYPE = exports.X402_OPTIONS_TYPE = exports.X402_MODULE_OPTIONS = exports.X402ConfigurableModule = void 0;
+const common_1 = require("@nestjs/common");
+_a = new common_1.ConfigurableModuleBuilder()
+    .setClassMethodName('forRoot')
+    .setExtras({ isGlobal: false }, (definition, extras) => ({
+    ...definition,
+    global: extras.isGlobal,
+}))
+    .build(), exports.X402ConfigurableModule = _a.ConfigurableModuleClass, exports.X402_MODULE_OPTIONS = _a.MODULE_OPTIONS_TOKEN, exports.X402_OPTIONS_TYPE = _a.OPTIONS_TYPE, exports.X402_ASYNC_OPTIONS_TYPE = _a.ASYNC_OPTIONS_TYPE;
+/** Metadata key of {@link X402} on handlers and controllers. */
+exports.X402_ROUTE_METADATA = 'cryptonly:x402:route';
+/** Where the interceptor puts the verified payment on the request. */
+exports.X402_PAYMENT = Symbol.for('cryptonly.x402.payment');
+//# sourceMappingURL=x402.options.js.map

package/dist/x402.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.options.js","sourceRoot":"","sources":["../src/x402.options.ts"],"names":[],"mappings":";;;;AAAA,2CAA2D;AAa9C,KAKT,IAAI,kCAAyB,EAAqB;KACnD,kBAAkB,CAAC,SAAS,CAAC;KAC7B,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACvD,GAAG,UAAU;IACb,MAAM,EAAE,MAAM,CAAC,QAAQ;CACxB,CAAC,CAAC;KACF,KAAK,EAAE,EAViB,8BAAsB,+BACzB,2BAAmB,4BAC3B,yBAAiB,oBACX,+BAAuB,yBAOlC;AAEX,gEAAgE;AACnD,QAAA,mBAAmB,GAAG,sBAAsB,CAAC;AAE1D,sEAAsE;AACzD,QAAA,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/x402.service.d.ts

@@ -0,0 +1,61 @@
+import { type OnApplicationBootstrap, type OnModuleDestroy } from '@nestjs/common';
+import { DiscoveryService, MetadataScanner, Reflector } from '@nestjs/core';
+import { x402HTTPResourceServer, type RouteConfig, type RoutesConfig } from '@x402/core/server';
+import { type CryptonlyFacilitatorClient, type X402Logger } from '@cryptonly/x402';
+import { type X402ModuleOptions } from './x402.options.js';
+/** A resource server ready to process requests for one set of routes. */
+export type PreparedServer = {
+    readonly httpServer: x402HTTPResourceServer;
+    /** Syncs the facilitator's `/supported` once, and the bazaar extension. */
+    prepare(): Promise<void>;
+    /** The payer the facilitator verified for a payment payload. */
+    payerOf(payload: object): string | undefined;
+};
+/**
+ * The dashboard routes of the account, kept fresh, and the resource servers
+ * that `@X402()` handlers are paid through.
+ */
+export declare class X402Service implements OnApplicationBootstrap, OnModuleDestroy {
+    private readonly options;
+    private readonly discovery;
+    private readonly scanner;
+    private readonly reflector;
+    readonly logger: X402Logger;
+    private readonly source;
+    private readonly inCode;
+    private decorated;
+    private readonly warned;
+    constructor(options: X402ModuleOptions, discovery: DiscoveryService, scanner: MetadataScanner, reflector: Reflector);
+    /** The facilitator client, for calls of your own (`/verify`, `/settle`, discovery). */
+    get facilitator(): CryptonlyFacilitatorClient;
+    /** For `Retry-After` while the configuration is unavailable. */
+    get retryAfterMs(): number;
+    /**
+     * Loads the dashboard configuration now (if not loaded yet) and starts
+     * refreshing. Rejects when the first load fails.
+     */
+    ready(): Promise<void>;
+    /** Reloads the configuration now. Resolves `true` when the routes changed. */
+    refresh(): Promise<boolean>;
+    /** The dashboard routes in use, or `undefined` before the first successful load. */
+    routes(): RoutesConfig | undefined;
+    onApplicationBootstrap(): Promise<void>;
+    onModuleDestroy(): void;
+    /** The server for dashboard-priced routes, or `undefined` while the configuration is unavailable. */
+    dashboardServer(): Promise<PreparedServer | undefined>;
+    /** The server for a handler priced in code, built on first use. */
+    inCodeServer(handler: object, route: RouteConfig): PreparedServer;
+    /** Logs, once per route, that a dashboard-priced handler has no dashboard price. */
+    warnUnpriced(method: string, path: string): void;
+    private prepared;
+    /** The `@X402()` handlers, with their controller and method paths. */
+    private discoverDecorated;
+    /**
+     * Warns about mismatches between the dashboard and the `@X402()` handlers.
+     * A handler's path matches a dashboard path that ends with it, so a global
+     * prefix or a version segment is allowed for.
+     */
+    private checkRoutes;
+    private warnOnce;
+}
+//# sourceMappingURL=x402.service.d.ts.map

package/dist/x402.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.service.d.ts","sourceRoot":"","sources":["../src/x402.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAEL,sBAAsB,EAEtB,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAKL,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EAEhB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAA4C,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAErG,yEAAyE;AACzE,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,2EAA2E;IAC3E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,gEAAgE;IAChE,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC9C,CAAC;AAuBF;;;GAGG;AACH,qBACa,WAAY,YAAW,sBAAsB,EAAE,eAAe;IAQ1C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAV5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;gBAGI,OAAO,EAAE,iBAAiB,EACvD,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,SAAS;IAyBvC,uFAAuF;IACvF,IAAI,WAAW,IAAI,0BAA0B,CAE5C;IAED,gEAAgE;IAChE,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,8EAA8E;IAC9E,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,oFAAoF;IACpF,MAAM,IAAI,YAAY,GAAG,SAAS;IAI5B,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAS7C,eAAe,IAAI,IAAI;IAIvB,qGAAqG;IAC/F,eAAe,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAW5D,mEAAmE;IACnE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,cAAc;IAejE,oFAAoF;IACpF,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOhD,OAAO,CAAC,QAAQ;IA0BhB,sEAAsE;IACtE,OAAO,CAAC,iBAAiB;IA2BzB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,QAAQ;CAKjB"}

package/dist/x402.service.js

@@ -0,0 +1,257 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X402Service = void 0;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("@nestjs/common/constants");
+const core_1 = require("@nestjs/core");
+const server_1 = require("@x402/core/server");
+const x402_1 = require("@cryptonly/x402");
+const x402_options_js_1 = require("./x402.options.js");
+let bazaarModule;
+function loadBazaar() {
+    if (bazaarModule === undefined) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            bazaarModule = require('@x402/extensions/bazaar');
+        }
+        catch {
+            bazaarModule = null;
+        }
+    }
+    return bazaarModule;
+}
+/**
+ * The dashboard routes of the account, kept fresh, and the resource servers
+ * that `@X402()` handlers are paid through.
+ */
+let X402Service = class X402Service {
+    options;
+    discovery;
+    scanner;
+    reflector;
+    logger;
+    source;
+    inCode = new Map();
+    decorated;
+    warned = new Set();
+    constructor(options, discovery, scanner, reflector) {
+        this.options = options;
+        this.discovery = discovery;
+        this.scanner = scanner;
+        this.reflector = reflector;
+        const nest = new common_1.Logger('X402');
+        this.logger = options.logger ?? {
+            info: (message) => nest.log(message),
+            warn: (message) => nest.warn(message),
+            error: (message) => nest.error(message),
+        };
+        this.source = (0, x402_1.createX402RouteSource)({ ...options, logger: this.logger }, (routes, config) => {
+            const server = this.prepared((0, x402_1.createResourceServer)(config, this.source.facilitator, this.source.schemes, this.source.svmSchemes), routes);
+            // Sync `/supported` in the background, as the stock middleware does.
+            server.prepare().catch(() => { });
+            this.checkRoutes(routes);
+            return server;
+        });
+    }
+    /** The facilitator client, for calls of your own (`/verify`, `/settle`, discovery). */
+    get facilitator() {
+        return this.source.facilitator;
+    }
+    /** For `Retry-After` while the configuration is unavailable. */
+    get retryAfterMs() {
+        return this.source.retryAfterMs;
+    }
+    /**
+     * Loads the dashboard configuration now (if not loaded yet) and starts
+     * refreshing. Rejects when the first load fails.
+     */
+    ready() {
+        return this.source.ready();
+    }
+    /** Reloads the configuration now. Resolves `true` when the routes changed. */
+    refresh() {
+        return this.source.refresh();
+    }
+    /** The dashboard routes in use, or `undefined` before the first successful load. */
+    routes() {
+        return this.source.current()?.routes;
+    }
+    async onApplicationBootstrap() {
+        this.decorated = this.discoverDecorated();
+        if (this.options.waitForConfig && this.decorated.some((route) => !route.priceInCode)) {
+            await this.source.ready();
+        }
+        const current = this.source.current();
+        if (current)
+            this.checkRoutes(current.routes);
+    }
+    onModuleDestroy() {
+        this.source.close();
+    }
+    /** The server for dashboard-priced routes, or `undefined` while the configuration is unavailable. */
+    async dashboardServer() {
+        if (!this.source.current()) {
+            try {
+                await this.source.ready();
+            }
+            catch {
+                return undefined;
+            }
+        }
+        return this.source.current()?.value;
+    }
+    /** The server for a handler priced in code, built on first use. */
+    inCodeServer(handler, route) {
+        let server = this.inCode.get(handler);
+        if (!server) {
+            const resourceServer = new server_1.x402ResourceServer(this.source.facilitator);
+            const accepts = Array.isArray(route.accepts) ? route.accepts : [route.accepts];
+            for (const network of new Set(accepts.map((option) => option.network))) {
+                const schemes = (0, x402_1.isSolanaNetwork)(network) ? this.source.svmSchemes : this.source.schemes;
+                for (const scheme of schemes)
+                    resourceServer.register(network, scheme);
+            }
+            server = this.prepared(resourceServer, route);
+            this.inCode.set(handler, server);
+        }
+        return server;
+    }
+    /** Logs, once per route, that a dashboard-priced handler has no dashboard price. */
+    warnUnpriced(method, path) {
+        this.warnOnce(`${x402_1.X402_LOG_PREFIX} @X402() on ${method} ${path} has no dashboard price; ` +
+            'it answers 503 until one is added');
+    }
+    prepared(resourceServer, routes) {
+        const httpServer = new server_1.x402HTTPResourceServer(resourceServer, routes);
+        const payers = new WeakMap();
+        resourceServer.onAfterVerify(async ({ paymentPayload, result }) => {
+            if (result.payer)
+                payers.set(paymentPayload, result.payer);
+        });
+        let initialized;
+        const prepare = () => {
+            initialized ??= (async () => {
+                await httpServer.initialize();
+                if (!(0, server_1.checkIfBazaarNeeded)(routes))
+                    return;
+                const bazaar = loadBazaar();
+                if (!bazaar)
+                    return;
+                if (!resourceServer.hasExtension('bazaar')) {
+                    resourceServer.registerExtension(bazaar.bazaarResourceServerExtension);
+                }
+                bazaar.validateBazaarRouteExtensions(routes);
+            })().catch((error) => {
+                initialized = undefined;
+                throw error;
+            });
+            return initialized;
+        };
+        return { httpServer, prepare, payerOf: (payload) => payers.get(payload) };
+    }
+    /** The `@X402()` handlers, with their controller and method paths. */
+    discoverDecorated() {
+        const routes = [];
+        for (const wrapper of this.discovery.getControllers()) {
+            const { instance, metatype } = wrapper;
+            if (!instance || !metatype)
+                continue;
+            const prototype = Object.getPrototypeOf(instance);
+            const controllerPaths = asArray(Reflect.getMetadata(constants_1.PATH_METADATA, metatype) ?? '/');
+            for (const name of this.scanner.getAllMethodNames(prototype)) {
+                const handler = prototype[name];
+                const meta = this.reflector.getAllAndOverride(x402_options_js_1.X402_ROUTE_METADATA, [handler, metatype]);
+                const methodPath = Reflect.getMetadata(constants_1.PATH_METADATA, handler);
+                if (!meta || methodPath === undefined)
+                    continue;
+                const requestMethod = Reflect.getMetadata(constants_1.METHOD_METADATA, handler);
+                const method = requestMethod === common_1.RequestMethod.ALL ? '*' : common_1.RequestMethod[requestMethod];
+                for (const controllerPath of controllerPaths) {
+                    for (const path of asArray(methodPath)) {
+                        routes.push({ method, path: joinPath(controllerPath, path), priceInCode: !!meta.route });
+                    }
+                }
+            }
+        }
+        return routes;
+    }
+    /**
+     * Warns about mismatches between the dashboard and the `@X402()` handlers.
+     * A handler's path matches a dashboard path that ends with it, so a global
+     * prefix or a version segment is allowed for.
+     */
+    checkRoutes(routes) {
+        if (!this.decorated)
+            return;
+        const dashboard = Object.keys(routes).map(parseRouteKey);
+        const decorated = this.decorated.filter((route) => !route.priceInCode);
+        const serves = (handler, priced) => (handler.method === '*' || priced.method === '*' || handler.method === priced.method) &&
+            endsWithSegments(priced.path, handler.path);
+        for (const priced of dashboard) {
+            if (!decorated.some((handler) => serves(handler, priced))) {
+                this.warnOnce(`${x402_1.X402_LOG_PREFIX} the dashboard prices ${priced.method} ${priced.path}, ` +
+                    'but no @X402() handler serves it: this app serves it for free');
+            }
+        }
+        for (const handler of decorated) {
+            if (!dashboard.some((priced) => serves(handler, priced))) {
+                this.warnUnpriced(handler.method, handler.path);
+            }
+        }
+    }
+    warnOnce(message) {
+        if (this.warned.has(message))
+            return;
+        this.warned.add(message);
+        this.logger.warn(message);
+    }
+};
+exports.X402Service = X402Service;
+exports.X402Service = X402Service = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(x402_options_js_1.X402_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [Object, core_1.DiscoveryService,
+        core_1.MetadataScanner,
+        core_1.Reflector])
+], X402Service);
+function asArray(value) {
+    return Array.isArray(value) ? value : [value];
+}
+function segments(path) {
+    return path.split('/').filter(Boolean);
+}
+function joinPath(...parts) {
+    return `/${parts.flatMap(segments).join('/')}`;
+}
+/** `GET /a/b` → `{ GET, /a/b }`; a bare path matches any method. */
+function parseRouteKey(key) {
+    const [first, ...rest] = key.trim().split(/\s+/);
+    return rest.length > 0
+        ? { method: first.toUpperCase(), path: joinPath(rest.join(' ')), priceInCode: false }
+        : { method: '*', path: joinPath(first), priceInCode: false };
+}
+function endsWithSegments(path, suffix) {
+    const whole = segments(path);
+    const tail = segments(suffix);
+    if (tail.length > whole.length)
+        return false;
+    const offset = whole.length - tail.length;
+    return tail.every((segment, index) => {
+        const other = whole[offset + index];
+        // `:param` in either path matches any one segment.
+        return segment === other || segment.startsWith(':') || other.startsWith(':');
+    });
+}
+//# sourceMappingURL=x402.service.js.map

package/dist/x402.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.service.js","sourceRoot":"","sources":["../src/x402.service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,90 @@
 {
   "name": "@cryptonly/x402-nestjs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.0",
+  "description": "NestJS module and decorators for x402 payments with Cryptonly as the facilitator. Works on the Express and Fastify platforms.",
+  "license": "MIT",
+  "private": false,
+  "type": "commonjs",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cryptonly-net/x402.git",
+    "directory": "typescript/packages/x402-nestjs"
+  },
+  "homepage": "https://github.com/cryptonly-net/x402/tree/main/typescript/packages/x402-nestjs#readme",
+  "bugs": {
+    "url": "https://github.com/cryptonly-net/x402/issues"
+  },
+  "keywords": [
+    "cryptonly",
+    "x402",
+    "facilitator",
+    "payments",
+    "nestjs",
+    "nest",
+    "decorators"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "typecheck": "tsc -p tsconfig.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cryptonly/x402": "0.5.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10 || ^11",
+    "@nestjs/core": "^10 || ^11",
+    "@x402/core": "^2",
+    "@x402/evm": "^2",
+    "@x402/extensions": "^2",
+    "@x402/svm": "^2",
+    "reflect-metadata": "^0.1.13 || ^0.2",
+    "rxjs": "^7"
+  },
+  "peerDependenciesMeta": {
+    "@x402/extensions": {
+      "optional": true
+    },
+    "@x402/svm": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@x402/core": "^2.28.0",
+    "@x402/evm": "^2.28.0",
+    "@x402/extensions": "^2.28.0",
+    "@x402/svm": "^2.28.0",
+    "@nestjs/common": "11.1.11",
+    "@nestjs/core": "11.1.11",
+    "@nestjs/platform-express": "11.1.11",
+    "@nestjs/platform-fastify": "11.1.11",
+    "@nestjs/config": "^4.0.2",
+    "class-validator": "^0.14.2",
+    "class-transformer": "^0.5.1",
+    "reflect-metadata": "0.2.2",
+    "rxjs": "7.8.2"
+  }
+}