@introspectivelabs/nestjs-x402 0.1.0-beta.0

package/README.md

@@ -0,0 +1,98 @@
+# @introspectivelabs/nestjs-x402
+
+x402 Payment Protocol NestJS integration with `@Payment()` decorator support and ERC-4337 UserOperation handling.
+
+## Installation
+
+```bash
+npm install @introspectivelabs/nestjs-x402
+```
+
+### Peer Dependencies
+
+- `@introspectivelabs/x402-evm` >= 0.1.0-beta.1
+- `@nestjs/common` >= 10.0.0
+- `@nestjs/config` >= 3.0.0
+- `@nestjs/core` >= 10.0.0
+- `@x402/core` 2.*
+- `@x402/express` 2.*
+- `rxjs` >= 7.0.0
+
+## Usage
+
+### Module Setup
+
+Register the module in your app with `forRoot` or `forRootAsync`:
+
+```typescript
+import { X402Module } from "@introspectivelabs/nestjs-x402";
+
+@Module({
+  imports: [
+    X402Module.forRoot({
+      facilitatorUrl: "https://facilitator.example.com",
+      seller: {
+        address: "0xYourSellerAddress",
+        defaultConfig: {
+          network: "eip155:84532",
+          price: "$0.01",
+        },
+      },
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+Or with async configuration:
+
+```typescript
+X402Module.forRootAsync({
+  imports: [ConfigModule],
+  useFactory: (config: ConfigService) => ({
+    facilitatorUrl: config.get("FACILITATOR_URL"),
+    seller: {
+      address: config.get("SELLER_ADDRESS"),
+      defaultConfig: {
+        network: config.get("NETWORK"),
+        price: config.get("PRICE"),
+      },
+    },
+  }),
+  inject: [ConfigService],
+});
+```
+
+### @Payment() Decorator
+
+Protect any route with the `@Payment()` decorator:
+
+```typescript
+import { Controller, Get } from "@nestjs/common";
+import { Payment } from "@introspectivelabs/nestjs-x402";
+
+@Controller("api")
+export class ApiController {
+  @Get("premium")
+  @Payment({
+    accepts: {
+      price: "$0.05",
+      network: "eip155:84532",
+    },
+  })
+  getPremiumData() {
+    return { data: "premium content" };
+  }
+}
+```
+
+### How It Works
+
+1. `X402Module` registers a global interceptor that processes x402 payment headers.
+2. `PaymentDiscoveryService` scans all controllers on startup and finds `@Payment()` decorated routes.
+3. `PaymentRegistryService` stores payment configurations and merges seller defaults.
+4. `PaymentInterceptor` intercepts requests to payment-protected routes and validates x402 UserOperation payments via the facilitator.
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { X402Module, X402ModuleOptions, X402_MODULE_OPTIONS } from "./x402.module";
+export { OPTIONS_TYPE, ASYNC_OPTIONS_TYPE } from "./x402.module-definition";
+export { Payment, PaymentConfig, PaymentOption, PAYMENT_CONFIG_KEY } from "./payment.decorator";
+export { PaymentInterceptor, PaymentInterceptorConfig } from "./payment.interceptor";
+export { PaymentRegistryService, X402SellerConfig } from "./payment-registry.service";
+export { PaymentDiscoveryService } from "./payment-discovery.service";
+//# 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,UAAU,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentDiscoveryService = exports.PaymentRegistryService = exports.PaymentInterceptor = exports.PAYMENT_CONFIG_KEY = exports.Payment = exports.ASYNC_OPTIONS_TYPE = exports.OPTIONS_TYPE = exports.X402_MODULE_OPTIONS = exports.X402Module = void 0;
+var x402_module_1 = require("./x402.module");
+Object.defineProperty(exports, "X402Module", { enumerable: true, get: function () { return x402_module_1.X402Module; } });
+Object.defineProperty(exports, "X402_MODULE_OPTIONS", { enumerable: true, get: function () { return x402_module_1.X402_MODULE_OPTIONS; } });
+var x402_module_definition_1 = require("./x402.module-definition");
+Object.defineProperty(exports, "OPTIONS_TYPE", { enumerable: true, get: function () { return x402_module_definition_1.OPTIONS_TYPE; } });
+Object.defineProperty(exports, "ASYNC_OPTIONS_TYPE", { enumerable: true, get: function () { return x402_module_definition_1.ASYNC_OPTIONS_TYPE; } });
+var payment_decorator_1 = require("./payment.decorator");
+Object.defineProperty(exports, "Payment", { enumerable: true, get: function () { return payment_decorator_1.Payment; } });
+Object.defineProperty(exports, "PAYMENT_CONFIG_KEY", { enumerable: true, get: function () { return payment_decorator_1.PAYMENT_CONFIG_KEY; } });
+var payment_interceptor_1 = require("./payment.interceptor");
+Object.defineProperty(exports, "PaymentInterceptor", { enumerable: true, get: function () { return payment_interceptor_1.PaymentInterceptor; } });
+var payment_registry_service_1 = require("./payment-registry.service");
+Object.defineProperty(exports, "PaymentRegistryService", { enumerable: true, get: function () { return payment_registry_service_1.PaymentRegistryService; } });
+var payment_discovery_service_1 = require("./payment-discovery.service");
+Object.defineProperty(exports, "PaymentDiscoveryService", { enumerable: true, get: function () { return payment_discovery_service_1.PaymentDiscoveryService; } });
+//# 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,6CAAmF;AAA1E,yGAAA,UAAU,OAAA;AAAqB,kHAAA,mBAAmB,OAAA;AAC3D,mEAA4E;AAAnE,sHAAA,YAAY,OAAA;AAAE,4HAAA,kBAAkB,OAAA;AACzC,yDAAgG;AAAvF,4GAAA,OAAO,OAAA;AAAgC,uHAAA,kBAAkB,OAAA;AAClE,6DAAqF;AAA5E,yHAAA,kBAAkB,OAAA;AAC3B,uEAAsF;AAA7E,kIAAA,sBAAsB,OAAA;AAC/B,yEAAsE;AAA7D,oIAAA,uBAAuB,OAAA"}

package/dist/payment-discovery.service.d.ts

@@ -0,0 +1,61 @@
+import { OnModuleInit } from "@nestjs/common";
+import { DiscoveryService, MetadataScanner, Reflector } from "@nestjs/core";
+import { PaymentRegistryService } from "./payment-registry.service";
+/**
+ * Service that auto-discovers @Payment() decorated routes on module initialization.
+ */
+export declare class PaymentDiscoveryService implements OnModuleInit {
+    private readonly discoveryService;
+    private readonly metadataScanner;
+    private readonly reflector;
+    private readonly paymentRegistry;
+    /**
+     * Creates the discovery service with required NestJS internals.
+     *
+     * @param discoveryService - NestJS provider discovery service
+     * @param metadataScanner - NestJS metadata scanner
+     * @param reflector - NestJS reflector for reading metadata
+     * @param paymentRegistry - payment registry to register discovered routes
+     */
+    constructor(discoveryService: DiscoveryService, metadataScanner: MetadataScanner, reflector: Reflector, paymentRegistry: PaymentRegistryService);
+    /**
+     * Lifecycle hook that triggers route discovery on module init.
+     */
+    onModuleInit(): void;
+    /**
+     * Scans all controllers and registers payment-decorated routes.
+     */
+    private discoverPaymentConfigs;
+    /**
+     * Extract the controller base path from metadata.
+     *
+     * @param metatype - the controller class
+     * @returns the controller path string
+     */
+    private getControllerPath;
+    /**
+     * Extract the route path from a handler method's metadata.
+     *
+     * @param instance - the controller instance
+     * @param methodName - the handler method name
+     * @returns the route path or null
+     */
+    private getRoutePath;
+    /**
+     * Extract the HTTP method from a handler method's metadata.
+     *
+     * @param instance - the controller instance
+     * @param methodName - the handler method name
+     * @returns the HTTP method string
+     */
+    private getHttpMethod;
+    /**
+     * Combine a controller path and route path into a full path.
+     *
+     * @param controllerPath - the controller base path
+     * @param routePath - the route method path
+     * @returns the combined full path
+     */
+    private combinePaths;
+}
+//# sourceMappingURL=payment-discovery.service.d.ts.map

package/dist/payment-discovery.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-discovery.service.d.ts","sourceRoot":"","sources":["../src/payment-discovery.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAuB,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAIpE;;GAEG;AACH,qBACa,uBAAwB,YAAW,YAAY;IAUxD,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAZlC;;;;;;;OAOG;gBAEgB,gBAAgB,EAAE,gBAAgB,EAClC,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,sBAAsB;IAG1D;;OAEG;IACH,YAAY;IAIZ;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwB9B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAKpB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;CAUrB"}

package/dist/payment-discovery.service.js

@@ -0,0 +1,125 @@
+"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.PaymentDiscoveryService = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const payment_decorator_1 = require("./payment.decorator");
+const payment_registry_service_1 = require("./payment-registry.service");
+const constants_1 = require("@nestjs/common/constants");
+/**
+ * Service that auto-discovers @Payment() decorated routes on module initialization.
+ */
+let PaymentDiscoveryService = class PaymentDiscoveryService {
+    /**
+     * Creates the discovery service with required NestJS internals.
+     *
+     * @param discoveryService - NestJS provider discovery service
+     * @param metadataScanner - NestJS metadata scanner
+     * @param reflector - NestJS reflector for reading metadata
+     * @param paymentRegistry - payment registry to register discovered routes
+     */
+    constructor(discoveryService, metadataScanner, reflector, paymentRegistry) {
+        this.discoveryService = discoveryService;
+        this.metadataScanner = metadataScanner;
+        this.reflector = reflector;
+        this.paymentRegistry = paymentRegistry;
+    }
+    /**
+     * Lifecycle hook that triggers route discovery on module init.
+     */
+    onModuleInit() {
+        this.discoverPaymentConfigs();
+    }
+    /**
+     * Scans all controllers and registers payment-decorated routes.
+     */
+    discoverPaymentConfigs() {
+        const controllers = this.discoveryService.getControllers();
+        controllers.forEach(wrapper => {
+            const { instance, metatype } = wrapper;
+            const controllerPath = this.getControllerPath(metatype);
+            const methodNames = this.metadataScanner.getAllMethodNames(instance);
+            methodNames.forEach(methodName => {
+                const method = instance[methodName];
+                const paymentConfig = this.reflector.get(payment_decorator_1.PAYMENT_CONFIG_KEY, method);
+                if (paymentConfig) {
+                    const routePath = this.getRoutePath(instance, methodName);
+                    const httpMethod = this.getHttpMethod(instance, methodName);
+                    if (httpMethod && routePath !== null) {
+                        const fullPath = this.combinePaths(controllerPath, routePath);
+                        this.paymentRegistry.registerRoute(httpMethod, fullPath, paymentConfig);
+                    }
+                }
+            });
+        });
+    }
+    /**
+     * Extract the controller base path from metadata.
+     *
+     * @param metatype - the controller class
+     * @returns the controller path string
+     */
+    getControllerPath(metatype) {
+        return this.reflector.get(constants_1.PATH_METADATA, metatype) || "";
+    }
+    /**
+     * Extract the route path from a handler method's metadata.
+     *
+     * @param instance - the controller instance
+     * @param methodName - the handler method name
+     * @returns the route path or null
+     */
+    getRoutePath(instance, methodName) {
+        const method = instance[methodName];
+        return this.reflector.get(constants_1.PATH_METADATA, method) || "";
+    }
+    /**
+     * Extract the HTTP method from a handler method's metadata.
+     *
+     * @param instance - the controller instance
+     * @param methodName - the handler method name
+     * @returns the HTTP method string
+     */
+    getHttpMethod(instance, methodName) {
+        const method = instance[methodName];
+        const metadata = this.reflector.get(constants_1.METHOD_METADATA, method);
+        const httpMethod = common_1.RequestMethod[metadata];
+        return httpMethod?.toString() || common_1.RequestMethod.GET.toString();
+    }
+    /**
+     * Combine a controller path and route path into a full path.
+     *
+     * @param controllerPath - the controller base path
+     * @param routePath - the route method path
+     * @returns the combined full path
+     */
+    combinePaths(controllerPath, routePath) {
+        const controller = controllerPath.startsWith("/") ? controllerPath : `/${controllerPath}`;
+        const route = routePath.startsWith("/") ? routePath : `/${routePath}`;
+        if (controller === "/" && route === "/")
+            return "/";
+        if (controller === "/")
+            return route;
+        if (route === "/")
+            return controller;
+        return `${controller}${route}`;
+    }
+};
+exports.PaymentDiscoveryService = PaymentDiscoveryService;
+exports.PaymentDiscoveryService = PaymentDiscoveryService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.DiscoveryService,
+        core_1.MetadataScanner,
+        core_1.Reflector,
+        payment_registry_service_1.PaymentRegistryService])
+], PaymentDiscoveryService);
+//# sourceMappingURL=payment-discovery.service.js.map

package/dist/payment-discovery.service.js.map

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

package/dist/payment-registry.service.d.ts

@@ -0,0 +1,40 @@
+import type { RouteConfig, PaymentOption } from "@x402/core/http";
+export interface X402SellerConfig {
+    defaultConfig: Partial<PaymentOption>;
+}
+/**
+ * Service that stores and retrieves x402 payment route configurations.
+ */
+export declare class PaymentRegistryService {
+    private paymentConfigs;
+    private sellerConfig?;
+    /**
+     * Set the global seller configuration for default payment options.
+     *
+     * @param config - seller configuration with default payment options
+     */
+    setSellerConfig(config: X402SellerConfig): void;
+    /**
+     * Register a route with its payment configuration.
+     *
+     * @param method - HTTP method
+     * @param path - route path
+     * @param config - payment route configuration
+     */
+    registerRoute(method: string, path: string, config: RouteConfig): void;
+    /**
+     * Get the payment configuration for a specific route.
+     *
+     * @param method - HTTP method
+     * @param path - route path
+     * @returns the route config or undefined if not found
+     */
+    getPaymentConfig(method: string, path: string): RouteConfig | undefined;
+    /**
+     * Get all registered payment configurations.
+     *
+     * @returns record of all route configs keyed by "METHOD path"
+     */
+    getAllConfigs(): Record<string, RouteConfig>;
+}
+//# sourceMappingURL=payment-registry.service.d.ts.map

package/dist/payment-registry.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-registry.service.d.ts","sourceRoot":"","sources":["../src/payment-registry.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,qBACa,sBAAsB;IACjC,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,YAAY,CAAC,CAAmB;IAExC;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,gBAAgB;IAIxC;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW;IAa/D;;;;;;OAMG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAKvE;;;;OAIG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;CAK7C"}

package/dist/payment-registry.service.js

@@ -0,0 +1,70 @@
+"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.PaymentRegistryService = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Service that stores and retrieves x402 payment route configurations.
+ */
+let PaymentRegistryService = class PaymentRegistryService {
+    constructor() {
+        this.paymentConfigs = new Map();
+    }
+    /**
+     * Set the global seller configuration for default payment options.
+     *
+     * @param config - seller configuration with default payment options
+     */
+    setSellerConfig(config) {
+        this.sellerConfig = config;
+    }
+    /**
+     * Register a route with its payment configuration.
+     *
+     * @param method - HTTP method
+     * @param path - route path
+     * @param config - payment route configuration
+     */
+    registerRoute(method, path, config) {
+        const routeKey = `${method.toUpperCase()} ${path}`;
+        const defaultAccepts = this.sellerConfig?.defaultConfig;
+        this.paymentConfigs.set(routeKey, {
+            ...config,
+            accepts: {
+                ...defaultAccepts,
+                ...config.accepts,
+            },
+        });
+    }
+    /**
+     * Get the payment configuration for a specific route.
+     *
+     * @param method - HTTP method
+     * @param path - route path
+     * @returns the route config or undefined if not found
+     */
+    getPaymentConfig(method, path) {
+        const routeKey = `${method.toUpperCase()} ${path}`;
+        return this.paymentConfigs.get(routeKey);
+    }
+    /**
+     * Get all registered payment configurations.
+     *
+     * @returns record of all route configs keyed by "METHOD path"
+     */
+    getAllConfigs() {
+        const configs = {};
+        this.paymentConfigs.forEach((config, route) => (configs[route] = config));
+        return configs;
+    }
+};
+exports.PaymentRegistryService = PaymentRegistryService;
+exports.PaymentRegistryService = PaymentRegistryService = __decorate([
+    (0, common_1.Injectable)()
+], PaymentRegistryService);
+//# sourceMappingURL=payment-registry.service.js.map

package/dist/payment-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-registry.service.js","sourceRoot":"","sources":["../src/payment-registry.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAO5C;;GAEG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAA5B;QACG,mBAAc,GAAG,IAAI,GAAG,EAAuB,CAAC;IAsD1D,CAAC;IAnDC;;;;OAIG;IACH,eAAe,CAAC,MAAwB;QACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,MAAc,EAAE,IAAY,EAAE,MAAmB;QAC7D,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;QACnD,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC;QAExD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE;YAChC,GAAG,MAAM;YACT,OAAO,EAAE;gBACP,GAAG,cAAc;gBACjB,GAAG,MAAM,CAAC,OAAO;aACD;SACnB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB,CAAC,MAAc,EAAE,IAAY;QAC3C,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,aAAa;QACX,MAAM,OAAO,GAAgC,EAAE,CAAC;QAChD,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;QAC1E,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAA;AAvDY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;GACA,sBAAsB,CAuDlC"}

package/dist/payment.decorator.d.ts

@@ -0,0 +1,20 @@
+import type { RouteConfig } from "@x402/core/http";
+import type { Network, Price } from "@x402/core/types";
+import type { PaymentOption as X402PaymentOption } from "@x402/core/http";
+export interface PaymentOption extends Partial<X402PaymentOption> {
+    price?: Price;
+    network?: Network;
+    payTo?: string;
+}
+export interface PaymentConfig extends Partial<Omit<RouteConfig, "accepts">> {
+    accepts?: PaymentOption | PaymentOption[];
+}
+export declare const PAYMENT_CONFIG_KEY = "payment_config";
+/**
+ * Decorator that marks a route as x402 payment-protected.
+ *
+ * @param config - payment configuration for the route
+ * @returns a method decorator
+ */
+export declare const Payment: (config?: PaymentConfig) => import("@nestjs/common").CustomDecorator<string>;
+//# sourceMappingURL=payment.decorator.d.ts.map

package/dist/payment.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.decorator.d.ts","sourceRoot":"","sources":["../src/payment.decorator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,iBAAiB,CAAC;IAC/D,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC1E,OAAO,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC;CAC3C;AAED,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,SAAQ,aAAkB,qDAI9C,CAAC"}

package/dist/payment.decorator.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Payment = exports.PAYMENT_CONFIG_KEY = void 0;
+const common_1 = require("@nestjs/common");
+exports.PAYMENT_CONFIG_KEY = "payment_config";
+/**
+ * Decorator that marks a route as x402 payment-protected.
+ *
+ * @param config - payment configuration for the route
+ * @returns a method decorator
+ */
+const Payment = (config = {}) => (0, common_1.SetMetadata)(exports.PAYMENT_CONFIG_KEY, {
+    mimeType: "application/json",
+    ...config,
+});
+exports.Payment = Payment;
+//# sourceMappingURL=payment.decorator.js.map

package/dist/payment.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.decorator.js","sourceRoot":"","sources":["../src/payment.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAehC,QAAA,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD;;;;;GAKG;AACI,MAAM,OAAO,GAAG,CAAC,SAAwB,EAAE,EAAE,EAAE,CACpD,IAAA,oBAAW,EAAC,0BAAkB,EAAE;IAC9B,QAAQ,EAAE,kBAAkB;IAC5B,GAAG,MAAM;CACV,CAAC,CAAC;AAJQ,QAAA,OAAO,WAIf"}

package/dist/payment.interceptor.d.ts

@@ -0,0 +1,39 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from "@nestjs/common";
+import { Observable } from "rxjs";
+import { PaymentRegistryService } from "./payment-registry.service";
+import type { Network } from "@x402/core/types";
+export interface PaymentInterceptorConfig {
+    facilitatorUrl: string;
+    defaultNetwork?: Network;
+}
+/**
+ * NestJS interceptor that validates x402 payment headers on protected routes.
+ */
+export declare class PaymentInterceptor implements NestInterceptor {
+    private readonly paymentRegistry;
+    private facilitatorClient;
+    private resourceServer;
+    private schemeServer;
+    private initialized;
+    /**
+     * Creates the interceptor with the payment registry.
+     *
+     * @param paymentRegistry - registry of payment-protected routes
+     */
+    constructor(paymentRegistry: PaymentRegistryService);
+    /**
+     * Initialize the interceptor with facilitator and scheme server clients.
+     *
+     * @param config - facilitator URL and default network configuration
+     */
+    initialize(config: PaymentInterceptorConfig): void;
+    /**
+     * Intercept requests and validate x402 payment if the route is protected.
+     *
+     * @param context - NestJS execution context
+     * @param next - call handler to proceed to the route handler
+     * @returns observable of the response
+     */
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+//# sourceMappingURL=payment.interceptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payment.interceptor.d.ts","sourceRoot":"","sources":["../src/payment.interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAQpE,OAAO,KAAK,EAAE,OAAO,EAAuB,MAAM,kBAAkB,CAAC;AAErE,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,qBACa,kBAAmB,YAAW,eAAe;IAW5C,OAAO,CAAC,QAAQ,CAAC,eAAe;IAV5C,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBAC0B,eAAe,EAAE,sBAAsB;IAEpE;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,wBAAwB;IAqB3C;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;CA6C7E"}

package/dist/payment.interceptor.js

@@ -0,0 +1,102 @@
+"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.PaymentInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const rxjs_1 = require("rxjs");
+const payment_registry_service_1 = require("./payment-registry.service");
+const express_1 = require("@x402/express");
+const x402_evm_1 = require("@introspectivelabs/x402-evm");
+/**
+ * NestJS interceptor that validates x402 payment headers on protected routes.
+ */
+let PaymentInterceptor = class PaymentInterceptor {
+    /**
+     * Creates the interceptor with the payment registry.
+     *
+     * @param paymentRegistry - registry of payment-protected routes
+     */
+    constructor(paymentRegistry) {
+        this.paymentRegistry = paymentRegistry;
+        this.initialized = false;
+    }
+    /**
+     * Initialize the interceptor with facilitator and scheme server clients.
+     *
+     * @param config - facilitator URL and default network configuration
+     */
+    initialize(config) {
+        if (this.initialized)
+            return;
+        const { HTTPFacilitatorClient: HTTPFacClient } = 
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        require("@x402/core/http");
+        this.facilitatorClient = new HTTPFacClient({
+            url: config.facilitatorUrl,
+        });
+        this.resourceServer = new express_1.x402ResourceServer(this.facilitatorClient);
+        this.schemeServer = new x402_evm_1.ExactEvmSchemeERC4337Server();
+        const defaultNetwork = config.defaultNetwork || "eip155:84532";
+        this.resourceServer.register(defaultNetwork, this.schemeServer);
+        this.initialized = true;
+    }
+    /**
+     * Intercept requests and validate x402 payment if the route is protected.
+     *
+     * @param context - NestJS execution context
+     * @param next - call handler to proceed to the route handler
+     * @returns observable of the response
+     */
+    intercept(context, next) {
+        if (!this.initialized) {
+            return next.handle();
+        }
+        const ctx = context.switchToHttp();
+        const request = ctx.getRequest();
+        const response = ctx.getResponse();
+        const method = request.method;
+        const path = request.route?.path || request.path;
+        const paymentConfig = this.paymentRegistry.getPaymentConfig(method, path);
+        if (!paymentConfig) {
+            return next.handle();
+        }
+        return new rxjs_1.Observable(observer => {
+            (0, x402_evm_1.transformRouteForUserOperation)(paymentConfig, this.schemeServer)
+                .then(config => {
+                const middleware = (0, express_1.paymentMiddleware)(config, this.resourceServer);
+                void middleware(request, response, (error) => {
+                    if (error) {
+                        observer.error(error);
+                        return;
+                    }
+                    if (response.headersSent) {
+                        observer.complete();
+                        return;
+                    }
+                    next.handle().subscribe({
+                        next: value => observer.next(value),
+                        error: err => observer.error(err),
+                        complete: () => observer.complete(),
+                    });
+                });
+            })
+                .catch(error => {
+                observer.error(error);
+            });
+        });
+    }
+};
+exports.PaymentInterceptor = PaymentInterceptor;
+exports.PaymentInterceptor = PaymentInterceptor = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [payment_registry_service_1.PaymentRegistryService])
+], PaymentInterceptor);
+//# sourceMappingURL=payment.interceptor.js.map

package/dist/payment.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.interceptor.js","sourceRoot":"","sources":["../src/payment.interceptor.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4F;AAC5F,+BAAkC;AAElC,yEAAoE;AACpE,2CAAsE;AAGtE,0DAGqC;AAQrC;;GAEG;AAEI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAM7B;;;;OAIG;IACH,YAA6B,eAAuC;QAAvC,oBAAe,GAAf,eAAe,CAAwB;QAP5D,gBAAW,GAAG,KAAK,CAAC;IAO2C,CAAC;IAExE;;;;OAIG;IACH,UAAU,CAAC,MAAgC;QACzC,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAE7B,MAAM,EAAE,qBAAqB,EAAE,aAAa,EAAE;QAC5C,iEAAiE;QACjE,OAAO,CAAC,iBAAiB,CAExB,CAAC;QAEJ,IAAI,CAAC,iBAAiB,GAAG,IAAI,aAAa,CAAC;YACzC,GAAG,EAAE,MAAM,CAAC,cAAc;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,cAAc,GAAG,IAAI,4BAAkB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACrE,IAAI,CAAC,YAAY,GAAG,IAAI,sCAA2B,EAAE,CAAC;QAEtD,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,cAAc,CAAC;QAC/D,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,YAAmC,CAAC,CAAC;QAEvF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,OAAyB,EAAE,IAAiB;QACpD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAW,CAAC;QAC1C,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAY,CAAC;QAE7C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;QACjD,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAc,CAAC,CAAC;QAEpF,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,iBAAU,CAAC,QAAQ,CAAC,EAAE;YAC/B,IAAA,yCAA8B,EAAC,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC;iBAC7D,IAAI,CAAC,MAAM,CAAC,EAAE;gBACb,MAAM,UAAU,GAAG,IAAA,2BAAiB,EAAC,MAAsB,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;gBAElF,KAAK,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAe,EAAE,EAAE;oBACrD,IAAI,KAAK,EAAE,CAAC;wBACV,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;wBACtB,OAAO;oBACT,CAAC;oBAED,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;wBACzB,QAAQ,CAAC,QAAQ,EAAE,CAAC;wBACpB,OAAO;oBACT,CAAC;oBAED,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC;wBACtB,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;wBACnC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC;wBACjC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE;qBACpC,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC,CAAC;iBACD,KAAK,CAAC,KAAK,CAAC,EAAE;gBACb,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA3FY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;qCAYmC,iDAAsB;GAXzD,kBAAkB,CA2F9B"}

package/dist/x402.module-definition.d.ts

@@ -0,0 +1,22 @@
+import type { Network, Price } from "@x402/core/types";
+export interface X402ModuleOptions {
+    facilitatorUrl: string;
+    seller: {
+        address: string;
+        defaultConfig: {
+            scheme?: string;
+            price?: Price;
+            network?: Network;
+            payTo?: string;
+            extra?: Record<string, unknown>;
+        };
+    };
+}
+export declare const ConfigurableModuleClass: import("@nestjs/common").ConfigurableModuleCls<X402ModuleOptions, "forRoot", "create", {
+    isGlobal: boolean;
+}>, X402_MODULE_OPTIONS: string | symbol, OPTIONS_TYPE: X402ModuleOptions & Partial<{
+    isGlobal: boolean;
+}>, ASYNC_OPTIONS_TYPE: import("@nestjs/common").ConfigurableModuleAsyncOptions<X402ModuleOptions, "create"> & Partial<{
+    isGlobal: boolean;
+}>;
+//# sourceMappingURL=x402.module-definition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"x402.module-definition.d.ts","sourceRoot":"","sources":["../src/x402.module-definition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE;YACb,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,KAAK,CAAC,EAAE,KAAK,CAAC;YACd,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACjC,CAAC;KACH,CAAC;CACH;AAED,eAAO,MACL,uBAAuB;;IACD,mBAAmB,mBACzC,YAAY;;IACZ,kBAAkB;;EAYV,CAAC"}

package/dist/x402.module-definition.js

@@ -0,0 +1,15 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASYNC_OPTIONS_TYPE = exports.OPTIONS_TYPE = exports.X402_MODULE_OPTIONS = exports.ConfigurableModuleClass = void 0;
+const common_1 = require("@nestjs/common");
+_a = new common_1.ConfigurableModuleBuilder()
+    .setClassMethodName("forRoot")
+    .setExtras({
+    isGlobal: true,
+}, (definition, extras) => ({
+    ...definition,
+    global: extras.isGlobal,
+}))
+    .build(), exports.ConfigurableModuleClass = _a.ConfigurableModuleClass, exports.X402_MODULE_OPTIONS = _a.MODULE_OPTIONS_TOKEN, exports.OPTIONS_TYPE = _a.OPTIONS_TYPE, exports.ASYNC_OPTIONS_TYPE = _a.ASYNC_OPTIONS_TYPE;
+//# sourceMappingURL=x402.module-definition.js.map

package/dist/x402.module-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.module-definition.js","sourceRoot":"","sources":["../src/x402.module-definition.ts"],"names":[],"mappings":";;;;AAAA,2CAA2D;AAiB9C,KAKT,IAAI,kCAAyB,EAAqB;KACnD,kBAAkB,CAAC,SAAS,CAAC;KAC7B,SAAS,CACR;IACE,QAAQ,EAAE,IAAI;CACf,EACD,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACvB,GAAG,UAAU;IACb,MAAM,EAAE,MAAM,CAAC,QAAQ;CACxB,CAAC,CACH;KACA,KAAK,EAAE,EAfR,+BAAuB,+BACD,2BAAmB,4BACzC,oBAAY,oBACZ,0BAAkB,yBAYT"}

package/dist/x402.module.d.ts

@@ -0,0 +1,23 @@
+import { DynamicModule } from "@nestjs/common";
+import { ConfigurableModuleClass, X402_MODULE_OPTIONS, type X402ModuleOptions, type OPTIONS_TYPE, type ASYNC_OPTIONS_TYPE } from "./x402.module-definition";
+export { X402_MODULE_OPTIONS, type X402ModuleOptions };
+/**
+ * NestJS dynamic module for x402 payment protocol integration.
+ */
+export declare class X402Module extends ConfigurableModuleClass {
+    /**
+     * Register the module with static options.
+     *
+     * @param options - module configuration including facilitator URL and seller config
+     * @returns the configured dynamic module
+     */
+    static forRoot(options: typeof OPTIONS_TYPE): DynamicModule;
+    /**
+     * Register the module with async/factory options.
+     *
+     * @param options - async module configuration with useFactory
+     * @returns the configured dynamic module
+     */
+    static forRootAsync(options: typeof ASYNC_OPTIONS_TYPE): DynamicModule;
+}
+//# 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":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAMvD,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,CAAC;AAEvD;;GAEG;AACH,qBACa,UAAW,SAAQ,uBAAuB;IACrD;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,YAAY,GAAG,aAAa;IA4C3D;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,kBAAkB,GAAG,aAAa;CA2CvE"}

package/dist/x402.module.js

@@ -0,0 +1,116 @@
+"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 = exports.X402_MODULE_OPTIONS = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const payment_registry_service_1 = require("./payment-registry.service");
+const payment_discovery_service_1 = require("./payment-discovery.service");
+const payment_interceptor_1 = require("./payment.interceptor");
+const x402_module_definition_1 = require("./x402.module-definition");
+Object.defineProperty(exports, "X402_MODULE_OPTIONS", { enumerable: true, get: function () { return x402_module_definition_1.X402_MODULE_OPTIONS; } });
+/**
+ * NestJS dynamic module for x402 payment protocol integration.
+ */
+let X402Module = class X402Module extends x402_module_definition_1.ConfigurableModuleClass {
+    /**
+     * Register the module with static options.
+     *
+     * @param options - module configuration including facilitator URL and seller config
+     * @returns the configured dynamic module
+     */
+    static forRoot(options) {
+        const baseModule = super.forRoot(options);
+        return {
+            ...baseModule,
+            providers: [
+                ...(baseModule.providers || []),
+                payment_registry_service_1.PaymentRegistryService,
+                payment_discovery_service_1.PaymentDiscoveryService,
+                core_1.DiscoveryService,
+                core_1.MetadataScanner,
+                {
+                    provide: payment_interceptor_1.PaymentInterceptor,
+                    useFactory: (registry) => {
+                        return new payment_interceptor_1.PaymentInterceptor(registry);
+                    },
+                    inject: [payment_registry_service_1.PaymentRegistryService],
+                },
+                {
+                    provide: core_1.APP_INTERCEPTOR,
+                    useExisting: payment_interceptor_1.PaymentInterceptor,
+                },
+                {
+                    provide: "X402_MODULE_INIT",
+                    useFactory: (registry, interceptor, opts) => {
+                        registry.setSellerConfig({
+                            defaultConfig: opts.seller.defaultConfig,
+                        });
+                        interceptor.initialize({
+                            facilitatorUrl: opts.facilitatorUrl,
+                            defaultNetwork: opts.seller.defaultConfig.network,
+                        });
+                        return true;
+                    },
+                    inject: [payment_registry_service_1.PaymentRegistryService, payment_interceptor_1.PaymentInterceptor, x402_module_definition_1.X402_MODULE_OPTIONS],
+                },
+            ],
+            exports: [payment_registry_service_1.PaymentRegistryService, payment_interceptor_1.PaymentInterceptor],
+        };
+    }
+    /**
+     * Register the module with async/factory options.
+     *
+     * @param options - async module configuration with useFactory
+     * @returns the configured dynamic module
+     */
+    static forRootAsync(options) {
+        const baseModule = super.forRootAsync(options);
+        return {
+            ...baseModule,
+            providers: [
+                ...(baseModule.providers || []),
+                payment_registry_service_1.PaymentRegistryService,
+                payment_discovery_service_1.PaymentDiscoveryService,
+                core_1.DiscoveryService,
+                core_1.MetadataScanner,
+                {
+                    provide: payment_interceptor_1.PaymentInterceptor,
+                    useFactory: (registry) => {
+                        return new payment_interceptor_1.PaymentInterceptor(registry);
+                    },
+                    inject: [payment_registry_service_1.PaymentRegistryService],
+                },
+                {
+                    provide: core_1.APP_INTERCEPTOR,
+                    useExisting: payment_interceptor_1.PaymentInterceptor,
+                },
+                {
+                    provide: "X402_MODULE_INIT",
+                    useFactory: (registry, interceptor, opts) => {
+                        registry.setSellerConfig({
+                            defaultConfig: opts.seller.defaultConfig,
+                        });
+                        interceptor.initialize({
+                            facilitatorUrl: opts.facilitatorUrl,
+                            defaultNetwork: opts.seller.defaultConfig.network,
+                        });
+                        return true;
+                    },
+                    inject: [payment_registry_service_1.PaymentRegistryService, payment_interceptor_1.PaymentInterceptor, x402_module_definition_1.X402_MODULE_OPTIONS],
+                },
+            ],
+            exports: [payment_registry_service_1.PaymentRegistryService, payment_interceptor_1.PaymentInterceptor],
+        };
+    }
+};
+exports.X402Module = X402Module;
+exports.X402Module = X402Module = __decorate([
+    (0, common_1.Module)({})
+], 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":"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"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@introspectivelabs/nestjs-x402",
+  "version": "0.1.0-beta.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "keywords": [
+    "x402",
+    "payment",
+    "nestjs",
+    "erc4337"
+  ],
+  "license": "Apache-2.0",
+  "author": "Introspective Labs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Introspective-Labs/x402-modules.git",
+    "directory": "packages/nestjs-x402"
+  },
+  "description": "x402 Payment Protocol NestJS integration with @Payment() decorator support",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "peerDependencies": {
+    "@introspectivelabs/x402-evm": ">=0.1.0-beta.1",
+    "@nestjs/common": ">=10.0.0",
+    "@nestjs/config": ">=3.0.0",
+    "@nestjs/core": ">=10.0.0",
+    "@x402/core": "2.*",
+    "@x402/express": "2.*",
+    "rxjs": ">=7.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "@nestjs/common": "^11.0.1",
+    "@nestjs/config": "^4.0.2",
+    "@nestjs/core": "^11.0.1",
+    "@nestjs/testing": "^11.0.1",
+    "@swc/core": "^1.15.11",
+    "@typescript-eslint/eslint-plugin": "^8.29.1",
+    "@typescript-eslint/parser": "^8.29.1",
+    "@x402/core": "^2.1.0",
+    "@x402/express": "^2.1.0",
+    "eslint": "^9.24.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jsdoc": "^50.6.9",
+    "eslint-plugin-prettier": "^5.2.6",
+    "prettier": "3.5.2",
+    "rxjs": "^7.8.1",
+    "typescript": "^5.7.3",
+    "unplugin-swc": "^1.5.9",
+    "vite": "^6.2.6",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.0.5",
+    "@introspectivelabs/x402-evm": "0.1.0-beta.4"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint . --ext .ts --fix",
+    "lint:check": "eslint . --ext .ts",
+    "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
+    "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
+    "publish:dev": "pnpm dlx yalc publish --push"
+  }
+}