@deltablab/express 0.1.0

package/LICENSE

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import { RequestHandler } from 'express';
+import { PaygatePipelineConnectOptions } from '@deltablab/publisher-core';
+export { GatewayPipelineOptions, PaygatePipelineConnectOptions } from '@deltablab/publisher-core';
+
+interface PaygateExpressCloudOptions {
+    baseUrl: string;
+    apiKey: string;
+}
+/**
+ * Connection options used by `createPaygateExpress`.
+ * Declared as interface (not type alias) to preserve declaration-merging compatibility.
+ */
+interface CreatePaygateExpressOptions extends PaygateExpressCloudOptions, PaygatePipelineConnectOptions {
+}
+/** Route-local options used by `createPaygateExpress(...)(route)`. */
+interface PaygateExpressRouteOptions {
+    endpointId: string;
+}
+/**
+ * Options for one paid route.
+ * Declared as interface (not type alias) to preserve declaration-merging compatibility.
+ */
+interface PaygateExpressOptions extends CreatePaygateExpressOptions, PaygateExpressRouteOptions {
+}
+/**
+ * Express `RequestHandler` for the PayGate paywall.
+ * It does not read or mutate `req.body`, so downstream business handlers can
+ * consume the request payload normally.
+ */
+declare function paygateExpress(options: PaygateExpressOptions): RequestHandler;
+declare function createPaygateExpress(options: CreatePaygateExpressOptions): (route: PaygateExpressRouteOptions) => RequestHandler;
+
+export { type CreatePaygateExpressOptions, type PaygateExpressCloudOptions, type PaygateExpressOptions, type PaygateExpressRouteOptions, createPaygateExpress, paygateExpress };

package/dist/index.js

@@ -0,0 +1,38 @@
+// src/index.ts
+import { createGatewayPipelineForPaidRoute, incomingFromExpress } from "@deltablab/publisher-core";
+import { PublisherCloudClient } from "@deltablab/publisher-cloud";
+function createRequestHandler(options) {
+  const publisherCloud = new PublisherCloudClient({
+    baseUrl: options.baseUrl,
+    apiKey: options.apiKey
+  });
+  const pipeline = createGatewayPipelineForPaidRoute(options, options.endpointId, publisherCloud);
+  return async (req, res, next) => {
+    try {
+      const result = await pipeline.handle(incomingFromExpress(req));
+      if (result.kind === "next") {
+        return next();
+      }
+      res.status(result.status ?? 500);
+      if (result.headers) {
+        for (const [k, v] of Object.entries(result.headers)) {
+          res.setHeader(k, v);
+        }
+      }
+      res.json(result.body);
+    } catch (err) {
+      next(err);
+    }
+  };
+}
+function paygateExpress(options) {
+  return createRequestHandler(options);
+}
+function createPaygateExpress(options) {
+  return ({ endpointId }) => createRequestHandler({ ...options, endpointId });
+}
+export {
+  createPaygateExpress,
+  paygateExpress
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Request, Response, NextFunction, RequestHandler } from \"express\";\nimport type {\n  GatewayPipelineOptions,\n  PaygatePipelineConnectOptions,\n} from \"@deltablab/publisher-core\";\nimport { createGatewayPipelineForPaidRoute, incomingFromExpress } from \"@deltablab/publisher-core\";\nimport { PublisherCloudClient } from \"@deltablab/publisher-cloud\";\n\nexport interface PaygateExpressCloudOptions {\n  baseUrl: string;\n  apiKey: string;\n}\n\n/**\n * Connection options used by `createPaygateExpress`.\n * Declared as interface (not type alias) to preserve declaration-merging compatibility.\n */\nexport interface CreatePaygateExpressOptions\n  extends PaygateExpressCloudOptions,\n    PaygatePipelineConnectOptions {}\n\n/** Route-local options used by `createPaygateExpress(...)(route)`. */\nexport interface PaygateExpressRouteOptions {\n  endpointId: string;\n}\n\n/**\n * Options for one paid route.\n * Declared as interface (not type alias) to preserve declaration-merging compatibility.\n */\nexport interface PaygateExpressOptions\n  extends CreatePaygateExpressOptions,\n    PaygateExpressRouteOptions {}\n\nfunction createRequestHandler(options: PaygateExpressOptions): RequestHandler {\n  const publisherCloud = new PublisherCloudClient({\n    baseUrl: options.baseUrl,\n    apiKey: options.apiKey,\n  });\n\n  const pipeline = createGatewayPipelineForPaidRoute(options, options.endpointId, publisherCloud);\n\n  return async (req: Request, res: Response, next: NextFunction) => {\n    try {\n      const result = await pipeline.handle(incomingFromExpress(req));\n\n      if (result.kind === \"next\") {\n        return next();\n      }\n\n      res.status(result.status ?? 500);\n      if (result.headers) {\n        for (const [k, v] of Object.entries(result.headers)) {\n          res.setHeader(k, v);\n        }\n      }\n      res.json(result.body);\n    } catch (err) {\n      next(err);\n    }\n  };\n}\n\n/**\n * Express `RequestHandler` for the PayGate paywall.\n * It does not read or mutate `req.body`, so downstream business handlers can\n * consume the request payload normally.\n */\nexport function paygateExpress(options: PaygateExpressOptions): RequestHandler {\n  return createRequestHandler(options);\n}\n\nexport function createPaygateExpress(\n  options: CreatePaygateExpressOptions,\n): (route: PaygateExpressRouteOptions) => RequestHandler {\n  return ({ endpointId }: PaygateExpressRouteOptions) =>\n    createRequestHandler({ ...options, endpointId });\n}\n\nexport type { GatewayPipelineOptions, PaygatePipelineConnectOptions };\n"],"mappings":";AAKA,SAAS,mCAAmC,2BAA2B;AACvE,SAAS,4BAA4B;AA4BrC,SAAS,qBAAqB,SAAgD;AAC5E,QAAM,iBAAiB,IAAI,qBAAqB;AAAA,IAC9C,SAAS,QAAQ;AAAA,IACjB,QAAQ,QAAQ;AAAA,EAClB,CAAC;AAED,QAAM,WAAW,kCAAkC,SAAS,QAAQ,YAAY,cAAc;AAE9F,SAAO,OAAO,KAAc,KAAe,SAAuB;AAChE,QAAI;AACF,YAAM,SAAS,MAAM,SAAS,OAAO,oBAAoB,GAAG,CAAC;AAE7D,UAAI,OAAO,SAAS,QAAQ;AAC1B,eAAO,KAAK;AAAA,MACd;AAEA,UAAI,OAAO,OAAO,UAAU,GAAG;AAC/B,UAAI,OAAO,SAAS;AAClB,mBAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,OAAO,OAAO,GAAG;AACnD,cAAI,UAAU,GAAG,CAAC;AAAA,QACpB;AAAA,MACF;AACA,UAAI,KAAK,OAAO,IAAI;AAAA,IACtB,SAAS,KAAK;AACZ,WAAK,GAAG;AAAA,IACV;AAAA,EACF;AACF;AAOO,SAAS,eAAe,SAAgD;AAC7E,SAAO,qBAAqB,OAAO;AACrC;AAEO,SAAS,qBACd,SACuD;AACvD,SAAO,CAAC,EAAE,WAAW,MACnB,qBAAqB,EAAE,GAAG,SAAS,WAAW,CAAC;AACnD;","names":[]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@deltablab/express",
+  "version": "0.1.0",
+  "description": "Express middleware wiring PayGate GatewayPipeline to your routes.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "paygate",
+    "x402",
+    "express",
+    "middleware"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@deltablab/publisher-cloud": "0.1.0",
+    "@deltablab/publisher-core": "0.1.0",
+    "@deltablab/protocol": "0.1.0"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0 || ^5.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}