@solvapay/server 1.0.8-preview.7 → 1.0.8-preview.9

package/dist/src/mcp-auth.js

@@ -1,57 +0,0 @@
-/**
- * MCP OAuth helper utilities.
- *
- * These helpers are intentionally lightweight and do not verify JWT signatures.
- * Use them after token validation (for example via /v1/customer/auth/userinfo).
- */
-export class McpBearerAuthError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'McpBearerAuthError';
-    }
-}
-function base64UrlDecode(input) {
-    const normalized = input.replace(/-/g, '+').replace(/_/g, '/');
-    const padded = normalized.padEnd(normalized.length + ((4 - (normalized.length % 4)) % 4), '=');
-    return Buffer.from(padded, 'base64').toString('utf8');
-}
-export function extractBearerToken(authorization) {
-    if (!authorization)
-        return null;
-    if (!authorization.startsWith('Bearer '))
-        return null;
-    return authorization.slice(7).trim() || null;
-}
-export function decodeJwtPayload(token) {
-    const parts = token.split('.');
-    if (parts.length < 2) {
-        throw new McpBearerAuthError('Invalid JWT format');
-    }
-    try {
-        const payloadText = base64UrlDecode(parts[1]);
-        const payload = JSON.parse(payloadText);
-        return payload;
-    }
-    catch {
-        throw new McpBearerAuthError('Invalid JWT payload');
-    }
-}
-export function getCustomerRefFromJwtPayload(payload, options = {}) {
-    const claimPriority = options.claimPriority || ['customerRef', 'customer_ref', 'sub'];
-    for (const claim of claimPriority) {
-        const value = payload[claim];
-        if (typeof value === 'string' && value.trim()) {
-            return value.trim();
-        }
-    }
-    throw new McpBearerAuthError(`No customer reference claim found (checked: ${claimPriority.join(', ')})`);
-}
-export function getCustomerRefFromBearerAuthHeader(authorization, options = {}) {
-    const token = extractBearerToken(authorization);
-    if (!token) {
-        throw new McpBearerAuthError('Missing bearer token');
-    }
-    const payload = decodeJwtPayload(token);
-    return getCustomerRefFromJwtPayload(payload, options);
-}
-//# sourceMappingURL=mcp-auth.js.map

package/dist/src/mcp-auth.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-auth.js","sourceRoot":"","sources":["../../src/mcp-auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF;AAMD,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC9D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC9F,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AACvD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,aAA6B;IAC9D,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAA;IAC/B,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAA;IACrD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,kBAAkB,CAAC,oBAAoB,CAAC,CAAA;IACpD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAA4B,CAAA;QAClE,OAAO,OAAO,CAAA;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,CAAC,CAAA;IACrD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAAgC,EAChC,UAAuC,EAAE;IAEzC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,aAAa,EAAE,cAAc,EAAE,KAAK,CAAC,CAAA;IAErF,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,OAAO,KAAK,CAAC,IAAI,EAAE,CAAA;QACrB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,kBAAkB,CAC1B,+CAA+C,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC3E,CAAA;AACH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,aAA6B,EAC7B,UAAuC,EAAE;IAEzC,MAAM,KAAK,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAA;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,kBAAkB,CAAC,sBAAsB,CAAC,CAAA;IACtD,CAAC;IACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACvC,OAAO,4BAA4B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AACvD,CAAC"}

package/dist/src/paywall.d.ts

@@ -1,119 +0,0 @@
-/**
- * SolvaPay SDK - Universal Paywall Protection
- *
- * One API that works everywhere:
- * - HTTP frameworks (Fastify, Express)
- * - MCP servers
- * - Class-based and functional programming
- */
-import type { PaywallArgs, PaywallMetadata, PaywallStructuredContent, PaywallToolResult, SolvaPayClient } from './types';
-export type { PaywallArgs, PaywallMetadata, PaywallStructuredContent, PaywallToolResult, SolvaPayClient, };
-/**
- * Error thrown when a paywall is triggered (purchase required or usage limit exceeded).
- *
- * This error is automatically thrown by the paywall protection system when:
- * - Customer doesn't have required purchase
- * - Customer has exceeded usage limits
- * - Customer needs to upgrade their plan
- *
- * The error includes structured content with checkout URLs and metadata for
- * building custom paywall UIs.
- *
- * @example
- * ```typescript
- * import { PaywallError } from '@solvapay/server';
- *
- * try {
- *   const result = await payable.http(createTask)(req, res);
- *   return result;
- * } catch (error) {
- *   if (error instanceof PaywallError) {
- *     // Custom paywall handling
- *     return res.status(402).json({
- *       error: error.message,
- *       checkoutUrl: error.structuredContent.checkoutUrl,
- *       // Additional metadata available in error.structuredContent
- *     });
- *   }
- *   throw error;
- * }
- * ```
- *
- * @see {@link PaywallStructuredContent} for the structured content format
- * @since 1.0.0
- */
-export declare class PaywallError extends Error {
-    structuredContent: PaywallStructuredContent;
-    /**
-     * Creates a new PaywallError instance.
-     *
-     * @param message - Error message
-     * @param structuredContent - Structured content with checkout URLs and metadata
-     */
-    constructor(message: string, structuredContent: PaywallStructuredContent);
-}
-/** JSON body shape for HTTP adapters and MCP text content (stable fields for clients). */
-export declare function paywallErrorToClientPayload(error: PaywallError): Record<string, unknown>;
-/**
- * Universal SolvaPay Protection - One API for everything
- */
-export declare class SolvaPayPaywall {
-    private apiClient;
-    private customerCreationAttempts;
-    private customerRefMapping;
-    private debug;
-    private limitsCache;
-    private limitsCacheTTL;
-    constructor(apiClient: SolvaPayClient, options?: {
-        debug?: boolean;
-        limitsCacheTTL?: number;
-    });
-    private log;
-    private resolveProduct;
-    private generateRequestId;
-    /**
-     * Core protection method - works for both MCP and HTTP
-     */
-    protect<TArgs extends PaywallArgs, TResult = any>(handler: (args: TArgs) => Promise<TResult>, metadata?: PaywallMetadata, getCustomerRef?: (args: TArgs) => string): Promise<(args: TArgs) => Promise<TResult>>;
-    /**
-     * Ensures a customer exists in the backend, creating them if necessary.
-     * This is a public helper for testing, pre-creating customers, and internal use.
-     * Only attempts creation once per customer (idempotent).
-     * Returns the backend customer reference to use in API calls.
-     *
-     * @param customerRef - The customer reference used as a cache key (e.g., Supabase user ID)
-     * @param externalRef - Optional external reference for backend lookup (e.g., Supabase user ID)
-     *   If provided, will lookup existing customer by externalRef before creating new one.
-     *   The externalRef is stored on the SolvaPay backend for customer lookup.
-     * @param options - Optional customer details (email, name) for customer creation
-     */
-    ensureCustomer(customerRef: string, externalRef?: string, options?: {
-        email?: string;
-        name?: string;
-    }): Promise<string>;
-    trackUsage(customerRef: string, _productRef: string, _planRef: string, action: string, outcome: 'success' | 'paywall' | 'fail', requestId: string, actionDuration: number): Promise<void>;
-}
-/**
- * Universal SolvaPay factory - One API for MCP and HTTP
- */
-export declare function createPaywall(config: {
-    apiClient: SolvaPayClient;
-}): {
-    protect: <TArgs extends PaywallArgs, TResult = any>(metadata?: PaywallMetadata) => (handler: (args: TArgs) => Promise<TResult>) => Promise<(args: TArgs) => Promise<TResult>>;
-    Paywall: (metadata?: PaywallMetadata) => (target: Record<string, unknown>, propertyKey: string, descriptor?: PropertyDescriptor) => Record<string, unknown> | PropertyDescriptor;
-    createHttpHandler: (methodOrMetadata: ((...args: unknown[]) => unknown) | PaywallMetadata, handlerOrOptions?: ((args: PaywallArgs) => Promise<unknown>) | {
-        extractArgs?: (req: any) => Record<string, unknown>;
-        transformResponse?: (result: unknown, reply: any) => unknown;
-        getCustomerRef?: (req: any) => string;
-    }) => (req: any, reply: any) => Promise<unknown>;
-    createMCPHandler: (methodOrMetadata: ((...args: unknown[]) => unknown) | PaywallMetadata, handler?: (args: PaywallArgs) => Promise<unknown>) => Promise<(args: PaywallArgs) => Promise<unknown>>;
-    createNextHandler: (metadata: PaywallMetadata, handler: (args: PaywallArgs) => Promise<unknown>, options?: {
-        extractArgs?: (request: Request, context?: any) => Promise<Record<string, unknown>> | Record<string, unknown>;
-        getCustomerRef?: (request: Request) => Promise<string> | string;
-        transformResponse?: (result: unknown) => unknown;
-    }) => (request: Request, context?: any) => Promise<Response>;
-    ensureCustomer: (customerRef: string) => Promise<string>;
-    paywall: SolvaPayPaywall;
-};
-export declare function ensureCustomerRef(customerRef: string): string;
-//# sourceMappingURL=paywall.d.ts.map

package/dist/src/paywall.d.ts.map

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