@solvapay/server 1.0.8-preview.6 → 1.0.8-preview.8

package/dist/src/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA"}

package/dist/src/adapters/index.js

@@ -0,0 +1,10 @@
+/**
+ * Adapters Export
+ *
+ * Exports all framework adapters and utilities
+ */
+export { AdapterUtils, createAdapterHandler } from './base';
+export { HttpAdapter } from './http';
+export { NextAdapter } from './next';
+export { McpAdapter } from './mcp';
+//# sourceMappingURL=index.js.map

package/dist/src/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA"}

package/dist/src/adapters/mcp.d.ts

@@ -0,0 +1,24 @@
+/**
+ * MCP Adapter for Model Context Protocol servers
+ *
+ * Handles MCP tool format with content wrapping
+ */
+import type { Adapter } from './base';
+import type { McpAdapterOptions, McpToolExtra, PaywallToolResult } from '../types';
+/**
+ * MCP context (plain args object)
+ */
+type McpContext = Record<string, unknown>;
+/**
+ * MCP Adapter implementation
+ */
+export declare class McpAdapter implements Adapter<McpContext, PaywallToolResult> {
+    private options;
+    constructor(options?: McpAdapterOptions);
+    extractArgs(args: McpContext): Record<string, unknown>;
+    getCustomerRef(args: McpContext, extra?: McpToolExtra): Promise<string>;
+    formatResponse(result: unknown, _context: McpContext): PaywallToolResult;
+    formatError(error: Error, _context: McpContext): PaywallToolResult;
+}
+export {};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/src/adapters/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAErC,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAGlF;;GAEG;AACH,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEzC;;GAEG;AACH,qBAAa,UAAW,YAAW,OAAO,CAAC,UAAU,EAAE,iBAAiB,CAAC;IAC3D,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,iBAAsB;IAEnD,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKhD,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAc7E,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,GAAG,iBAAiB;IAqBxE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,GAAG,iBAAiB;CA+BnE"}

package/dist/src/adapters/mcp.js

@@ -0,0 +1,75 @@
+/**
+ * MCP Adapter for Model Context Protocol servers
+ *
+ * Handles MCP tool format with content wrapping
+ */
+import { AdapterUtils } from './base';
+import { PaywallError, paywallErrorToClientPayload } from '../paywall';
+/**
+ * MCP Adapter implementation
+ */
+export class McpAdapter {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    extractArgs(args) {
+        // MCP args are already plain objects, pass through
+        return args;
+    }
+    async getCustomerRef(args, extra) {
+        if (this.options.getCustomerRef) {
+            const ref = await this.options.getCustomerRef(args, extra);
+            return AdapterUtils.ensureCustomerRef(ref);
+        }
+        const customerRefFromExtra = extra?.authInfo?.extra?.customer_ref;
+        const customerRef = typeof customerRefFromExtra === 'string' && customerRefFromExtra.trim()
+            ? customerRefFromExtra.trim()
+            : 'anonymous';
+        return AdapterUtils.ensureCustomerRef(customerRef);
+    }
+    formatResponse(result, _context) {
+        const transformed = this.options.transformResponse
+            ? this.options.transformResponse(result)
+            : result;
+        const response = {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(transformed, null, 2),
+                },
+            ],
+        };
+        if (transformed && typeof transformed === 'object' && !Array.isArray(transformed)) {
+            response.structuredContent = transformed;
+        }
+        return response;
+    }
+    formatError(error, _context) {
+        if (error instanceof PaywallError) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(paywallErrorToClientPayload(error), null, 2),
+                    },
+                ],
+                isError: true,
+                structuredContent: error.structuredContent,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: false,
+                        error: error instanceof Error ? error.message : 'Unknown error occurred',
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/src/adapters/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/adapters/mcp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAErC,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAOtE;;GAEG;AACH,MAAM,OAAO,UAAU;IACD;IAApB,YAAoB,UAA6B,EAAE;QAA/B,YAAO,GAAP,OAAO,CAAwB;IAAG,CAAC;IAEvD,WAAW,CAAC,IAAgB;QAC1B,mDAAmD;QACnD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAgB,EAAE,KAAoB;QACzD,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YAC1D,OAAO,YAAY,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAA;QAC5C,CAAC;QAED,MAAM,oBAAoB,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAA;QACjE,MAAM,WAAW,GACf,OAAO,oBAAoB,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,EAAE;YACrE,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE;YAC7B,CAAC,CAAC,WAAW,CAAA;QACjB,OAAO,YAAY,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAA;IACpD,CAAC;IAED,cAAc,CAAC,MAAe,EAAE,QAAoB;QAClD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB;YAChD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC;YACxC,CAAC,CAAC,MAAM,CAAA;QAEV,MAAM,QAAQ,GAAsB;YAClC,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC3C;aACF;SACF,CAAA;QAED,IAAI,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAClF,QAAQ,CAAC,iBAAiB,GAAG,WAAsC,CAAA;QACrE,CAAC;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,WAAW,CAAC,KAAY,EAAE,QAAoB;QAC5C,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;qBAClE;iBACF;gBACD,OAAO,EAAE,IAAI;gBACb,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;aAC3C,CAAA;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB;qBACzE,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;CACF"}

package/dist/src/adapters/next.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Next.js Adapter for App Router
+ *
+ * Handles Next.js App Router with Web Request/Response API
+ */
+import type { Adapter } from './base';
+import type { NextAdapterOptions } from '../types';
+/**
+ * Next.js context (Web Request + optional route context)
+ */
+type NextContext = [request: Request, context?: any];
+/**
+ * Next.js Adapter implementation
+ */
+export declare class NextAdapter implements Adapter<NextContext, Response> {
+    private options;
+    constructor(options?: NextAdapterOptions);
+    extractArgs([request, context]: NextContext): Promise<Record<string, unknown>>;
+    getCustomerRef([request]: NextContext): Promise<string>;
+    formatResponse(result: unknown, _context: NextContext): Response;
+    formatError(error: Error, _context: NextContext): Response;
+}
+export {};
+//# sourceMappingURL=next.d.ts.map

package/dist/src/adapters/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../../src/adapters/next.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAErC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAGlD;;GAEG;AAEH,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,CAAA;AAEpD;;GAEG;AACH,qBAAa,WAAY,YAAW,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC;IACpD,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,kBAAuB;IAE9C,WAAW,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAwC9E,cAAc,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAgC7D,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,QAAQ;IAWhE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,GAAG,QAAQ;CA4B3D"}

package/dist/src/adapters/next.js

@@ -0,0 +1,109 @@
+/**
+ * Next.js Adapter for App Router
+ *
+ * Handles Next.js App Router with Web Request/Response API
+ */
+import { AdapterUtils } from './base';
+import { PaywallError } from '../paywall';
+/**
+ * Next.js Adapter implementation
+ */
+export class NextAdapter {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async extractArgs([request, context]) {
+        if (this.options.extractArgs) {
+            return await this.options.extractArgs(request, context);
+        }
+        // Default extraction from URL, body, and route params
+        const url = new URL(request.url);
+        const query = Object.fromEntries(url.searchParams.entries());
+        // Parse request body if present
+        let body = {};
+        try {
+            if (request.method !== 'GET' &&
+                request.headers.get('content-type')?.includes('application/json')) {
+                body = await request.json();
+            }
+        }
+        catch {
+            // If parsing fails, continue with empty body
+        }
+        // Handle route parameters if provided
+        let routeParams = {};
+        if (context?.params) {
+            if (typeof context.params === 'object' && 'then' in context.params) {
+                // Handle Promise<params> case (Next.js 15+ app router)
+                routeParams = await context.params;
+            }
+            else {
+                routeParams = context.params;
+            }
+        }
+        return {
+            ...body,
+            ...query,
+            ...routeParams,
+        };
+    }
+    async getCustomerRef([request]) {
+        if (this.options.getCustomerRef) {
+            const ref = await this.options.getCustomerRef(request);
+            return AdapterUtils.ensureCustomerRef(ref);
+        }
+        // Try to get from JWT token first
+        const authHeader = request.headers.get('authorization');
+        if (authHeader && authHeader.startsWith('Bearer ')) {
+            const token = authHeader.substring(7);
+            const jwtSub = await AdapterUtils.extractFromJWT(token);
+            if (jwtSub) {
+                return AdapterUtils.ensureCustomerRef(jwtSub);
+            }
+        }
+        // Try x-user-id header (set by middleware, e.g., Supabase auth)
+        const userId = request.headers.get('x-user-id');
+        if (userId) {
+            return AdapterUtils.ensureCustomerRef(userId);
+        }
+        // Fallback to x-customer-ref header
+        const headerRef = request.headers.get('x-customer-ref');
+        if (headerRef) {
+            return AdapterUtils.ensureCustomerRef(headerRef);
+        }
+        // Default to demo_user for Next.js (common in examples)
+        return 'demo_user';
+    }
+    formatResponse(result, _context) {
+        const transformed = this.options.transformResponse
+            ? this.options.transformResponse(result)
+            : result;
+        return new Response(JSON.stringify(transformed), {
+            status: 200,
+            headers: { 'Content-Type': 'application/json' },
+        });
+    }
+    formatError(error, _context) {
+        if (error instanceof PaywallError) {
+            return new Response(JSON.stringify({
+                success: false,
+                error: 'Payment required',
+                product: error.structuredContent.product,
+                checkoutUrl: error.structuredContent.checkoutUrl,
+                message: error.structuredContent.message,
+            }), {
+                status: 402,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+        return new Response(JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Internal server error',
+        }), {
+            status: 500,
+            headers: { 'Content-Type': 'application/json' },
+        });
+    }
+}
+//# sourceMappingURL=next.js.map

package/dist/src/adapters/next.js.map

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

package/dist/src/client.d.ts

@@ -0,0 +1,58 @@
+/**
+ * SolvaPay Server SDK - API Client
+ *
+ * This module provides the API client implementation for communicating with
+ * the SolvaPay backend. The client handles all HTTP requests for paywall
+ * protection, usage tracking, and resource management.
+ */
+import type { SolvaPayClient } from './types';
+/**
+ * Configuration options for creating a SolvaPay API client
+ */
+export type ServerClientOptions = {
+    /**
+     * Your SolvaPay API key (required)
+     */
+    apiKey: string;
+    /**
+     * Base URL for the SolvaPay API (optional)
+     * Defaults to https://api.solvapay.com
+     */
+    apiBaseUrl?: string;
+};
+/**
+ * Creates a SolvaPay API client that implements the full SolvaPayClient interface.
+ *
+ * This function creates a low-level API client for direct communication with the
+ * SolvaPay backend. For most use cases, use `createSolvaPay()` instead, which
+ * provides a higher-level API with paywall protection.
+ *
+ * Use this function when you need:
+ * - Direct API access for custom operations
+ * - Testing with custom client implementations
+ * - Advanced use cases not covered by the main API
+ *
+ * @param opts - Configuration options
+ * @param opts.apiKey - Your SolvaPay API key (required)
+ * @param opts.apiBaseUrl - Optional API base URL override
+ * @returns A fully configured SolvaPayClient instance
+ * @throws {SolvaPayError} If API key is missing
+ *
+ * @example
+ * ```typescript
+ * // Create API client directly
+ * const client = createSolvaPayClient({
+ *   apiKey: process.env.SOLVAPAY_SECRET_KEY!,
+ *   apiBaseUrl: 'https://api.solvapay.com' // optional
+ * });
+ *
+ * // Use client for custom operations
+ * const products = await client.listProducts();
+ * ```
+ *
+ * @see {@link createSolvaPay} for the recommended high-level API
+ * @see {@link ServerClientOptions} for configuration options
+ * @since 1.0.0
+ */
+export declare function createSolvaPayClient(opts: ServerClientOptions): SolvaPayClient;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,cAAc,CA0iB9E"}