@foldset/express 0.1.0

package/dist/adapter.d.ts

@@ -0,0 +1,18 @@
+import type { Request } from "express";
+import type { RequestAdapter } from "@foldset/core";
+export declare class ExpressAdapter implements RequestAdapter {
+    private req;
+    constructor(req: Request);
+    getIpAddress(): string | null;
+    getHeader(name: string): string | undefined;
+    getMethod(): string;
+    getPath(): string;
+    getUrl(): string;
+    getHost(): string;
+    getAcceptHeader(): string;
+    getUserAgent(): string;
+    getQueryParams(): Record<string, string | string[]>;
+    getQueryParam(name: string): string | string[] | undefined;
+    getBody(): Promise<unknown>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,qBAAa,cAAe,YAAW,cAAc;IACvC,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,OAAO;IAEhC,YAAY,IAAI,MAAM,GAAG,IAAI;IAM7B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C,SAAS,IAAI,MAAM;IAInB,OAAO,IAAI,MAAM;IAIjB,MAAM,IAAI,MAAM;IAIhB,OAAO,IAAI,MAAM;IAIjB,eAAe,IAAI,MAAM;IAIzB,YAAY,IAAI,MAAM;IAItB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAYnD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAIpD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAGlC"}

package/dist/adapter.js

@@ -0,0 +1,51 @@
+export class ExpressAdapter {
+    req;
+    constructor(req) {
+        this.req = req;
+    }
+    getIpAddress() {
+        const forwarded = this.req.get("x-forwarded-for");
+        if (forwarded)
+            return forwarded.split(",")[0].trim();
+        return this.req.ip ?? null;
+    }
+    getHeader(name) {
+        return this.req.get(name);
+    }
+    getMethod() {
+        return this.req.method;
+    }
+    getPath() {
+        return this.req.path;
+    }
+    getUrl() {
+        return `${this.req.protocol}://${this.req.get("host")}${this.req.originalUrl}`;
+    }
+    getHost() {
+        return this.req.hostname;
+    }
+    getAcceptHeader() {
+        return this.req.get("Accept") ?? "";
+    }
+    getUserAgent() {
+        return this.req.get("User-Agent") ?? "";
+    }
+    getQueryParams() {
+        const result = {};
+        for (const [key, value] of Object.entries(this.req.query)) {
+            if (typeof value === "string") {
+                result[key] = value;
+            }
+            else if (Array.isArray(value)) {
+                result[key] = value.filter((v) => typeof v === "string");
+            }
+        }
+        return result;
+    }
+    getQueryParam(name) {
+        return this.getQueryParams()[name];
+    }
+    async getBody() {
+        return this.req.body;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { foldset } from "./middleware";
+export type { FoldsetOptions } from "@foldset/core";
+//# 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,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export { foldset } from "./middleware";

package/dist/middleware.d.ts

@@ -0,0 +1,4 @@
+import type { RequestHandler } from "express";
+import type { FoldsetOptions } from "@foldset/core";
+export declare function foldset(options: FoldsetOptions): RequestHandler;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmC,cAAc,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAYpD,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAiF/D"}

package/dist/middleware.js

@@ -0,0 +1,70 @@
+import { WorkerCore, reportError } from "@foldset/core";
+import packageJson from "../package.json" with { type: "json" };
+import { ExpressAdapter } from "./adapter";
+function setHeaders(res, headers) {
+    for (const [key, value] of Object.entries(headers)) {
+        res.setHeader(key, value);
+    }
+}
+export function foldset(options) {
+    if (!options.apiKey) {
+        console.warn("[foldset] No API key provided, middleware disabled");
+        return (_req, _res, next) => next();
+    }
+    const opts = { ...options, platform: "express", sdkVersion: packageJson.version };
+    return async function foldsetMiddleware(req, res, next) {
+        try {
+            const core = await WorkerCore.fromOptions(opts);
+            const adapter = new ExpressAdapter(req);
+            const result = await core.processRequest(adapter);
+            switch (result.type) {
+                case "health-check":
+                    setHeaders(res, result.response.headers);
+                    return res.status(result.response.status).send(result.response.body);
+                case "no-payment-required":
+                    if (result.headers) {
+                        setHeaders(res, result.headers);
+                    }
+                    return next();
+                case "payment-error":
+                    setHeaders(res, result.response.headers);
+                    return res.status(result.response.status).send(result.response.body);
+                case "payment-verified": {
+                    const originalEnd = res.end.bind(res);
+                    res.end = function (chunk, encoding, cb) {
+                        core
+                            .processSettlement(adapter, result.paymentPayload, result.paymentRequirements, res.statusCode, result.metadata.request_id)
+                            .then((settlement) => {
+                            if (settlement.success) {
+                                setHeaders(res, settlement.headers);
+                            }
+                            else {
+                                res.statusCode = 402;
+                                res.setHeader("Content-Type", "application/json");
+                                chunk = JSON.stringify({ error: "Settlement failed", details: settlement.errorReason });
+                            }
+                        })
+                            .finally(() => {
+                            if (typeof encoding === "function") {
+                                originalEnd(chunk, encoding);
+                            }
+                            else if (encoding) {
+                                originalEnd(chunk, encoding, cb);
+                            }
+                            else {
+                                originalEnd(chunk, cb);
+                            }
+                        });
+                        return res;
+                    };
+                    return next();
+                }
+            }
+        }
+        catch (error) {
+            // On any error, allow the request through rather than blocking the user.
+            reportError(opts.apiKey, error, new ExpressAdapter(req));
+            return next();
+        }
+    };
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@foldset/express",
+  "version": "0.1.0",
+  "description": "Express middleware for Foldset payment gating",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/foldset/sdks.git",
+    "directory": "typescript/express"
+  },
+  "homepage": "https://docs.foldset.com",
+  "keywords": [
+    "foldset",
+    "express",
+    "middleware",
+    "micropayments",
+    "ai",
+    "agents"
+  ],
+  "dependencies": {
+    "@foldset/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "express": ">=4"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}