mppx 0.0.1 → 0.1.0

package/dist/middlewares/nextjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.js","sourceRoot":"","sources":["../../src/middlewares/nextjs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAMpC,MAAM,KAAW,IAAI,CAwBpB;AAxBD,WAAiB,IAAI;IACnB;;;;;;;;;;;;;;;OAeG;IACH,SAAgB,MAAM,CACpB,MAAwC;QAExC,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;YACtE,OAAO,CAAC,OAAqB,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QACrE,CAAC,CAAC,CAAA;IACJ,CAAC;IANe,WAAM,SAMrB,CAAA;AACH,CAAC,EAxBgB,IAAI,KAAJ,IAAI,QAwBpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,OAAO,CACrB,MAAc,EACd,OAAyE,EACzE,OAAqB;IAErB,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAA;QAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,MAAM,CAAC,SAAS,CAAA;QAClD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;QACvC,OAAO,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;IACrC,CAAC,CAAA;AACH,CAAC"}

package/dist/proxy/Proxy.d.ts

@@ -0,0 +1,47 @@
+import type * as http from 'node:http';
+import * as Service from './Service.js';
+/** A paid API proxy that gates upstream services behind the mppx 402 protocol. */
+export type Proxy = {
+    /** Fetch API handler. Works with Bun, Deno, Next.js, Hono, Elysia, SvelteKit, etc. */
+    fetch: (request: Request) => Promise<Response>;
+    /** Node.js request listener. Works with Express, Fastify, `http.createServer`, etc. */
+    listener: (req: http.IncomingMessage, res: http.ServerResponse) => void;
+};
+/**
+ * Creates a paid API proxy.
+ *
+ * Routes incoming requests to upstream services, injects credentials,
+ * and requires payment via the mppx 402 protocol for non-free endpoints.
+ *
+ * @example
+ * ```ts
+ * import { Proxy, openai } from 'mppx/proxy'
+ * import { Mppx, tempo } from 'mppx/server'
+ *
+ * const mppx = Mppx.create({ methods: [tempo()] })
+ *
+ * const proxy = Proxy.create({
+ *   services: [
+ *     openai({
+ *       apiKey: 'sk-...',
+ *       routes: {
+ *         'POST /v1/chat/completions': mppx.charge({ amount: '0.05' }),
+ *         'GET /v1/models': true,
+ *       },
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+export declare function create(config: create.Config): Proxy;
+export declare namespace create {
+    type Config = {
+        /** Base path prefix to strip before routing (e.g. `'/api/proxy'`). */
+        basePath?: string | undefined;
+        /** Custom `fetch` implementation. Defaults to `globalThis.fetch`. */
+        fetch?: typeof globalThis.fetch | undefined;
+        /** Services to proxy. Each service is mounted at `/{serviceId}/`. */
+        services: Service.Service[];
+    };
+}
+//# sourceMappingURL=Proxy.d.ts.map

package/dist/proxy/Proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Proxy.d.ts","sourceRoot":"","sources":["../../src/proxy/Proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAA;AAKtC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,kFAAkF;AAClF,MAAM,MAAM,KAAK,GAAG;IAClB,sFAAsF;IACtF,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC9C,uFAAuF;IACvF,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI,CAAA;CACxE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAgFnD;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAY,MAAM,GAAG;QACnB,sEAAsE;QACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,qEAAqE;QACrE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAA;QAC3C,qEAAqE;QACrE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,CAAA;KAC5B,CAAA;CACF"}

package/dist/proxy/Proxy.js

@@ -0,0 +1,126 @@
+import { createFetchProxy } from '@remix-run/fetch-proxy';
+import * as Request from '../server/Request.js';
+import * as Headers from './internal/Headers.js';
+import * as Route from './internal/Route.js';
+import * as Service from './Service.js';
+/**
+ * Creates a paid API proxy.
+ *
+ * Routes incoming requests to upstream services, injects credentials,
+ * and requires payment via the mppx 402 protocol for non-free endpoints.
+ *
+ * @example
+ * ```ts
+ * import { Proxy, openai } from 'mppx/proxy'
+ * import { Mppx, tempo } from 'mppx/server'
+ *
+ * const mppx = Mppx.create({ methods: [tempo()] })
+ *
+ * const proxy = Proxy.create({
+ *   services: [
+ *     openai({
+ *       apiKey: 'sk-...',
+ *       routes: {
+ *         'POST /v1/chat/completions': mppx.charge({ amount: '0.05' }),
+ *         'GET /v1/models': true,
+ *       },
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+export function create(config) {
+    const fetchImpl = config.fetch ?? globalThis.fetch;
+    const services = new Map(config.services.map((s) => {
+        const proxy = createFetchProxy(s.baseUrl, {
+            fetch: fetchImpl,
+            rewriteCookieDomain: false,
+            rewriteCookiePath: false,
+        });
+        return [s.id, { service: s, proxy }];
+    }));
+    async function handle(request) {
+        const url = new URL(request.url);
+        const pathname = Route.pathname(url, config.basePath);
+        if (!pathname)
+            return new Response('Not Found', { status: 404 });
+        if (request.method === 'GET' && pathname === '/llms.txt')
+            return new Response(Service.toLlmsTxt(config.services), {
+                headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+            });
+        if (request.method === 'GET' && (pathname === '/services' || pathname === '/services/'))
+            return Response.json(config.services.map(Service.serialize));
+        {
+            const match = pathname.match(/^\/services\/([^/]+)\/?$/);
+            if (request.method === 'GET' && match) {
+                const service = config.services.find((s) => s.id === match[1]);
+                if (!service)
+                    return new Response('Not Found', { status: 404 });
+                return Response.json(Service.serialize(service));
+            }
+        }
+        const parsed = Route.parse(pathname);
+        if (!parsed)
+            return new Response('Not Found', { status: 404 });
+        const { serviceId, upstreamPath } = parsed;
+        const entry = services.get(serviceId);
+        if (!entry)
+            return new Response('Not Found', { status: 404 });
+        const { service, proxy } = entry;
+        const matched = Route.match(service.routes, request.method, upstreamPath) ??
+            // Management POSTs (e.g. session close) may target a path whose route
+            // is registered for a different HTTP method (e.g. GET). Fall back to
+            // path-only matching so the payment handler can process the action.
+            (request.method === 'POST' && request.headers.has('authorization')
+                ? Route.matchPath(service.routes, upstreamPath)
+                : null);
+        if (!matched)
+            return new Response('Not Found', { status: 404 });
+        const endpoint = matched.value;
+        const ctx = { request, service, upstreamPath };
+        if (endpoint === true)
+            return proxyUpstream({ request, service, ctx, proxy });
+        const handler = typeof endpoint === 'function' ? endpoint : endpoint.pay;
+        const result = await handler(request);
+        if (result.status === 402)
+            return result.challenge;
+        const options = Service.getOptions(endpoint);
+        const upstreamRes = await proxyUpstream({
+            request,
+            service,
+            ctx: { ...ctx, ...options },
+            proxy,
+        });
+        return result.withReceipt(upstreamRes);
+    }
+    return {
+        fetch: handle,
+        listener: Request.toNodeListener(handle),
+    };
+}
+/** @internal */
+async function proxyUpstream(options) {
+    const { request, service, ctx, proxy } = options;
+    const url = ctx.upstreamPath + new URL(request.url).search;
+    const headers = Headers.scrub(request.headers);
+    const method = request.method.toUpperCase();
+    const hasBody = method !== 'GET' && method !== 'HEAD';
+    const init = {
+        method: request.method,
+        headers,
+        signal: request.signal,
+    };
+    if (hasBody && request.body) {
+        init.body = request.body;
+        init.duplex = 'half';
+    }
+    let upstreamReq = new globalThis.Request(new URL(url, new URL(service.baseUrl).origin), init);
+    if (service.rewriteRequest)
+        upstreamReq = await service.rewriteRequest(upstreamReq, ctx);
+    let upstreamRes = await proxy(upstreamReq);
+    upstreamRes = Headers.scrubResponse(upstreamRes);
+    if (service.rewriteResponse)
+        upstreamRes = await service.rewriteResponse(upstreamRes, ctx);
+    return upstreamRes;
+}
+//# sourceMappingURL=Proxy.js.map

package/dist/proxy/Proxy.js.map

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

package/dist/proxy/Service.d.ts

@@ -0,0 +1,100 @@
+/** A proxied upstream service with route definitions and optional request/response hooks. */
+export type Service = {
+    /** Unique identifier used as the URL prefix (e.g. `'openai'` → `/{id}/...`). */
+    id: string;
+    /** Base URL of the upstream service (e.g. `'https://api.openai.com'`). */
+    baseUrl: string;
+    /** Map of route patterns to endpoint handlers. */
+    routes: EndpointMap;
+    /** Hook to modify the upstream request before sending (e.g. inject auth headers). */
+    rewriteRequest?: ((req: Request, ctx: Context) => Request | Promise<Request>) | undefined;
+    /** Hook to modify the upstream response before returning to the client. */
+    rewriteResponse?: ((res: Response, ctx: Context) => Response | Promise<Response>) | undefined;
+};
+/**
+ * An endpoint definition.
+ *
+ * - `IntentHandler` — payment required, calls the handler to issue a 402 challenge or verify payment.
+ * - `{ pay, options }` — payment required with per-endpoint config overrides.
+ * - `true` — free passthrough, no payment required, rewriteRequest is applied.
+ */
+export type Endpoint = IntentHandler | {
+    pay: IntentHandler;
+    options: EndpointOptions;
+} | true;
+/** Map of `"METHOD /pattern"` keys to endpoint definitions. */
+export type EndpointMap<routes extends string = string> = Partial<Record<routes, Endpoint>> & Record<string & {}, Endpoint>;
+/** Per-endpoint configuration overrides (e.g. `{ apiKey: 'sk-...' }`). */
+export type EndpointOptions = {
+    [key: string]: unknown;
+};
+/** A function that handles the mppx payment flow for a request. */
+export type IntentHandler = (input: Request) => Promise<IntentResult>;
+/** Result of an intent handler — either a 402 challenge or a 200 with receipt attachment. */
+export type IntentResult = {
+    challenge: Response;
+    status: 402;
+} | {
+    status: 200;
+    withReceipt: <response>(response: response) => response;
+};
+/** Context passed to `rewriteRequest`/`rewriteResponse` hooks, including any per-endpoint options. */
+export type Context = {
+    request: Request;
+    service: Service;
+    upstreamPath: string;
+} & EndpointOptions;
+export type From<options extends {
+    routes: string;
+}> = {
+    routes: EndpointMap<options['routes']>;
+} & Omit<options, 'routes'>;
+/**
+ * Creates a service definition.
+ *
+ * @example
+ * ```ts
+ * Service.from('my-api', {
+ *   baseUrl: 'https://api.example.com',
+ *   bearer: 'sk-...',
+ *   routes: {
+ *     'POST /v1/generate': mppx.charge({ amount: '0.01' }),
+ *     'GET /v1/status': true,
+ *   },
+ * })
+ * ```
+ */
+export declare function from<options = unknown>(id: string, config: from.Config<options>): Service;
+export declare namespace from {
+    type Config<options = unknown> = {
+        /** Base URL of the upstream service. */
+        baseUrl: string;
+        /** Shorthand: inject `Authorization: Bearer {token}` header. */
+        bearer?: string | undefined;
+        /** Shorthand: inject custom headers. */
+        headers?: Record<string, string> | undefined;
+        /** Shorthand: full request mutation function. Takes priority over `bearer`/`headers`. */
+        mutate?: ((req: Request) => Request | Promise<Request>) | undefined;
+        /** Hook to modify the upstream request. Receives typed per-endpoint options via `ctx`. */
+        rewriteRequest?: ((req: Request, ctx: Context & Partial<options & {}>) => Request | Promise<Request>) | undefined;
+        /** Map of route patterns to endpoint definitions. */
+        routes: EndpointMap;
+    };
+}
+export { from as custom };
+/** Serializes a service for discovery responses. */
+export declare function serialize(s: Service): {
+    id: string;
+    baseUrl: string;
+    routes: {
+        method: string | undefined;
+        path: string;
+        pattern: string;
+        payment: Record<string, unknown> | null;
+    }[];
+};
+/** Renders an llms.txt markdown string for a list of services. */
+export declare function toLlmsTxt(services: Service[]): string;
+/** Extracts per-endpoint options from an endpoint definition. */
+export declare function getOptions(endpoint: Endpoint): EndpointOptions | undefined;
+//# sourceMappingURL=Service.d.ts.map

package/dist/proxy/Service.d.ts.map

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

package/dist/proxy/Service.js

@@ -0,0 +1,147 @@
+import { Value } from 'ox';
+/**
+ * Creates a service definition.
+ *
+ * @example
+ * ```ts
+ * Service.from('my-api', {
+ *   baseUrl: 'https://api.example.com',
+ *   bearer: 'sk-...',
+ *   routes: {
+ *     'POST /v1/generate': mppx.charge({ amount: '0.01' }),
+ *     'GET /v1/status': true,
+ *   },
+ * })
+ * ```
+ */
+export function from(id, config) {
+    const rewriteFromConfig = resolveRewriteRequest(config);
+    return {
+        id,
+        baseUrl: config.baseUrl,
+        routes: config.routes,
+        rewriteRequest: config.rewriteRequest
+            ? rewriteFromConfig
+                ? async (req, ctx) => {
+                    req = await rewriteFromConfig(req, ctx);
+                    return config.rewriteRequest(req, ctx);
+                }
+                : config.rewriteRequest
+            : rewriteFromConfig,
+    };
+}
+export { from as custom };
+function resolveRewriteRequest(config) {
+    if (config.mutate) {
+        const mutate = config.mutate;
+        return (req, ctx) => {
+            const options = ctx;
+            const m = options.mutate ?? mutate;
+            return m(req);
+        };
+    }
+    if (config.bearer) {
+        const bearer = config.bearer;
+        return (req, ctx) => {
+            const options = ctx;
+            req.headers.set('Authorization', `Bearer ${options.bearer ?? bearer}`);
+            return req;
+        };
+    }
+    if (config.headers) {
+        const headers = config.headers;
+        return (req, ctx) => {
+            const options = ctx;
+            const h = options.headers ?? headers;
+            for (const [name, value] of Object.entries(h))
+                req.headers.set(name, value);
+            return req;
+        };
+    }
+    return undefined;
+}
+/** Serializes a service for discovery responses. */
+export function serialize(s) {
+    return {
+        id: s.id,
+        baseUrl: s.baseUrl,
+        routes: Object.entries(s.routes).map(([pattern, endpoint]) => {
+            const tokens = pattern.trim().split(/\s+/);
+            const hasMethod = tokens.length >= 2;
+            return {
+                method: hasMethod ? tokens[0] : undefined,
+                path: hasMethod ? tokens.slice(1).join(' ') : tokens[0],
+                pattern,
+                payment: endpoint ? resolvePayment(endpoint) : null,
+            };
+        }),
+    };
+}
+/** Renders an llms.txt markdown string for a list of services. */
+export function toLlmsTxt(services) {
+    const lines = [
+        '# API Proxy',
+        '',
+        '> Paid API proxy powered by [Machine Payments Protocol](https://mpp.tempo.xyz).',
+        '',
+        'For machine-readable service data, use `GET /services` (JSON).',
+        '',
+    ];
+    if (services.length === 0)
+        return lines.join('\n');
+    lines.push('## Services', '');
+    for (const s of services) {
+        const serialized = serialize(s);
+        const free = serialized.routes.filter((r) => r.payment === null).length;
+        const paid = serialized.routes.length - free;
+        const parts = [paid && `${paid} paid`, free && `${free} free`].filter(Boolean).join(', ');
+        lines.push(`- [${s.id}](${s.baseUrl}): ${parts}`);
+    }
+    for (const s of services) {
+        const serialized = serialize(s);
+        lines.push('', `## ${s.id}`, '');
+        for (const route of serialized.routes) {
+            if (!route.payment) {
+                lines.push(`- \`${route.pattern}\`: Free`);
+                continue;
+            }
+            const p = route.payment;
+            const parts = [`${p.intent}`];
+            if (p.amount) {
+                const unit = `${p.amount} units`;
+                parts.push(p.unitType ? `${unit} per ${p.unitType}` : unit);
+            }
+            if (p.description)
+                parts.push(`"${p.description}"`);
+            const meta = [
+                p.currency && `currency: ${p.currency}`,
+                p.decimals !== undefined && `decimals: ${p.decimals}`,
+            ].filter(Boolean);
+            if (meta.length)
+                parts.push(`(${meta.join(', ')})`);
+            lines.push(`- \`${route.pattern}\`: ${parts.join(' — ')}`);
+        }
+    }
+    return lines.join('\n');
+}
+/** Extracts per-endpoint options from an endpoint definition. */
+export function getOptions(endpoint) {
+    if (typeof endpoint === 'object' && endpoint !== null && 'options' in endpoint)
+        return endpoint.options;
+    return undefined;
+}
+function resolvePayment(endpoint) {
+    if (endpoint === true)
+        return null;
+    const handler = typeof endpoint === 'function' ? endpoint : endpoint.pay;
+    if (!('_internal' in handler))
+        return {};
+    const { name, method, defaults, schema, ...rest } = handler._internal;
+    const amount = (() => {
+        if (typeof rest.amount === 'string' && typeof rest.decimals === 'number')
+            return String(Value.from(rest.amount, rest.decimals));
+        return rest.amount;
+    })();
+    return { intent: name, method, ...rest, ...(amount !== undefined && { amount }) };
+}
+//# sourceMappingURL=Service.js.map

package/dist/proxy/Service.js.map

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

package/dist/proxy/index.d.ts

@@ -0,0 +1,7 @@
+export * as Proxy from './Proxy.js';
+export * as Service from './Service.js';
+export { from as custom } from './Service.js';
+export { anthropic } from './services/anthropic.js';
+export { openai } from './services/openai.js';
+export { stripe } from './services/stripe.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/proxy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/proxy/index.js

@@ -0,0 +1,7 @@
+export * as Proxy from './Proxy.js';
+export * as Service from './Service.js';
+export { from as custom } from './Service.js';
+export { anthropic } from './services/anthropic.js';
+export { openai } from './services/openai.js';
+export { stripe } from './services/stripe.js';
+//# sourceMappingURL=index.js.map

package/dist/proxy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/proxy/internal/Headers.d.ts

@@ -0,0 +1,3 @@
+export declare function scrub(headers: Headers): Headers;
+export declare function scrubResponse(response: Response): Response;
+//# sourceMappingURL=Headers.d.ts.map

package/dist/proxy/internal/Headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Headers.d.ts","sourceRoot":"","sources":["../../../src/proxy/internal/Headers.ts"],"names":[],"mappings":"AAWA,wBAAgB,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAiB/C;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAS1D"}

package/dist/proxy/internal/Headers.js

@@ -0,0 +1,41 @@
+const hopByHopHeaders = new Set([
+    'connection',
+    'keep-alive',
+    'transfer-encoding',
+    'upgrade',
+    'proxy-authenticate',
+    'proxy-authorization',
+    'te',
+    'trailer',
+]);
+export function scrub(headers) {
+    const scrubbed = new Headers();
+    for (const [name, value] of headers) {
+        const lower = name.toLowerCase();
+        if (lower === 'authorization')
+            continue;
+        if (lower === 'accept-encoding')
+            continue;
+        if (lower === 'content-length')
+            continue;
+        if (lower === 'cookie')
+            continue;
+        if (hopByHopHeaders.has(lower))
+            continue;
+        if (lower.startsWith('x-forwarded-'))
+            continue;
+        scrubbed.append(name, value);
+    }
+    return scrubbed;
+}
+export function scrubResponse(response) {
+    const headers = new Headers(response.headers);
+    headers.delete('content-encoding');
+    headers.delete('content-length');
+    return new Response(response.body, {
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+    });
+}
+//# sourceMappingURL=Headers.js.map

package/dist/proxy/internal/Headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Headers.js","sourceRoot":"","sources":["../../../src/proxy/internal/Headers.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,YAAY;IACZ,YAAY;IACZ,mBAAmB;IACnB,SAAS;IACT,oBAAoB;IACpB,qBAAqB;IACrB,IAAI;IACJ,SAAS;CACV,CAAC,CAAA;AAEF,MAAM,UAAU,KAAK,CAAC,OAAgB;IACpC,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAE,CAAA;IAE9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAEhC,IAAI,KAAK,KAAK,eAAe;YAAE,SAAQ;QACvC,IAAI,KAAK,KAAK,iBAAiB;YAAE,SAAQ;QACzC,IAAI,KAAK,KAAK,gBAAgB;YAAE,SAAQ;QACxC,IAAI,KAAK,KAAK,QAAQ;YAAE,SAAQ;QAChC,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAQ;QACxC,IAAI,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC;YAAE,SAAQ;QAE9C,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC9B,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAkB;IAC9C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC7C,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAA;IAClC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;IAChC,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;QACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,OAAO;KACR,CAAC,CAAA;AACJ,CAAC"}

package/dist/proxy/internal/Route.d.ts

@@ -0,0 +1,14 @@
+export declare function pathname(url: URL, basePath?: string): string | null;
+export declare function parse(pathname: string): {
+    serviceId: string;
+    upstreamPath: string;
+} | null;
+export declare function match(routes: Record<string, unknown>, method: string, path: string): {
+    key: string;
+    value: unknown;
+} | null;
+export declare function matchPath(routes: Record<string, unknown>, path: string): {
+    key: string;
+    value: unknown;
+} | null;
+//# sourceMappingURL=Route.d.ts.map

package/dist/proxy/internal/Route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Route.d.ts","sourceRoot":"","sources":["../../../src/proxy/internal/Route.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQnE;AAED,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO1F;AAED,wBAAgB,KAAK,CACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAQxC;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,GACX;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAOxC"}

package/dist/proxy/internal/Route.js

@@ -0,0 +1,47 @@
+const httpMethods = new Set(['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS']);
+export function pathname(url, basePath) {
+    let pathname = url.pathname;
+    if (basePath) {
+        const base = basePath.replace(/\/+$/, '');
+        if (!pathname.startsWith(base))
+            return null;
+        pathname = pathname.slice(base.length);
+    }
+    return pathname;
+}
+export function parse(pathname) {
+    const segments = pathname.split('/').filter(Boolean);
+    const serviceId = segments[0];
+    if (!serviceId)
+        return null;
+    const upstreamPath = `/${segments.slice(1).join('/')}`;
+    return { serviceId, upstreamPath };
+}
+export function match(routes, method, path) {
+    for (const [key, value] of Object.entries(routes)) {
+        const { method: routeMethod, pattern } = parseRouteKey(key);
+        if (routeMethod && routeMethod !== method.toUpperCase())
+            continue;
+        const urlPattern = new URLPattern({ pathname: pattern });
+        if (urlPattern.test({ pathname: path }))
+            return { key, value };
+    }
+    return null;
+}
+export function matchPath(routes, path) {
+    for (const [key, value] of Object.entries(routes)) {
+        const { pattern } = parseRouteKey(key);
+        const urlPattern = new URLPattern({ pathname: pattern });
+        if (urlPattern.test({ pathname: path }))
+            return { key, value };
+    }
+    return null;
+}
+function parseRouteKey(key) {
+    const tokens = key.trim().split(/\s+/);
+    if (tokens.length >= 2 && httpMethods.has(tokens[0].toUpperCase())) {
+        return { method: tokens[0].toUpperCase(), pattern: tokens.slice(1).join(' ') };
+    }
+    return { method: undefined, pattern: key };
+}
+//# sourceMappingURL=Route.js.map

package/dist/proxy/internal/Route.js.map

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

package/dist/proxy/services/anthropic.d.ts

@@ -0,0 +1,29 @@
+import * as Service from '../Service.js';
+/**
+ * Creates an Anthropic service definition.
+ *
+ * Injects `x-api-key` header for upstream authentication.
+ * Per-endpoint `apiKey` overrides are supported via `options`.
+ *
+ * @example
+ * ```ts
+ * anthropic({
+ *   apiKey: 'sk-ant-...',
+ *   routes: {
+ *     'POST /v1/messages': mppx.charge({ amount: '0.03' }),
+ *     'POST /v1/complete': mppx.charge({ amount: '0.02' }),
+ *   },
+ * })
+ * ```
+ */
+export declare function anthropic(config: anthropic.Config): Service.Service;
+export declare namespace anthropic {
+    type Config = Service.From<{
+        /** Anthropic API key. Used as `x-api-key` header. */
+        apiKey: string;
+        /** Base URL override. Defaults to `'https://api.anthropic.com'`. */
+        baseUrl?: string | undefined;
+        routes: 'POST /v1/messages' | 'POST /v1/messages/batches' | 'GET /v1/messages/batches' | 'GET /v1/messages/batches/:batchId' | 'POST /v1/complete';
+    }>;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/proxy/services/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/proxy/services/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AAExC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,mBAUjD;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAY,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;QAChC,qDAAqD;QACrD,MAAM,EAAE,MAAM,CAAA;QACd,oEAAoE;QACpE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC5B,MAAM,EACF,mBAAmB,GACnB,2BAA2B,GAC3B,0BAA0B,GAC1B,mCAAmC,GACnC,mBAAmB,CAAA;KACxB,CAAC,CAAA;CACH"}