mppx 0.4.9 → 0.4.10

package/dist/discovery/OpenApi.d.ts

@@ -0,0 +1,61 @@
+import type * as Method from '../Method.js';
+import type { ServiceInfo } from './Discovery.js';
+export type DiscoveryHandler = ((...args: any[]) => unknown) & {
+    _internal?: {
+        _canonicalRequest: Record<string, unknown>;
+        intent: string;
+        name: string;
+    };
+};
+export type LegacyRouteConfig = {
+    intent: string;
+    method: string;
+    options: Record<string, unknown>;
+    path: string;
+    requestBody?: Record<string, unknown>;
+    summary?: string;
+};
+export type HandlerRouteConfig = {
+    handler: DiscoveryHandler;
+    method: string;
+    path: string;
+    requestBody?: Record<string, unknown>;
+    summary?: string;
+};
+export type RouteConfig = HandlerRouteConfig | LegacyRouteConfig;
+export type GenerateConfig = {
+    info?: {
+        title?: string;
+        version?: string;
+    } | undefined;
+    routes: RouteConfig[];
+    serviceInfo?: ServiceInfo | undefined;
+};
+export type GenerateProxyConfig = {
+    basePath?: string | undefined;
+    info?: {
+        title?: string;
+        version?: string;
+    } | undefined;
+    routes: Array<{
+        method: string;
+        path: string;
+        payment: Record<string, unknown> | null;
+        requestBody?: Record<string, unknown>;
+        summary?: string;
+    }>;
+    serviceInfo?: ServiceInfo | undefined;
+};
+/**
+ * Generates an OpenAPI 3.1.0 discovery document from an mppx instance
+ * and route configuration.
+ */
+export declare function generate(mppx: {
+    methods: readonly Method.AnyServer[];
+    realm: string;
+}, config: GenerateConfig): Record<string, unknown>;
+/**
+ * Generates an OpenAPI 3.1.0 discovery document for a proxy surface.
+ */
+export declare function generateProxy(config: GenerateProxyConfig): Record<string, unknown>;
+//# sourceMappingURL=OpenApi.d.ts.map

package/dist/discovery/OpenApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApi.d.ts","sourceRoot":"","sources":["../../src/discovery/OpenApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG;IAC7D,SAAS,CAAC,EAAE;QACV,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC1C,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;CACF,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,gBAAgB,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,iBAAiB,CAAA;AAEhE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IACvD,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IACvD,MAAM,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;QACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACrC,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAC,CAAA;IACF,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CACtC,CAAA;AAUD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE;IAAE,OAAO,EAAE,SAAS,MAAM,CAAC,SAAS,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC7D,MAAM,EAAE,cAAc,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBzB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAclF"}

package/dist/discovery/OpenApi.js

@@ -0,0 +1,139 @@
+/**
+ * Generates an OpenAPI 3.1.0 discovery document from an mppx instance
+ * and route configuration.
+ */
+export function generate(mppx, config) {
+    const methods = mppx.methods;
+    const methodsByKey = new Map();
+    const intentCount = {};
+    for (const mi of methods) {
+        methodsByKey.set(`${mi.name}/${mi.intent}`, mi);
+        intentCount[mi.intent] = (intentCount[mi.intent] ?? 0) + 1;
+    }
+    for (const mi of methods) {
+        if (intentCount[mi.intent] === 1)
+            methodsByKey.set(mi.intent, mi);
+    }
+    const routes = config.routes.map((route) => resolveRoute(route, methodsByKey));
+    return createDocument({
+        info: {
+            title: config.info?.title ?? mppx.realm,
+            version: config.info?.version ?? '1.0.0',
+        },
+        routes,
+        serviceInfo: config.serviceInfo,
+    });
+}
+/**
+ * Generates an OpenAPI 3.1.0 discovery document for a proxy surface.
+ */
+export function generateProxy(config) {
+    const routes = config.routes.map((route) => ({
+        ...route,
+        path: withBasePath(config.basePath, route.path),
+    }));
+    return createDocument({
+        info: {
+            title: config.info?.title ?? 'API Proxy',
+            version: config.info?.version ?? '1.0.0',
+        },
+        routes,
+        serviceInfo: config.serviceInfo,
+    });
+}
+function createDocument(config) {
+    const paths = {};
+    for (const route of config.routes) {
+        const method = route.method.toLowerCase();
+        const operation = {
+            responses: {
+                ...(route.payment ? { '402': { description: 'Payment Required' } } : {}),
+                '200': { description: 'Successful response' },
+            },
+        };
+        if (route.payment)
+            operation['x-payment-info'] = route.payment;
+        if (route.summary)
+            operation.summary = route.summary;
+        if (route.requestBody)
+            operation.requestBody = route.requestBody;
+        if (!paths[route.path])
+            paths[route.path] = {};
+        paths[route.path][method] = operation;
+    }
+    const doc = {
+        info: config.info,
+        openapi: '3.1.0',
+        paths,
+    };
+    if (config.serviceInfo)
+        doc['x-service-info'] = config.serviceInfo;
+    return doc;
+}
+function resolveRoute(route, methodsByKey) {
+    if ('handler' in route) {
+        const internal = route.handler._internal;
+        if (!internal)
+            throw new Error(`Route ${route.method.toUpperCase()} ${route.path} is missing discovery metadata`);
+        return {
+            method: route.method,
+            path: route.path,
+            payment: paymentInfoFromCanonical({
+                canonicalRequest: internal._canonicalRequest,
+                intent: internal.intent,
+                method: internal.name,
+            }),
+            ...(route.requestBody ? { requestBody: route.requestBody } : {}),
+            ...(route.summary ? { summary: route.summary } : {}),
+        };
+    }
+    const mi = methodsByKey.get(route.intent);
+    if (!mi) {
+        throw new Error(`Unknown intent "${route.intent}" for route ${route.method.toUpperCase()} ${route.path}. Available: ${[...methodsByKey.keys()].join(', ')}`);
+    }
+    return {
+        method: route.method,
+        path: route.path,
+        payment: paymentInfoFromCanonical({
+            canonicalRequest: route.options,
+            intent: mi.intent,
+            method: mi.name,
+        }),
+        ...(route.requestBody ? { requestBody: route.requestBody } : {}),
+        ...(route.summary ? { summary: route.summary } : {}),
+    };
+}
+function paymentInfoFromCanonical(route) {
+    const { canonicalRequest, intent, method } = route;
+    const methodDetails = (canonicalRequest.methodDetails ?? {});
+    const amount = pickString(canonicalRequest.amount) ?? pickString(methodDetails.amount) ?? null;
+    const currency = pickString(canonicalRequest.currency) ?? pickString(methodDetails.currency);
+    const description = pickString(canonicalRequest.description);
+    const base = {
+        amount,
+        ...(currency ? { currency } : {}),
+        ...(description ? { description } : {}),
+        intent,
+        method,
+    };
+    // Forward any extra canonical params that aren't already covered.
+    const reserved = new Set(['amount', 'currency', 'description', 'methodDetails']);
+    for (const [key, value] of Object.entries(canonicalRequest)) {
+        if (!reserved.has(key) && value !== undefined)
+            base[key] = value;
+    }
+    return base;
+}
+function pickString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function withBasePath(basePath, path) {
+    if (!basePath)
+        return path;
+    const normalizedBasePath = basePath.startsWith('/') ? basePath : `/${basePath}`;
+    const trimmedBasePath = normalizedBasePath.endsWith('/')
+        ? normalizedBasePath.slice(0, -1)
+        : normalizedBasePath;
+    return `${trimmedBasePath}${path}`;
+}
+//# sourceMappingURL=OpenApi.js.map

package/dist/discovery/OpenApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApi.js","sourceRoot":"","sources":["../../src/discovery/OpenApi.ts"],"names":[],"mappings":"AAyDA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,IAA6D,EAC7D,MAAsB;IAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;IAC5B,MAAM,YAAY,GAAG,IAAI,GAAG,EAA4B,CAAA;IACxD,MAAM,WAAW,GAA2B,EAAE,CAAA;IAE9C,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;QAC/C,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;IAC5D,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,IAAI,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAA;IAC9E,OAAO,cAAc,CAAC;QACpB,IAAI,EAAE;YACJ,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK;YACvC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,IAAI,OAAO;SACzC;QACD,MAAM;QACN,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAA2B;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3C,GAAG,KAAK;QACR,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC;KAChD,CAAC,CAAC,CAAA;IAEH,OAAO,cAAc,CAAC;QACpB,IAAI,EAAE;YACJ,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,WAAW;YACxC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,IAAI,OAAO;SACzC;QACD,MAAM;QACN,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,MAIvB;IACC,MAAM,KAAK,GAA4C,EAAE,CAAA;IAEzD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;QACzC,MAAM,SAAS,GAA4B;YACzC,SAAS,EAAE;gBACT,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxE,KAAK,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE;aAC9C;SACF,CAAA;QAED,IAAI,KAAK,CAAC,OAAO;YAAE,SAAS,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAA;QAC9D,IAAI,KAAK,CAAC,OAAO;YAAE,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;QACpD,IAAI,KAAK,CAAC,WAAW;YAAE,SAAS,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAA;QAEhE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;QAC9C,KAAK,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC,MAAM,CAAC,GAAG,SAAS,CAAA;IACxC,CAAC;IAED,MAAM,GAAG,GAA4B;QACnC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,OAAO;QAChB,KAAK;KACN,CAAA;IACD,IAAI,MAAM,CAAC,WAAW;QAAE,GAAG,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,WAAW,CAAA;IAClE,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,YAAY,CACnB,KAAkB,EAClB,YAA2C;IAE3C,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAA;QACxC,IAAI,CAAC,QAAQ;YACX,MAAM,IAAI,KAAK,CACb,SAAS,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,gCAAgC,CAClF,CAAA;QACH,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,wBAAwB,CAAC;gBAChC,gBAAgB,EAAE,QAAQ,CAAC,iBAAiB;gBAC5C,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,MAAM,EAAE,QAAQ,CAAC,IAAI;aACtB,CAAC;YACF,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD,CAAA;IACH,CAAC;IAED,MAAM,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACzC,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CACb,mBAAmB,KAAK,CAAC,MAAM,eAAe,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,gBAAgB,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5I,CAAA;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,wBAAwB,CAAC;YAChC,gBAAgB,EAAE,KAAK,CAAC,OAAO;YAC/B,MAAM,EAAE,EAAE,CAAC,MAAM;YACjB,MAAM,EAAE,EAAE,CAAC,IAAI;SAChB,CAAC;QACF,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAA;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,KAIjC;IACC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IAClD,MAAM,aAAa,GAAG,CAAC,gBAAgB,CAAC,aAAa,IAAI,EAAE,CAA4B,CAAA;IAEvF,MAAM,MAAM,GAAG,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,IAAI,CAAA;IAC9F,MAAM,QAAQ,GAAG,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC5F,MAAM,WAAW,GAAG,UAAU,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAE5D,MAAM,IAAI,GAA4B;QACpC,MAAM;QACN,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,MAAM;QACN,MAAM;KACP,CAAA;IAED,kEAAkE;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,CAAA;IAChF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IAClE,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AACtD,CAAC;AAED,SAAS,YAAY,CAAC,QAA4B,EAAE,IAAY;IAC9D,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC1B,MAAM,kBAAkB,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAA;IAC/E,MAAM,eAAe,GAAG,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC;QACtD,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,kBAAkB,CAAA;IACtB,OAAO,GAAG,eAAe,GAAG,IAAI,EAAE,CAAA;AACpC,CAAC"}

package/dist/discovery/Validate.d.ts

@@ -0,0 +1,10 @@
+export type ValidationError = {
+    message: string;
+    path: string;
+    severity: 'error' | 'warning';
+};
+/**
+ * Validates a discovery document structurally and semantically.
+ */
+export declare function validate(doc: unknown): ValidationError[];
+//# sourceMappingURL=Validate.d.ts.map

package/dist/discovery/Validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validate.d.ts","sourceRoot":"","sources":["../../src/discovery/Validate.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;CAC9B,CAAA;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,EAAE,CAgExD"}

package/dist/discovery/Validate.js

@@ -0,0 +1,63 @@
+import { DiscoveryDocument, PaymentInfo } from './Discovery.js';
+/**
+ * Validates a discovery document structurally and semantically.
+ */
+export function validate(doc) {
+    const errors = [];
+    const result = DiscoveryDocument.safeParse(doc);
+    if (!result.success) {
+        for (const issue of result.error.issues) {
+            errors.push({
+                message: issue.message,
+                path: issue.path.map(String).join('.') || '(root)',
+                severity: 'error',
+            });
+        }
+        return errors;
+    }
+    const parsed = result.data;
+    const paths = parsed.paths;
+    if (!paths)
+        return errors;
+    for (const [pathKey, pathItem] of Object.entries(paths)) {
+        for (const [method, operation] of Object.entries(pathItem)) {
+            if (!operation || typeof operation !== 'object' || Array.isArray(operation))
+                continue;
+            const op = operation;
+            const opPath = `paths.${pathKey}.${method}`;
+            const rawPaymentInfo = op['x-payment-info'];
+            if (!rawPaymentInfo)
+                continue;
+            const paymentResult = PaymentInfo.safeParse(rawPaymentInfo);
+            if (!paymentResult.success) {
+                for (const issue of paymentResult.error.issues) {
+                    errors.push({
+                        message: issue.message,
+                        path: `${opPath}.x-payment-info.${issue.path.map(String).join('.')}`,
+                        severity: 'error',
+                    });
+                }
+                continue;
+            }
+            const responses = op.responses;
+            if (!responses || !('402' in responses)) {
+                errors.push({
+                    message: 'Operation with x-payment-info MUST have a 402 response',
+                    path: `${opPath}.responses`,
+                    severity: 'error',
+                });
+            }
+            const methodUpper = method.toUpperCase();
+            if (!op.requestBody &&
+                (methodUpper === 'POST' || methodUpper === 'PUT' || methodUpper === 'PATCH')) {
+                errors.push({
+                    message: 'Operation with x-payment-info has no requestBody',
+                    path: opPath,
+                    severity: 'warning',
+                });
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=Validate.js.map

package/dist/discovery/Validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validate.js","sourceRoot":"","sources":["../../src/discovery/Validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAQ/D;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,MAAM,MAAM,GAAsB,EAAE,CAAA;IAEpC,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ;gBAClD,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAA;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC1B,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAA;IAEzB,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAmC,CAAC,EAAE,CAAC;YACtF,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;gBAAE,SAAQ;YACrF,MAAM,EAAE,GAAG,SAAoC,CAAA;YAE/C,MAAM,MAAM,GAAG,SAAS,OAAO,IAAI,MAAM,EAAE,CAAA;YAC3C,MAAM,cAAc,GAAG,EAAE,CAAC,gBAAgB,CAAC,CAAA;YAC3C,IAAI,CAAC,cAAc;gBAAE,SAAQ;YAE7B,MAAM,aAAa,GAAG,WAAW,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;YAC3D,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;gBAC3B,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;oBAC/C,MAAM,CAAC,IAAI,CAAC;wBACV,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,IAAI,EAAE,GAAG,MAAM,mBAAmB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;wBACpE,QAAQ,EAAE,OAAO;qBAClB,CAAC,CAAA;gBACJ,CAAC;gBACD,SAAQ;YACV,CAAC;YAED,MAAM,SAAS,GAAG,EAAE,CAAC,SAAgD,CAAA;YACrE,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,IAAI,SAAS,CAAC,EAAE,CAAC;gBACxC,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO,EAAE,wDAAwD;oBACjE,IAAI,EAAE,GAAG,MAAM,YAAY;oBAC3B,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAA;YACJ,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;YACxC,IACE,CAAC,EAAE,CAAC,WAAW;gBACf,CAAC,WAAW,KAAK,MAAM,IAAI,WAAW,KAAK,KAAK,IAAI,WAAW,KAAK,OAAO,CAAC,EAC5E,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO,EAAE,kDAAkD;oBAC3D,IAAI,EAAE,MAAM;oBACZ,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/discovery/index.d.ts

@@ -0,0 +1,4 @@
+export * from './Discovery.js';
+export * from './OpenApi.js';
+export * from './Validate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA"}

package/dist/discovery/index.js

@@ -0,0 +1,4 @@
+export * from './Discovery.js';
+export * from './OpenApi.js';
+export * from './Validate.js';
+//# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA"}

package/dist/middlewares/elysia.d.ts

@@ -1,4 +1,5 @@
-import type { Context } from 'elysia';
+import { Elysia, type Context } from 'elysia';
+import { type GenerateConfig, type RouteConfig } from '../discovery/OpenApi.js';
 import * as Mppx_core from '../server/Mppx.js';
 import * as Mppx_internal from './internal/mppx.js';
 export * from '../server/Methods.js';
@@ -48,4 +49,54 @@ export declare namespace Mppx {
  * ```
  */
 export declare function payment<const intent extends Mppx_internal.AnyMethodFn>(intent: intent, options: intent extends (options: infer options) => any ? options : never): ElysiaHook;
+export type DiscoveryConfig = Omit<GenerateConfig, 'routes'> & {
+    path?: string;
+    routes?: RouteConfig[];
+};
+/**
+ * Returns an Elysia plugin that serves an OpenAPI discovery document.
+ */
+export declare function discovery(mppx: {
+    methods: readonly Mppx_internal.AnyServer[];
+    realm: string;
+}, config?: DiscoveryConfig): Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: Response;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
 //# sourceMappingURL=elysia.d.ts.map

package/dist/middlewares/elysia.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elysia.d.ts","sourceRoot":"","sources":["../../src/middlewares/elysia.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAErC,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAEpC,KAAK,UAAU,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAA;AAErE,yBAAiB,IAAI,CAAC;IACpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAgB,MAAM,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,CAAC,OAAO,EAC5D,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GACvC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,CAEzD;CACF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,WAAW,EACpE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,GAAG,GAAG,OAAO,GAAG,KAAK,GACxE,UAAU,CAQZ"}
+{"version":3,"file":"elysia.d.ts","sourceRoot":"","sources":["../../src/middlewares/elysia.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAY,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACzF,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAEpC,KAAK,UAAU,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAA;AAErE,yBAAiB,IAAI,CAAC;IACpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAgB,MAAM,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,CAAC,OAAO,EAC5D,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GACvC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,CAEzD;CACF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,WAAW,EACpE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,GAAG,GAAG,OAAO,GAAG,KAAK,GACxE,UAAU,CAQZ;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,GAAG;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;CACvB,CAAA;AAID;;GAEG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE;IAAE,OAAO,EAAE,SAAS,aAAa,CAAC,SAAS,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACpE,MAAM,GAAE,eAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmB7B"}

package/dist/middlewares/elysia.js

@@ -1,3 +1,5 @@
+import { Elysia } from 'elysia';
+import { generate } from '../discovery/OpenApi.js';
 import * as Mppx_core from '../server/Mppx.js';
 import * as Mppx_internal from './internal/mppx.js';
 export * from '../server/Methods.js';
@@ -60,4 +62,19 @@ export function payment(intent, options) {
             set.headers['Payment-Receipt'] = header;
     };
 }
+const discoveryHeaders = { 'Cache-Control': 'public, max-age=300' };
+/**
+ * Returns an Elysia plugin that serves an OpenAPI discovery document.
+ */
+export function discovery(mppx, config = {}) {
+    const mountPath = config.path ?? '/openapi.json';
+    const cached = JSON.stringify(generate(mppx, {
+        ...(config.info ? { info: config.info } : {}),
+        routes: config.routes ?? [],
+        ...(config.serviceInfo ? { serviceInfo: config.serviceInfo } : {}),
+    }));
+    return new Elysia().get(mountPath, () => new Response(cached, {
+        headers: { ...discoveryHeaders, 'Content-Type': 'application/json' },
+    }));
+}
 //# sourceMappingURL=elysia.js.map

package/dist/middlewares/elysia.js.map

@@ -1 +1 @@
-{"version":3,"file":"elysia.js","sourceRoot":"","sources":["../../src/middlewares/elysia.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAIpC,MAAM,KAAW,IAAI,CA2BpB;AA3BD,WAAiB,IAAI;IACnB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAgB,MAAM,CACpB,MAAwC;QAExC,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA;IAC9D,CAAC;IAJe,WAAM,SAIrB,CAAA;AACH,CAAC,EA3BgB,IAAI,KAAJ,IAAI,QA2BpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,OAAO,CACrB,MAAc,EACd,OAAyE;IAEzE,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;QAChC,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,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAA;QAClD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;QACrD,IAAI,MAAM;YAAE,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAAA;IACrD,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"elysia.js","sourceRoot":"","sources":["../../src/middlewares/elysia.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgB,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,QAAQ,EAAyC,MAAM,yBAAyB,CAAA;AACzF,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAIpC,MAAM,KAAW,IAAI,CA2BpB;AA3BD,WAAiB,IAAI;IACnB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAgB,MAAM,CACpB,MAAwC;QAExC,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA;IAC9D,CAAC;IAJe,WAAM,SAIrB,CAAA;AACH,CAAC,EA3BgB,IAAI,KAAJ,IAAI,QA2BpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,OAAO,CACrB,MAAc,EACd,OAAyE;IAEzE,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;QAChC,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,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAA;QAClD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;QACrD,IAAI,MAAM;YAAE,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAAA;IACrD,CAAC,CAAA;AACH,CAAC;AAOD,MAAM,gBAAgB,GAAG,EAAE,eAAe,EAAE,qBAAqB,EAAE,CAAA;AAEnE;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,IAAoE,EACpE,SAA0B,EAAE;IAE5B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,IAAI,eAAe,CAAA;IAEhD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAC3B,QAAQ,CAAC,IAAI,EAAE;QACb,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC,CACH,CAAA;IAED,OAAO,IAAI,MAAM,EAAE,CAAC,GAAG,CACrB,SAAS,EACT,GAAG,EAAE,CACH,IAAI,QAAQ,CAAC,MAAM,EAAE;QACnB,OAAO,EAAE,EAAE,GAAG,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE;KACrE,CAAC,CACL,CAAA;AACH,CAAC"}

package/dist/middlewares/express.d.ts

@@ -1,4 +1,5 @@
-import type { RequestHandler } from 'express';
+import type { Express, RequestHandler } from 'express';
+import { type GenerateConfig, type RouteConfig } from '../discovery/OpenApi.js';
 import * as Mppx_core from '../server/Mppx.js';
 import * as Mppx_internal from './internal/mppx.js';
 export * from '../server/Methods.js';
@@ -43,4 +44,15 @@ export declare namespace Mppx {
  * ```
  */
 export declare function payment<const intent extends Mppx_internal.AnyMethodFn>(intent: intent, options: intent extends (options: infer options) => any ? options : never): RequestHandler;
+export type DiscoveryConfig = Omit<GenerateConfig, 'routes'> & {
+    path?: string;
+    routes?: RouteConfig[];
+};
+/**
+ * Mounts a `GET /openapi.json` route that serves an OpenAPI discovery document.
+ */
+export declare function discovery(app: Express, mppx: {
+    methods: readonly Mppx_internal.AnyServer[];
+    realm: string;
+}, config?: DiscoveryConfig): void;
 //# sourceMappingURL=express.d.ts.map

package/dist/middlewares/express.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/middlewares/express.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,SAAS,CAAA;AAEhB,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAEpC,yBAAiB,IAAI,CAAC;IACpB;;;;;;;;;;;;;;;;OAgBG;IACH,SAAgB,MAAM,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,CAAC,OAAO,EAC5D,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GACvC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,CAE7D;CACF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,WAAW,EACpE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,GAAG,GAAG,OAAO,GAAG,KAAK,GACxE,cAAc,CAyBhB"}
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/middlewares/express.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAIP,cAAc,EACf,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAY,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACzF,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAEpC,yBAAiB,IAAI,CAAC;IACpB;;;;;;;;;;;;;;;;OAgBG;IACH,SAAgB,MAAM,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,CAAC,OAAO,EAC5D,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GACvC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,CAE7D;CACF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,WAAW,EACpE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,GAAG,GAAG,OAAO,GAAG,KAAK,GACxE,cAAc,CAyBhB;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,GAAG;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;CACvB,CAAA;AAID;;GAEG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE;IAAE,OAAO,EAAE,SAAS,aAAa,CAAC,SAAS,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACpE,MAAM,GAAE,eAAoB,GAC3B,IAAI,CAgBN"}

package/dist/middlewares/express.js

@@ -1,3 +1,4 @@
+import { generate } from '../discovery/OpenApi.js';
 import * as Mppx_core from '../server/Mppx.js';
 import * as Mppx_internal from './internal/mppx.js';
 export * from '../server/Methods.js';
@@ -69,4 +70,21 @@ export function payment(intent, options) {
         next();
     };
 }
+const discoveryHeaders = { 'Cache-Control': 'public, max-age=300' };
+/**
+ * Mounts a `GET /openapi.json` route that serves an OpenAPI discovery document.
+ */
+export function discovery(app, mppx, config = {}) {
+    const mountPath = config.path ?? '/openapi.json';
+    const cached = JSON.stringify(generate(mppx, {
+        ...(config.info ? { info: config.info } : {}),
+        routes: config.routes ?? [],
+        ...(config.serviceInfo ? { serviceInfo: config.serviceInfo } : {}),
+    }));
+    app.get(mountPath, (_req, res) => {
+        res.setHeader('Cache-Control', discoveryHeaders['Cache-Control']);
+        res.setHeader('Content-Type', 'application/json');
+        res.end(cached);
+    });
+}
 //# sourceMappingURL=express.js.map

package/dist/middlewares/express.js.map

@@ -1 +1 @@
-{"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/middlewares/express.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAEpC,MAAM,KAAW,IAAI,CAuBpB;AAvBD,WAAiB,IAAI;IACnB;;;;;;;;;;;;;;;;OAgBG;IACH,SAAgB,MAAM,CACpB,MAAwC;QAExC,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA;IAC9D,CAAC;IAJe,WAAM,SAIrB,CAAA;AACH,CAAC,EAvBgB,IAAI,KAAJ,IAAI,QAuBpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,OAAO,CACrB,MAAc,EACd,OAAyE;IAEzE,OAAO,KAAK,EAAE,GAAmB,EAAE,GAAoB,EAAE,IAAkB,EAAE,EAAE;QAC7E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,EAAE;YACjF,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,CAAC,OAAiC;SAC/C,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAA;QAE7C,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAqB,CAAA;YAC9C,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;YAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,OAAO;gBAAE,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACvE,GAAG,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,CAAA;YAChC,OAAM;QACR,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACvC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAS,EAAE,EAAE;YACvB,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;YACvD,GAAG,CAAC,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAE,CAAC,CAAA;YACzE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC,CAAA;QAED,IAAI,EAAE,CAAA;IACR,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/middlewares/express.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAAyC,MAAM,yBAAyB,CAAA;AACzF,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAEpC,MAAM,KAAW,IAAI,CAuBpB;AAvBD,WAAiB,IAAI;IACnB;;;;;;;;;;;;;;;;OAgBG;IACH,SAAgB,MAAM,CACpB,MAAwC;QAExC,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA;IAC9D,CAAC;IAJe,WAAM,SAIrB,CAAA;AACH,CAAC,EAvBgB,IAAI,KAAJ,IAAI,QAuBpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,OAAO,CACrB,MAAc,EACd,OAAyE;IAEzE,OAAO,KAAK,EAAE,GAAmB,EAAE,GAAoB,EAAE,IAAkB,EAAE,EAAE;QAC7E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,EAAE;YACjF,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,CAAC,OAAiC;SAC/C,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAA;QAE7C,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAqB,CAAA;YAC9C,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;YAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,OAAO;gBAAE,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACvE,GAAG,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,CAAA;YAChC,OAAM;QACR,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACvC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAS,EAAE,EAAE;YACvB,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;YACvD,GAAG,CAAC,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAE,CAAC,CAAA;YACzE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC,CAAA;QAED,IAAI,EAAE,CAAA;IACR,CAAC,CAAA;AACH,CAAC;AAOD,MAAM,gBAAgB,GAAG,EAAE,eAAe,EAAE,qBAAqB,EAAE,CAAA;AAEnE;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,GAAY,EACZ,IAAoE,EACpE,SAA0B,EAAE;IAE5B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,IAAI,eAAe,CAAA;IAEhD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAC3B,QAAQ,CAAC,IAAI,EAAE;QACb,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC,CACH,CAAA;IAED,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAoB,EAAE,GAAoB,EAAE,EAAE;QAChE,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAA;QACjE,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAA;QACjD,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/middlewares/hono.d.ts

@@ -1,4 +1,5 @@
-import type { MiddlewareHandler } from 'hono';
+import type { Hono, MiddlewareHandler } from 'hono';
+import { type GenerateConfig, type RouteConfig } from '../discovery/OpenApi.js';
 import * as Mppx_core from '../server/Mppx.js';
 import * as Mppx_internal from './internal/mppx.js';
 export * from '../server/Methods.js';
@@ -43,4 +44,21 @@ export declare namespace Mppx {
  * ```
  */
 export declare function payment<const intent extends Mppx_internal.AnyMethodFn>(intent: intent, options: intent extends (options: infer options) => any ? options : never): MiddlewareHandler;
+export type DiscoveryConfig = Omit<GenerateConfig, 'routes'> & {
+    auto?: boolean;
+    path?: string;
+    routes?: RouteConfig[];
+};
+/**
+ * Mounts a `GET /openapi.json` route that serves an OpenAPI discovery document.
+ *
+ * When `auto` is true, routes are introspected from Hono's internal `app.routes`
+ * array. This is a **best-effort / experimental** convenience — `app.routes` is
+ * not part of Hono's stable public API and may change across versions. Prefer
+ * passing explicit `routes` for production use.
+ */
+export declare function discovery(app: Hono<any>, mppx: {
+    methods: readonly Mppx_internal.AnyServer[];
+    realm: string;
+}, config?: DiscoveryConfig): void;
 //# sourceMappingURL=hono.d.ts.map

package/dist/middlewares/hono.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../../src/middlewares/hono.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAE7C,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAEpC,yBAAiB,IAAI,CAAC;IACpB;;;;;;;;;;;;;;;;OAgBG;IACH,SAAgB,MAAM,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,CAAC,OAAO,EAC5D,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GACvC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAEhE;CACF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,WAAW,EACpE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,GAAG,GAAG,OAAO,GAAG,KAAK,GACxE,iBAAiB,CAOnB"}
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../../src/middlewares/hono.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAEnD,OAAO,EAAY,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACzF,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAEpC,yBAAiB,IAAI,CAAC;IACpB;;;;;;;;;;;;;;;;OAgBG;IACH,SAAgB,MAAM,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,CAAC,OAAO,EAC5D,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GACvC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAEhE;CACF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,MAAM,SAAS,aAAa,CAAC,WAAW,EACpE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,GAAG,GAAG,OAAO,GAAG,KAAK,GACxE,iBAAiB,CAOnB;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,GAAG;IAC7D,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;CACvB,CAAA;AAID;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,EACd,IAAI,EAAE;IAAE,OAAO,EAAE,SAAS,aAAa,CAAC,SAAS,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACpE,MAAM,GAAE,eAAoB,GAC3B,IAAI,CAoBN"}

package/dist/middlewares/hono.js

@@ -1,3 +1,4 @@
+import { generate } from '../discovery/OpenApi.js';
 import * as Mppx_core from '../server/Mppx.js';
 import * as Mppx_internal from './internal/mppx.js';
 export * from '../server/Methods.js';
@@ -54,4 +55,54 @@ export function payment(intent, options) {
         c.res = result.withReceipt(c.res);
     };
 }
+const discoveryHeaders = { 'Cache-Control': 'public, max-age=300' };
+/**
+ * Mounts a `GET /openapi.json` route that serves an OpenAPI discovery document.
+ *
+ * When `auto` is true, routes are introspected from Hono's internal `app.routes`
+ * array. This is a **best-effort / experimental** convenience — `app.routes` is
+ * not part of Hono's stable public API and may change across versions. Prefer
+ * passing explicit `routes` for production use.
+ */
+export function discovery(app, mppx, config = {}) {
+    const mountPath = config.path ?? '/openapi.json';
+    let cached;
+    app.get(mountPath, (c) => {
+        if (!cached) {
+            const routes = config.routes ?? (config.auto ? introspectRoutes(app) : []);
+            const doc = generate(mppx, {
+                ...(config.info ? { info: config.info } : {}),
+                routes,
+                ...(config.serviceInfo ? { serviceInfo: config.serviceInfo } : {}),
+            });
+            cached = JSON.stringify(doc);
+        }
+        c.header('Cache-Control', discoveryHeaders['Cache-Control']);
+        c.header('Content-Type', 'application/json');
+        return c.body(cached);
+    });
+}
+function introspectRoutes(app) {
+    const routes = [];
+    const appRoutes = app.routes;
+    if (!appRoutes)
+        return routes;
+    const seen = new Set();
+    for (const route of appRoutes) {
+        const internal = route.handler
+            ?._internal;
+        if (!internal)
+            continue;
+        const key = `${route.method}:${route.path}:${internal.name}/${internal.intent}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        routes.push({
+            handler: route.handler,
+            method: route.method,
+            path: route.path,
+        });
+    }
+    return routes;
+}
 //# sourceMappingURL=hono.js.map

package/dist/middlewares/hono.js.map

@@ -1 +1 @@
-{"version":3,"file":"hono.js","sourceRoot":"","sources":["../../src/middlewares/hono.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAEpC,MAAM,KAAW,IAAI,CAuBpB;AAvBD,WAAiB,IAAI;IACnB;;;;;;;;;;;;;;;;OAgBG;IACH,SAAgB,MAAM,CACpB,MAAwC;QAExC,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA;IAC9D,CAAC;IAJe,WAAM,SAIrB,CAAA;AACH,CAAC,EAvBgB,IAAI,KAAJ,IAAI,QAuBpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,OAAO,CACrB,MAAc,EACd,OAAyE;IAEzE,OAAO,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,MAAM,CAAC,SAAS,CAAA;QAClD,MAAM,IAAI,EAAE,CAAA;QACZ,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACnC,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"hono.js","sourceRoot":"","sources":["../../src/middlewares/hono.ts"],"names":[],"mappings":"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"}

package/dist/middlewares/internal/mppx.d.ts

@@ -1,13 +1,15 @@
+import type { DiscoveryHandler } from '../../discovery/OpenApi.js';
 import type * as Method from '../../Method.js';
 import type * as Mppx from '../../server/Mppx.js';
 export type AnyMethodFn = Mppx.AnyMethodFn;
 export type AnyServer = Method.AnyServer;
+type DiscoveryMeta = Pick<DiscoveryHandler, '_internal'>;
 /** Recursively wraps nested handler objects one level deep. */
 type WrapNested<obj, handler> = {
-    [key in keyof obj]: obj[key] extends (options: infer options) => any ? (o: options) => handler : obj[key];
+    [key in keyof obj]: obj[key] extends (options: infer options) => any ? (o: options) => handler & DiscoveryMeta : obj[key];
 };
 export type Wrap<mppx, handler> = {
-    [key in keyof mppx as key extends 'compose' ? never : key]: key extends 'methods' | 'realm' | 'transport' ? mppx[key] : mppx[key] extends (options: infer options) => any ? (o: options) => handler : mppx[key] extends Record<string, (options: any) => any> ? WrapNested<mppx[key], handler> : mppx[key];
+    [key in keyof mppx as key extends 'compose' ? never : key]: key extends 'methods' | 'realm' | 'transport' ? mppx[key] : mppx[key] extends (options: infer options) => any ? (o: options) => handler & DiscoveryMeta : mppx[key] extends Record<string, (options: any) => any> ? WrapNested<mppx[key], handler> : mppx[key];
 };
 /**
  * Wraps a payment handler so each method returns a framework-specific

package/dist/middlewares/internal/mppx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mppx.d.ts","sourceRoot":"","sources":["../../../src/middlewares/internal/mppx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,KAAK,IAAI,MAAM,sBAAsB,CAAA;AAEjD,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAA;AAC1C,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;AAExC,+DAA+D;AAC/D,KAAK,UAAU,CAAC,GAAG,EAAE,OAAO,IAAI;KAC7B,GAAG,IAAI,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,GAAG,GAChE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GACvB,GAAG,CAAC,GAAG,CAAC;CACb,CAAA;AAED,MAAM,MAAM,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI;KAI/B,GAAG,IAAI,MAAM,IAAI,IAAI,GAAG,SAAS,SAAS,GAAG,KAAK,GAAG,GAAG,GAAG,GAAG,SAC3D,SAAS,GACT,OAAO,GACP,WAAW,GACX,IAAI,CAAC,GAAG,CAAC,GACT,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,GAAG,GAC/C,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GACvB,IAAI,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,CAAC,GACrD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,GAC9B,IAAI,CAAC,GAAG,CAAC;CAClB,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,EAC5D,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,GACtD,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAgBrB"}
+{"version":3,"file":"mppx.d.ts","sourceRoot":"","sources":["../../../src/middlewares/internal/mppx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,KAAK,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,KAAK,IAAI,MAAM,sBAAsB,CAAA;AAEjD,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAA;AAC1C,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;AAExC,KAAK,aAAa,GAAG,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAA;AAExD,+DAA+D;AAC/D,KAAK,UAAU,CAAC,GAAG,EAAE,OAAO,IAAI;KAC7B,GAAG,IAAI,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,GAAG,GAChE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,aAAa,GACvC,GAAG,CAAC,GAAG,CAAC;CACb,CAAA;AAED,MAAM,MAAM,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI;KAI/B,GAAG,IAAI,MAAM,IAAI,IAAI,GAAG,SAAS,SAAS,GAAG,KAAK,GAAG,GAAG,GAAG,GAAG,SAC3D,SAAS,GACT,OAAO,GACP,WAAW,GACX,IAAI,CAAC,GAAG,CAAC,GACT,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,KAAK,GAAG,GAC/C,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,aAAa,GACvC,IAAI,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,CAAC,GACrD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,GAC9B,IAAI,CAAC,GAAG,CAAC;CAClB,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,EAC5D,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,GACtD,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAqBrB"}