@contextvm/sdk 0.3.2 → 0.4.1

package/dist/esm/payments/processors/ln-bolt11-nwc-payment-processor.d.ts

@@ -0,0 +1,41 @@
+import type { RelayHandler } from '../../core/interfaces.js';
+import type { PaymentProcessor, PaymentProcessorCreateParams, PaymentProcessorVerifyParams } from '../types.js';
+export interface LnBolt11NwcPaymentProcessorOptions {
+    /** NIP-47 `nostr+walletconnect://...` connection string. */
+    nwcConnectionString: string;
+    /** Optional relay handler to reuse; defaults to an ApplesauceRelayPool built from the connection relays. */
+    relayHandler?: RelayHandler;
+    /** Fallback TTL in seconds if wallet does not provide expires_at. @default 300 */
+    ttlSeconds?: number;
+    /** `make_invoice.expiry` in seconds. @default ttlSeconds */
+    invoiceExpirySeconds?: number;
+    /** Poll interval for `lookup_invoice`. @default 1500 */
+    pollIntervalMs?: number;
+    /** Per-request response timeout. @default 60_000 */
+    responseTimeoutMs?: number;
+}
+/**
+ * CEP-8 server payment processor for PMI `bitcoin-lightning-bolt11` backed by NIP-47 (NWC).
+ */
+export declare class LnBolt11NwcPaymentProcessor implements PaymentProcessor {
+    readonly pmi: "bitcoin-lightning-bolt11";
+    private readonly nwc;
+    private readonly ttlSeconds;
+    private readonly invoiceExpirySeconds;
+    private readonly pollIntervalMs;
+    private readonly logger;
+    constructor(options: LnBolt11NwcPaymentProcessorOptions);
+    private isSettledInvoice;
+    private getReceiptFromInvoiceResult;
+    createPaymentRequired(params: PaymentProcessorCreateParams): Promise<{
+        amount: number;
+        pay_req: string;
+        description?: string;
+        pmi: string;
+        ttl?: number;
+    }>;
+    verifyPayment(params: PaymentProcessorVerifyParams): Promise<{
+        _meta?: Record<string, unknown>;
+    }>;
+}
+//# sourceMappingURL=ln-bolt11-nwc-payment-processor.d.ts.map

package/dist/esm/payments/processors/ln-bolt11-nwc-payment-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ln-bolt11-nwc-payment-processor.d.ts","sourceRoot":"","sources":["../../../../src/payments/processors/ln-bolt11-nwc-payment-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACV,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,aAAa,CAAC;AAUrB,MAAM,WAAW,kCAAkC;IACjD,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4GAA4G;IAC5G,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,2BAA4B,YAAW,gBAAgB;IAClE,SAAgB,GAAG,6BAAgC;IAEnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEb,OAAO,EAAE,kCAAkC;IAiB9D,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,2BAA2B;IAqBtB,qBAAqB,CAChC,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IAoCW,aAAa,CACxB,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAoDhD"}

package/dist/esm/payments/processors/ln-bolt11-nwc-payment-processor.js

@@ -0,0 +1,129 @@
+import { PMI_BITCOIN_LIGHTNING_BOLT11 } from '../pmis.js';
+import { parseNwcConnectionString } from '../nip47/connection.js';
+import { NwcClient } from '../nip47/nwc-client.js';
+import { ApplesauceRelayPool } from '../../relay/applesauce-relay-pool.js';
+import { createLogger } from '../../core/utils/logger.js';
+import { sleep } from '../../core/utils/utils.js';
+import { satsToMsats } from '../nip47/utils.js';
+/**
+ * CEP-8 server payment processor for PMI `bitcoin-lightning-bolt11` backed by NIP-47 (NWC).
+ */
+export class LnBolt11NwcPaymentProcessor {
+    constructor(options) {
+        var _a, _b, _c, _d;
+        this.pmi = PMI_BITCOIN_LIGHTNING_BOLT11;
+        const connection = parseNwcConnectionString(options.nwcConnectionString);
+        const relayHandler = (_a = options.relayHandler) !== null && _a !== void 0 ? _a : new ApplesauceRelayPool([...connection.relays]);
+        this.nwc = new NwcClient({
+            relayHandler,
+            connection,
+            responseTimeoutMs: options.responseTimeoutMs,
+        });
+        this.ttlSeconds = (_b = options.ttlSeconds) !== null && _b !== void 0 ? _b : 300;
+        this.invoiceExpirySeconds = (_c = options.invoiceExpirySeconds) !== null && _c !== void 0 ? _c : this.ttlSeconds;
+        this.pollIntervalMs = (_d = options.pollIntervalMs) !== null && _d !== void 0 ? _d : 1500;
+        this.logger = createLogger('payments/nwc-processor');
+    }
+    isSettledInvoice(result) {
+        // Wallets vary: some set `state`, some only set `settled_at`, some include `preimage`.
+        // Treat any of these signals as settlement.
+        if (!result)
+            return false;
+        if (result.state === 'settled')
+            return true;
+        if (typeof result.settled_at === 'number')
+            return true;
+        if (typeof result.preimage === 'string' && result.preimage.length > 0)
+            return true;
+        return false;
+    }
+    getReceiptFromInvoiceResult(params) {
+        const { result, requestEventId } = params;
+        // Prefer stable identifiers; avoid leaking preimage.
+        if (typeof (result === null || result === void 0 ? void 0 : result.payment_hash) === 'string' &&
+            result.payment_hash.length > 0) {
+            return result.payment_hash;
+        }
+        // Some wallets do not provide `payment_hash` on lookup results. Still produce a stable
+        // settlement identifier string for correlation.
+        const settledAt = typeof (result === null || result === void 0 ? void 0 : result.settled_at) === 'number' ? result.settled_at : undefined;
+        return `settled:${requestEventId}${settledAt ? `:${settledAt}` : ''}`;
+    }
+    async createPaymentRequired(params) {
+        var _a;
+        const request = {
+            amount: satsToMsats(params.amount),
+            description: params.description,
+            expiry: this.invoiceExpirySeconds,
+        };
+        const response = await this.nwc.request({
+            method: 'make_invoice',
+            resultType: 'make_invoice',
+            request: { method: 'make_invoice', params: request },
+        });
+        if (response.error) {
+            throw new Error(`NWC make_invoice failed: ${response.error.code} (${response.error.message})`);
+        }
+        const invoice = (_a = response.result) === null || _a === void 0 ? void 0 : _a.invoice;
+        if (!invoice) {
+            throw new Error('NWC make_invoice returned no invoice');
+        }
+        // Keep TTL simple and predictable. Some providers return non-standard `expires_at`.
+        const ttl = this.ttlSeconds;
+        return {
+            amount: params.amount,
+            pay_req: invoice,
+            description: params.description,
+            pmi: this.pmi,
+            ttl,
+        };
+    }
+    async verifyPayment(params) {
+        var _a;
+        // Note: server-payments middleware already bounds overall time by the `ttl` it emitted.
+        // We still keep this loop tight and predictable.
+        while (true) {
+            if ((_a = params.abortSignal) === null || _a === void 0 ? void 0 : _a.aborted) {
+                throw new Error('verifyPayment aborted');
+            }
+            const response = await this.nwc.request({
+                method: 'lookup_invoice',
+                resultType: 'lookup_invoice',
+                request: {
+                    method: 'lookup_invoice',
+                    params: { invoice: params.pay_req },
+                },
+            });
+            if (response.error) {
+                // NOT_FOUND can happen if the wallet is lagging; treat as pending.
+                if (response.error.code !== 'NOT_FOUND') {
+                    throw new Error(`NWC lookup_invoice failed: ${response.error.code} (${response.error.message})`);
+                }
+            }
+            else {
+                const result = response.result;
+                this.logger.debug('lookup_invoice result', {
+                    requestEventId: params.requestEventId,
+                    state: result === null || result === void 0 ? void 0 : result.state,
+                    hasPreimage: Boolean(result === null || result === void 0 ? void 0 : result.preimage),
+                    hasSettledAt: typeof (result === null || result === void 0 ? void 0 : result.settled_at) === 'number',
+                    hasPaymentHash: Boolean(result === null || result === void 0 ? void 0 : result.payment_hash),
+                });
+                if (this.isSettledInvoice(result)) {
+                    // Prefer payment_hash as a stable identifier (avoid exposing preimages).
+                    const paymentHash = this.getReceiptFromInvoiceResult({
+                        result,
+                        requestEventId: params.requestEventId,
+                    });
+                    return { _meta: { payment_hash: paymentHash } };
+                }
+                const state = result === null || result === void 0 ? void 0 : result.state;
+                if (state === 'expired' || state === 'failed') {
+                    throw new Error(`Invoice ${state}`);
+                }
+            }
+            await sleep(this.pollIntervalMs);
+        }
+    }
+}
+//# sourceMappingURL=ln-bolt11-nwc-payment-processor.js.map

package/dist/esm/payments/processors/ln-bolt11-nwc-payment-processor.js.map

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

package/dist/esm/payments/server-payments.d.ts

@@ -0,0 +1,32 @@
+import { CorrelatedNotificationSender, PaymentProcessor, PricedCapability, ResolvePriceFn, ServerMiddlewareFn } from './types.js';
+export interface ServerPaymentsOptions {
+    processors: readonly PaymentProcessor[];
+    pricedCapabilities: readonly PricedCapability[];
+    /** Optional dynamic pricing callback used to compute a per-request quote. */
+    resolvePrice?: ResolvePriceFn;
+    /**
+     * Maximum time to keep a request in pending-payment state.
+     *
+     * Note: if the payment request includes a CEP-8 `ttl` (seconds), the effective
+     * verification timeout will be derived from that TTL. This option is primarily
+     * a memory/DoS guardrail.
+     *
+     * @default 300_000
+     */
+    paymentTtlMs?: number;
+    /**
+     * Maximum number of concurrent pending-payment request ids to track.
+     *
+     * This is a DoS/memory-safety guardrail.
+     * @default 1000
+     */
+    maxPendingPayments?: number;
+}
+/**
+ * Creates a server-side middleware that gates priced requests until payment is verified.
+ */
+export declare function createServerPaymentsMiddleware(params: {
+    sender: CorrelatedNotificationSender;
+    options: ServerPaymentsOptions;
+}): ServerMiddlewareFn;
+//# sourceMappingURL=server-payments.d.ts.map

package/dist/esm/payments/server-payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-payments.d.ts","sourceRoot":"","sources":["../../../src/payments/server-payments.ts"],"names":[],"mappings":"AACA,OAAO,EACL,4BAA4B,EAE5B,gBAAgB,EAGhB,gBAAgB,EAGhB,cAAc,EACd,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACxC,kBAAkB,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAEhD,6EAA6E;IAC7E,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAuHD;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,MAAM,EAAE,4BAA4B,CAAC;IACrC,OAAO,EAAE,qBAAqB,CAAC;CAChC,GAAG,kBAAkB,CA6JrB"}

package/dist/esm/payments/server-payments.js

@@ -0,0 +1,199 @@
+import { isJsonRpcRequest, } from './types.js';
+import { LruCache } from '../core/utils/lru-cache.js';
+import { withTimeout } from '../core/utils/utils.js';
+function purgeExpiredPending(params) {
+    let checked = 0;
+    for (const [key, value] of params.pending.entries()) {
+        if (checked >= params.maxToCheck) {
+            break;
+        }
+        checked += 1;
+        if (value.expiresAtMs <= params.nowMs) {
+            params.pending.delete(key);
+        }
+    }
+}
+function getVerificationTimeoutMs(params) {
+    // CEP-8 TTL is in seconds. If TTL is absent, default is 5 minutes.
+    const ttlSeconds = params.ttlSeconds;
+    if (ttlSeconds === undefined) {
+        return 5 * 60 * 1000;
+    }
+    if (!Number.isFinite(ttlSeconds) || ttlSeconds <= 0) {
+        return 5 * 60 * 1000;
+    }
+    return Math.floor(ttlSeconds * 1000);
+}
+function matchPricedCapability(message, priced) {
+    const capabilityName = getCapabilityNameForPricing(message);
+    return priced.find((p) => {
+        if (p.method !== message.method)
+            return false;
+        if (p.name === undefined)
+            return true;
+        return p.name === capabilityName;
+    });
+}
+function getCapabilityNameForPricing(message) {
+    const params = message.params;
+    switch (message.method) {
+        case 'tools/call': {
+            const name = params === null || params === void 0 ? void 0 : params.name;
+            return typeof name === 'string' ? name : undefined;
+        }
+        case 'prompts/get': {
+            const name = params === null || params === void 0 ? void 0 : params.name;
+            return typeof name === 'string' ? name : undefined;
+        }
+        case 'resources/read': {
+            const uri = params === null || params === void 0 ? void 0 : params.uri;
+            return typeof uri === 'string' ? uri : undefined;
+        }
+        default:
+            return undefined;
+    }
+}
+function createPaymentRequiredNotification(params) {
+    return {
+        jsonrpc: '2.0',
+        method: 'notifications/payment_required',
+        params,
+    };
+}
+function createPaymentAcceptedNotification(params) {
+    return {
+        jsonrpc: '2.0',
+        method: 'notifications/payment_accepted',
+        params,
+    };
+}
+function createPaymentRejectedNotification(params) {
+    return {
+        jsonrpc: '2.0',
+        method: 'notifications/payment_rejected',
+        params,
+    };
+}
+function isResolvePriceRejection(quote) {
+    return 'reject' in quote && quote.reject;
+}
+/**
+ * Creates a server-side middleware that gates priced requests until payment is verified.
+ */
+export function createServerPaymentsMiddleware(params) {
+    var _a, _b;
+    const { sender, options } = params;
+    const processorsByPmi = new Map(options.processors.map((p) => [p.pmi, p]));
+    const paymentTtlMs = (_a = options.paymentTtlMs) !== null && _a !== void 0 ? _a : 300000;
+    const pending = new LruCache((_b = options.maxPendingPayments) !== null && _b !== void 0 ? _b : 1000);
+    return async (message, ctx, forward) => {
+        // Only gate requests. Never interfere with notifications.
+        if (!isJsonRpcRequest(message)) {
+            await forward(message);
+            return;
+        }
+        const priced = matchPricedCapability(message, options.pricedCapabilities);
+        if (!priced) {
+            await forward(message);
+            return;
+        }
+        const requestEventId = String(message.id);
+        const now = Date.now();
+        // Opportunistic cleanup so one-shot spam doesn't accumulate until reuse.
+        purgeExpiredPending({ pending, nowMs: now, maxToCheck: 25 });
+        const existing = pending.get(requestEventId);
+        if (existing && existing.expiresAtMs > now) {
+            // Duplicate request event id: await the in-flight work deterministically.
+            // This avoids double-charge races and avoids black-holing duplicates.
+            await existing.inFlight;
+            return;
+        }
+        // IMPORTANT: set pending state synchronously before any await to make idempotency atomic.
+        const inFlight = (async () => {
+            var _a, _b, _c;
+            const clientPmis = ctx.clientPmis;
+            const chosenPmi = clientPmis
+                ? clientPmis.find((pmi) => processorsByPmi.has(pmi))
+                : undefined;
+            const chosenProcessor = chosenPmi
+                ? processorsByPmi.get(chosenPmi)
+                : options.processors[0];
+            if (!chosenProcessor) {
+                throw new Error('No payment processors configured');
+            }
+            const processor = (_a = processorsByPmi.get(chosenProcessor.pmi)) !== null && _a !== void 0 ? _a : chosenProcessor;
+            const quote = options.resolvePrice
+                ? await options.resolvePrice({
+                    capability: priced,
+                    request: message,
+                    clientPubkey: ctx.clientPubkey,
+                    requestEventId,
+                })
+                : { amount: priced.amount, description: priced.description };
+            // Handle rejection: emit payment_rejected and do not forward.
+            if (isResolvePriceRejection(quote)) {
+                const rejectedNotification = createPaymentRejectedNotification({
+                    pmi: processor.pmi,
+                    amount: priced.amount,
+                    message: quote.message,
+                });
+                await sender.sendNotification(ctx.clientPubkey, rejectedNotification, requestEventId);
+            }
+            else {
+                const resolvedQuote = quote;
+                const paymentRequired = await processor.createPaymentRequired({
+                    amount: resolvedQuote.amount,
+                    description: resolvedQuote.description,
+                    requestEventId,
+                    clientPubkey: ctx.clientPubkey,
+                });
+                const mergedMeta = resolvedQuote.meta === undefined &&
+                    paymentRequired._meta === undefined
+                    ? undefined
+                    : {
+                        ...((_b = paymentRequired._meta) !== null && _b !== void 0 ? _b : {}),
+                        ...((_c = resolvedQuote.meta) !== null && _c !== void 0 ? _c : {}),
+                    };
+                const requiredNotification = createPaymentRequiredNotification({
+                    amount: paymentRequired.amount,
+                    pay_req: paymentRequired.pay_req,
+                    pmi: paymentRequired.pmi,
+                    description: paymentRequired.description,
+                    ttl: paymentRequired.ttl,
+                    _meta: mergedMeta,
+                });
+                await sender.sendNotification(ctx.clientPubkey, requiredNotification, requestEventId);
+                const verifyTimeoutMs = getVerificationTimeoutMs({
+                    ttlSeconds: paymentRequired.ttl,
+                });
+                const effectiveTimeoutMs = Math.min(verifyTimeoutMs, paymentTtlMs);
+                const controller = new AbortController();
+                const verified = await withTimeout(processor.verifyPayment({
+                    pay_req: paymentRequired.pay_req,
+                    requestEventId,
+                    clientPubkey: ctx.clientPubkey,
+                    abortSignal: controller.signal,
+                }), effectiveTimeoutMs, 'verifyPayment timed out').finally(() => controller.abort());
+                const acceptedNotification = createPaymentAcceptedNotification({
+                    amount: paymentRequired.amount,
+                    pmi: paymentRequired.pmi,
+                    _meta: verified._meta,
+                });
+                await sender.sendNotification(ctx.clientPubkey, acceptedNotification, requestEventId);
+                await forward(message);
+            }
+        })();
+        const state = {
+            expiresAtMs: now + paymentTtlMs,
+            inFlight,
+        };
+        pending.set(requestEventId, state);
+        try {
+            await inFlight;
+        }
+        finally {
+            pending.delete(requestEventId);
+        }
+    };
+}
+//# sourceMappingURL=server-payments.js.map

package/dist/esm/payments/server-payments.js.map

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

package/dist/esm/payments/server-transport-payments.d.ts

@@ -0,0 +1,7 @@
+import type { NostrServerTransport } from '../transport/nostr-server-transport.js';
+import type { ServerPaymentsOptions } from './server-payments.js';
+/**
+ * Attaches CEP-8 payments gating to a NostrServerTransport.
+ */
+export declare function withServerPayments(transport: NostrServerTransport, options: ServerPaymentsOptions): NostrServerTransport;
+//# sourceMappingURL=server-transport-payments.d.ts.map

package/dist/esm/payments/server-transport-payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-transport-payments.d.ts","sourceRoot":"","sources":["../../../src/payments/server-transport-payments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAKlE;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,oBAAoB,EAC/B,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,CAatB"}

package/dist/esm/payments/server-transport-payments.js

@@ -0,0 +1,14 @@
+import { createCapTagsFromPricedCapabilities } from './cap-tags.js';
+import { createPmiTagsFromProcessors } from './pmi-tags.js';
+import { createServerPaymentsMiddleware } from './server-payments.js';
+/**
+ * Attaches CEP-8 payments gating to a NostrServerTransport.
+ */
+export function withServerPayments(transport, options) {
+    // CEP-8 discovery tags: advertise supported PMIs + reference pricing on announcement/list events.
+    transport.setAnnouncementExtraTags(createPmiTagsFromProcessors(options.processors));
+    transport.setAnnouncementPricingTags(createCapTagsFromPricedCapabilities(options.pricedCapabilities));
+    transport.addInboundMiddleware(createServerPaymentsMiddleware({ sender: transport, options }));
+    return transport;
+}
+//# sourceMappingURL=server-transport-payments.js.map

package/dist/esm/payments/server-transport-payments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-transport-payments.js","sourceRoot":"","sources":["../../../src/payments/server-transport-payments.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mCAAmC,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAEtE;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA+B,EAC/B,OAA8B;IAE9B,kGAAkG;IAClG,SAAS,CAAC,wBAAwB,CAChC,2BAA2B,CAAC,OAAO,CAAC,UAAU,CAAC,CAChD,CAAC;IACF,SAAS,CAAC,0BAA0B,CAClC,mCAAmC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAChE,CAAC;IAEF,SAAS,CAAC,oBAAoB,CAC5B,8BAA8B,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAC/D,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/esm/payments/types.d.ts

@@ -0,0 +1,174 @@
+import type { JSONRPCMessage, JSONRPCNotification, JSONRPCRequest } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * A priced capability pattern, consistent with server-side authorization exclusions.
+ */
+export interface PricedCapabilityPattern {
+    /** JSON-RPC method (example: `tools/call`) */
+    method: string;
+    /** Optional capability name (example: tool name for `tools/call`) */
+    name?: string;
+}
+/**
+ * Server-side pricing metadata for a capability pattern.
+ */
+export interface PricedCapability extends PricedCapabilityPattern {
+    /** Amount requested for this invocation. Unit interpretation is implementation-defined. */
+    amount: number;
+    /**
+     * Optional upper bound for variable pricing. When set, `cap` tag uses range format
+     * `"<amount>-<maxAmount>"` (CEP-8).
+     */
+    maxAmount?: number;
+    /** Currency/unit label for display and `cap` tag advertisement (example: `sats`). */
+    currencyUnit: string;
+    /** Optional human-readable description for the payment request. */
+    description?: string;
+}
+/** Nostr `cap` tag as defined by CEP-8. */
+export type CapTag = [
+    'cap',
+    capabilityIdentifier: string,
+    price: string,
+    currencyUnit: string
+];
+/** Nostr `pmi` tag as defined by CEP-8. */
+export type PmiTag = ['pmi', pmi: string];
+/** Nostr `direct_payment` tag as defined by CEP-8 (optional bearer-asset optimization). */
+export type DirectPaymentTag = ['direct_payment', pmi: string, payload: string];
+/** Nostr `change` tag as defined by CEP-8 (optional settlement artifact for bearer-asset methods). */
+export type ChangeTag = ['change', pmi: string, payload: string];
+/** A CEP-8 payment-required notification (JSON-RPC notification). */
+export type PaymentRequiredNotification = JSONRPCNotification & {
+    method: 'notifications/payment_required';
+    params: {
+        amount: number;
+        pay_req: string;
+        pmi: string;
+        description?: string;
+        /** Time-to-live in seconds (CEP-8). */
+        ttl?: number;
+        _meta?: Record<string, unknown>;
+    };
+};
+/** A CEP-8 payment-accepted notification (JSON-RPC notification). */
+export type PaymentAcceptedNotification = JSONRPCNotification & {
+    method: 'notifications/payment_accepted';
+    params: {
+        amount: number;
+        pmi: string;
+        _meta?: Record<string, unknown>;
+    };
+};
+/** A CEP-8 payment-rejected notification (JSON-RPC notification). */
+export type PaymentRejectedNotification = JSONRPCNotification & {
+    method: 'notifications/payment_rejected';
+    params: {
+        pmi: string;
+        amount?: number;
+        message?: string;
+    };
+};
+export interface PaymentHandlerRequest {
+    amount: number;
+    pay_req: string;
+    description?: string;
+    requestEventId: string;
+}
+/**
+ * Client-side module that can execute a payment for a single PMI.
+ */
+export interface PaymentHandler {
+    /** The PMI this handler supports (e.g. "bitcoin-lightning-bolt11") */
+    readonly pmi: string;
+    /** Optional policy check that can decline handling. */
+    canHandle?(req: PaymentHandlerRequest): boolean | Promise<boolean>;
+    /** Execute the payment (wallet action). */
+    handle(req: PaymentHandlerRequest): Promise<void>;
+}
+export interface PaymentProcessorCreateParams {
+    amount: number;
+    description?: string;
+    requestEventId: string;
+    clientPubkey: string;
+}
+export interface PaymentProcessorVerifyParams {
+    pay_req: string;
+    requestEventId: string;
+    clientPubkey: string;
+    /** Optional abort signal to stop verification early (timeout, shutdown, etc). */
+    abortSignal?: AbortSignal;
+}
+export type ResolvePriceQuote = {
+    /** Final amount to charge for this specific invocation. */
+    amount: number;
+    /** Optional override for the payment request description. */
+    description?: string;
+    /** Optional transparency metadata attached to `payment_required.params._meta`. */
+    meta?: Record<string, unknown>;
+};
+export type ResolvePriceRejection = {
+    /** Signal that the request should be rejected without asking for payment. */
+    reject: true;
+    /** Optional human-readable message explaining the rejection. */
+    message?: string;
+};
+/**
+ * Result of resolvePrice callback.
+ *
+ * - Return a quote object to proceed with payment flow.
+ * - Return a rejection object to emit `payment_rejected` without asking for payment.
+ */
+export type ResolvePriceResult = ResolvePriceQuote | ResolvePriceRejection;
+/**
+ * Server-side callback for dynamic pricing.
+ *
+ * Note: `cap` tags are a discovery surface; this callback determines the final quote
+ * used when emitting `notifications/payment_required`.
+ */
+export type ResolvePriceFn = (params: {
+    capability: PricedCapability;
+    request: JSONRPCRequest;
+    clientPubkey: string;
+    requestEventId: string;
+}) => Promise<ResolvePriceResult>;
+/**
+ * Server-side module that can issue and verify payments for a single PMI.
+ */
+export interface PaymentProcessor {
+    /** The PMI this processor can issue/verify */
+    readonly pmi: string;
+    /** Create a payment request for a specific capability invocation */
+    createPaymentRequired(params: PaymentProcessorCreateParams): Promise<{
+        amount: number;
+        pay_req: string;
+        description?: string;
+        pmi: string;
+        /** Time-to-live in seconds (CEP-8). */
+        ttl?: number;
+        _meta?: Record<string, unknown>;
+    }>;
+    /** Wait for and/or verify settlement for a previously issued pay_req */
+    verifyPayment(params: PaymentProcessorVerifyParams): Promise<{
+        _meta?: Record<string, unknown>;
+    }>;
+}
+export interface ServerPaymentsContext {
+    /** The client pubkey associated with the inbound request. */
+    clientPubkey: string;
+    /**
+     * Optional list of client-advertised PMIs (ordered by client preference).
+     *
+     * Source: Nostr event tags (e.g. multiple `['pmi', '<pmi>']`).
+     */
+    clientPmis?: readonly string[];
+}
+/**
+ * Minimal capability required by server-side payments to emit CEP-8 correlated notifications.
+ */
+export interface CorrelatedNotificationSender {
+    sendNotification(clientPubkey: string, notification: JSONRPCNotification, requestEventId: string): Promise<void>;
+}
+export type ServerForwardFn = (message: JSONRPCMessage) => Promise<void>;
+export type ServerMiddlewareFn = (message: JSONRPCMessage, ctx: ServerPaymentsContext, forward: ServerForwardFn) => Promise<void>;
+export declare function isJsonRpcRequest(message: JSONRPCMessage): message is JSONRPCRequest;
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/payments/types.d.ts.map

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

package/dist/esm/payments/types.js

@@ -0,0 +1,5 @@
+export function isJsonRpcRequest(message) {
+    return (message.method !== undefined &&
+        message.id !== undefined);
+}
+//# sourceMappingURL=types.js.map