@nevermined-io/payments 1.8.0 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/README.md +2 -1
  2. package/dist/api/base-payments.d.ts +11 -0
  3. package/dist/api/base-payments.d.ts.map +1 -1
  4. package/dist/api/base-payments.js +28 -3
  5. package/dist/api/base-payments.js.map +1 -1
  6. package/dist/common/types.d.ts +9 -4
  7. package/dist/common/types.d.ts.map +1 -1
  8. package/dist/common/types.js.map +1 -1
  9. package/dist/environments.d.ts +12 -0
  10. package/dist/environments.d.ts.map +1 -1
  11. package/dist/environments.js +31 -0
  12. package/dist/environments.js.map +1 -1
  13. package/dist/mcp/core/auth.d.ts +2 -2
  14. package/dist/mcp/core/auth.d.ts.map +1 -1
  15. package/dist/mcp/core/auth.js +29 -18
  16. package/dist/mcp/core/auth.js.map +1 -1
  17. package/dist/mcp/core/paywall.d.ts.map +1 -1
  18. package/dist/mcp/core/paywall.js +10 -6
  19. package/dist/mcp/core/paywall.js.map +1 -1
  20. package/dist/mcp/core/server-manager.d.ts.map +1 -1
  21. package/dist/mcp/core/server-manager.js +6 -4
  22. package/dist/mcp/core/server-manager.js.map +1 -1
  23. package/dist/mcp/http/client-registration.d.ts.map +1 -1
  24. package/dist/mcp/http/client-registration.js +4 -2
  25. package/dist/mcp/http/client-registration.js.map +1 -1
  26. package/dist/mcp/http/oauth-metadata.d.ts.map +1 -1
  27. package/dist/mcp/http/oauth-metadata.js +2 -1
  28. package/dist/mcp/http/oauth-metadata.js.map +1 -1
  29. package/dist/mcp/index.d.ts +12 -5
  30. package/dist/mcp/index.d.ts.map +1 -1
  31. package/dist/mcp/index.js +46 -23
  32. package/dist/mcp/index.js.map +1 -1
  33. package/dist/mcp/types/http.types.d.ts +2 -2
  34. package/dist/mcp/types/http.types.d.ts.map +1 -1
  35. package/dist/mcp/types/http.types.js.map +1 -1
  36. package/dist/mcp/types/paywall.types.d.ts +6 -2
  37. package/dist/mcp/types/paywall.types.d.ts.map +1 -1
  38. package/dist/mcp/types/paywall.types.js.map +1 -1
  39. package/dist/mcp/types/server.types.d.ts +4 -2
  40. package/dist/mcp/types/server.types.d.ts.map +1 -1
  41. package/dist/mcp/types/server.types.js.map +1 -1
  42. package/dist/payments.d.ts.map +1 -1
  43. package/package.json +3 -1
@@ -1 +1 @@
1
- {"version":3,"file":"server.types.d.ts","sourceRoot":"","sources":["../../../src/mcp/types/server.types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"server.types.d.ts","sourceRoot":"","sources":["../../../src/mcp/types/server.types.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"server.types.js","sourceRoot":"","sources":["../../../src/mcp/types/server.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Types for the simplified MCP server API.\n * These types define the high-level API that hides McpServer, Transport, and Express details.\n */\n\nimport type { EnvironmentName } from '../../environments.js'\nimport type { CreditsOption } from './paywall.types.js'\nimport type { ZodType } from 'zod'\n/**\n * Configuration for a tool.\n */\nexport interface McpToolConfig {\n /** Human-readable title for the tool */\n title?: string\n /** Description of what the tool does */\n description: string\n /** Zod schema for input arguments (will be converted to JSON Schema internally) */\n inputSchema?: ZodType\n /** JSON Schema for output (optional) */\n outputSchema?: Record<string, any>\n}\n\n/**\n * Configuration for a resource.\n */\nexport interface McpResourceConfig {\n /** Human-readable title for the resource */\n title?: string\n /** Description of the resource */\n description?: string\n /** MIME type of the resource content */\n mimeType?: string\n}\n\n/**\n * Configuration for a prompt.\n */\nexport interface McpPromptConfig {\n /** Human-readable title for the prompt */\n title?: string\n /** Description of the prompt */\n description?: string\n /** Arguments the prompt accepts (ZodRawShape or ZodType) */\n argsSchema?: any\n}\n\n/**\n * Options for tool/resource/prompt registration.\n */\nexport interface McpRegistrationOptions {\n /** Credits to charge per call (default: 1). Can be a fixed value or a function that receives context with args and result. */\n credits?: CreditsOption | number\n /** What to do if credit redemption fails */\n onRedeemError?: 'ignore' | 'propagate'\n}\n\n/**\n * Handler function for a tool.\n */\nexport type ToolHandler<TArgs = any, TResult = any> = (\n args: TArgs,\n context?: ToolContext,\n) => Promise<TResult> | TResult\n\n/**\n * Handler function for a resource.\n */\nexport type ResourceHandler<TResult = any> = (\n uri: URL,\n variables: Record<string, string | string[]>,\n context?: ResourceContext,\n) => Promise<TResult> | TResult\n\n/**\n * Handler function for a prompt.\n */\nexport type PromptHandler<TResult = any> = (\n args: Record<string, string>,\n context?: PromptContext,\n) => Promise<TResult> | TResult\n\n/**\n * Context passed to tool handlers.\n */\nexport interface ToolContext {\n /** Request ID for tracking */\n requestId?: string\n /** Credits available/charged */\n credits?: bigint\n /** Raw MCP extra context */\n extra?: any\n}\n\n/**\n * Context passed to resource handlers.\n */\nexport interface ResourceContext {\n /** Request ID for tracking */\n requestId?: string\n /** Credits available/charged */\n credits?: bigint\n /** Raw MCP extra context */\n extra?: any\n}\n\n/**\n * Context passed to prompt handlers.\n */\nexport interface PromptContext {\n /** Request ID for tracking */\n requestId?: string\n /** Credits available/charged */\n credits?: bigint\n /** Raw MCP extra context */\n extra?: any\n}\n\n/**\n * Configuration for starting the MCP server.\n */\nexport interface McpServerConfig {\n /** Port to listen on */\n port: number\n /** Agent ID (DID) for Nevermined */\n agentId: string\n /** Human-readable server name */\n serverName: string\n /** Base URL of the server (default: http://localhost:\\{port\\}) */\n baseUrl?: string\n /** Host to bind to (default: 0.0.0.0) */\n host?: string\n /** Nevermined environment (default: from Payments instance) */\n environment?: EnvironmentName\n /** Server version (default: 1.0.0) */\n version?: string\n /** Server description */\n description?: string\n /** CORS origins (default: *) */\n corsOrigins?: string | string[]\n /** Enable OAuth discovery endpoints (default: true) */\n enableOAuthDiscovery?: boolean\n /** Enable client registration (default: true) */\n enableClientRegistration?: boolean\n /** Enable health check endpoint (default: true) */\n enableHealthCheck?: boolean\n /** Enable server info endpoint (default: true) */\n enableServerInfo?: boolean\n /** Callback when server starts */\n onStart?: (info: ServerInfo) => void\n /** Callback for logging */\n onLog?: (message: string, level?: 'info' | 'warn' | 'error') => void\n}\n\n/**\n * Information about a running server.\n */\nexport interface ServerInfo {\n /** Base URL of the server */\n baseUrl: string\n /** Port the server is listening on */\n port: number\n /** List of registered tools */\n tools: string[]\n /** List of registered resources */\n resources: string[]\n /** List of registered prompts */\n prompts: string[]\n}\n\n/**\n * Result of starting the server.\n */\nexport interface McpServerResult {\n /** Server info */\n info: ServerInfo\n /** Stop the server gracefully */\n stop: () => Promise<void>\n}\n\n/**\n * Internal registration entry for a tool.\n */\nexport interface ToolRegistration {\n name: string\n config: McpToolConfig\n handler: ToolHandler\n options: McpRegistrationOptions\n}\n\n/**\n * Internal registration entry for a resource.\n */\nexport interface ResourceRegistration {\n name: string\n uriOrTemplate: string\n config: McpResourceConfig\n handler: ResourceHandler\n options: McpRegistrationOptions\n}\n\n/**\n * Internal registration entry for a prompt.\n */\nexport interface PromptRegistration {\n name: string\n config: McpPromptConfig\n handler: PromptHandler\n options: McpRegistrationOptions\n}\n"]}
1
+ {"version":3,"file":"server.types.js","sourceRoot":"","sources":["../../../src/mcp/types/server.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Types for the simplified MCP server API.\n * These types define the high-level API that hides McpServer, Transport, and Express details.\n */\n\nimport type { EnvironmentName } from '../../environments.js'\nimport type { CreditsOption } from './paywall.types.js'\nimport type { ZodType } from 'zod'\n/**\n * Configuration for a tool.\n */\nexport interface McpToolConfig {\n /** Human-readable title for the tool */\n title?: string\n /** Description of what the tool does */\n description: string\n /** Zod schema for input arguments (will be converted to JSON Schema internally) */\n inputSchema?: ZodType\n /** JSON Schema for output (optional) */\n outputSchema?: Record<string, any>\n}\n\n/**\n * Configuration for a resource.\n */\nexport interface McpResourceConfig {\n /** Human-readable title for the resource */\n title?: string\n /** Description of the resource */\n description?: string\n /** MIME type of the resource content */\n mimeType?: string\n}\n\n/**\n * Configuration for a prompt.\n */\nexport interface McpPromptConfig {\n /** Human-readable title for the prompt */\n title?: string\n /** Description of the prompt */\n description?: string\n /** Arguments the prompt accepts (ZodRawShape or ZodType) */\n argsSchema?: any\n}\n\n/**\n * Options for tool/resource/prompt registration.\n */\nexport interface McpRegistrationOptions {\n /** Credits to charge per call (default: 1). Can be a fixed value or a function that receives context with args and result. */\n credits?: CreditsOption | number\n /** What to do if credit redemption fails */\n onRedeemError?: 'ignore' | 'propagate'\n}\n\n/**\n * Handler function for a tool.\n */\nexport type ToolHandler<TArgs = any, TResult = any> = (\n args: TArgs,\n context?: ToolContext,\n) => Promise<TResult> | TResult\n\n/**\n * Handler function for a resource.\n */\nexport type ResourceHandler<TResult = any> = (\n uri: URL,\n variables: Record<string, string | string[]>,\n context?: ResourceContext,\n) => Promise<TResult> | TResult\n\n/**\n * Handler function for a prompt.\n */\nexport type PromptHandler<TResult = any> = (\n args: Record<string, string>,\n context?: PromptContext,\n) => Promise<TResult> | TResult\n\n/**\n * Context passed to tool handlers.\n */\nexport interface ToolContext {\n /** Request ID for tracking */\n requestId?: string\n /** Credits available/charged */\n credits?: bigint\n /** Raw MCP extra context */\n extra?: any\n}\n\n/**\n * Context passed to resource handlers.\n */\nexport interface ResourceContext {\n /** Request ID for tracking */\n requestId?: string\n /** Credits available/charged */\n credits?: bigint\n /** Raw MCP extra context */\n extra?: any\n}\n\n/**\n * Context passed to prompt handlers.\n */\nexport interface PromptContext {\n /** Request ID for tracking */\n requestId?: string\n /** Credits available/charged */\n credits?: bigint\n /** Raw MCP extra context */\n extra?: any\n}\n\n/**\n * Configuration for starting the MCP server.\n */\nexport interface McpServerConfig {\n /** Port to listen on */\n port: number\n /** Plan ID the server charges against (required) */\n planId: string\n /** Agent ID (DID) for Nevermined — optional, informational only */\n agentId?: string\n /** Human-readable server name */\n serverName: string\n /** Base URL of the server (default: http://localhost:\\{port\\}) */\n baseUrl?: string\n /** Host to bind to (default: 0.0.0.0) */\n host?: string\n /** Nevermined environment (default: from Payments instance) */\n environment?: EnvironmentName\n /** Server version (default: 1.0.0) */\n version?: string\n /** Server description */\n description?: string\n /** CORS origins (default: *) */\n corsOrigins?: string | string[]\n /** Enable OAuth discovery endpoints (default: true) */\n enableOAuthDiscovery?: boolean\n /** Enable client registration (default: true) */\n enableClientRegistration?: boolean\n /** Enable health check endpoint (default: true) */\n enableHealthCheck?: boolean\n /** Enable server info endpoint (default: true) */\n enableServerInfo?: boolean\n /** Callback when server starts */\n onStart?: (info: ServerInfo) => void\n /** Callback for logging */\n onLog?: (message: string, level?: 'info' | 'warn' | 'error') => void\n}\n\n/**\n * Information about a running server.\n */\nexport interface ServerInfo {\n /** Base URL of the server */\n baseUrl: string\n /** Port the server is listening on */\n port: number\n /** List of registered tools */\n tools: string[]\n /** List of registered resources */\n resources: string[]\n /** List of registered prompts */\n prompts: string[]\n}\n\n/**\n * Result of starting the server.\n */\nexport interface McpServerResult {\n /** Server info */\n info: ServerInfo\n /** Stop the server gracefully */\n stop: () => Promise<void>\n}\n\n/**\n * Internal registration entry for a tool.\n */\nexport interface ToolRegistration {\n name: string\n config: McpToolConfig\n handler: ToolHandler\n options: McpRegistrationOptions\n}\n\n/**\n * Internal registration entry for a resource.\n */\nexport interface ResourceRegistration {\n name: string\n uriOrTemplate: string\n config: McpResourceConfig\n handler: ResourceHandler\n options: McpRegistrationOptions\n}\n\n/**\n * Internal registration entry for a prompt.\n */\nexport interface PromptRegistration {\n name: string\n config: McpPromptConfig\n handler: PromptHandler\n options: McpRegistrationOptions\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../src/payments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AAE/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAExF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD;;;;;;;;;;;;GAYG;AACH,qBAAa,QAAS,SAAQ,eAAe;IACpC,KAAK,EAAG,UAAU,CAAA;IAClB,KAAK,EAAG,QAAQ,CAAA;IAChB,MAAM,EAAG,SAAS,CAAA;IAClB,QAAQ,EAAG,gBAAgB,CAAA;IAC3B,aAAa,EAAG,gBAAgB,CAAA;IAChC,aAAa,EAAG,gBAAgB,CAAA;IAChC,SAAS,EAAG,YAAY,CAAA;IACxB,WAAW,EAAG,cAAc,CAAA;IAC5B,IAAI,EAAG,YAAY,CAAA;IAC1B,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAC,CAAe;IAEnC;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAAC,CAAkD;IAE1E;;;OAGG;IACH,IAAW,GAAG;QAEV;;;WAGG;yBAEQ,IAAI,CAAC,wBAAwB,EAAE,iBAAiB,CAAC,KACzD,uBAAuB;QAE1B;;;;WAIG;6BACwB,GAAG;MAOjC;IAED;;;OAGG;IACH,IAAW,GAAG;;;sDA0HgD,CAAC,cAC5D,CAAC,2LAKA,CAAC;sDAKuB,CAAC,cAC1B,CAAC,uEAAiE,CAAC;oFAQrE,CAAF,cAAoB,CAAC,mLAWV,CAAC;;;;;;;6FA6BoB,CAAC,cAI9B,CAHJ;8IAec,CAAC,cACb,CAAC;+FAEmc,CAAC,cAAc,CAAC;;;kBAtCxb,CAAC;;;;mBAsC04F,CAAC;;;;;;;;;MApMv6F;IAED;;;;;;;OAOG;IACH,IAAW,UAAU,IAAI,aAAa,CAUrC;IAED;;;OAGG;IACH,MAAM,CAAC,GAAG;;MAA4B;IAEtC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,cAAc;IAO1C;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc;IAoBjD;;;;;OAKG;IACH,OAAO;IAOP;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;;;;;;;;;OAUG;IACI,OAAO;IAMd;;;;;;;;;OASG;IACI,MAAM;IAIb;;;;;;;;;;;;;;;;;;;;OAoBG;IACa,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAgBtE;;;;;;;OAOG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;CACF"}
1
+ {"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../src/payments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AAE/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAExF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD;;;;;;;;;;;;GAYG;AACH,qBAAa,QAAS,SAAQ,eAAe;IACpC,KAAK,EAAG,UAAU,CAAA;IAClB,KAAK,EAAG,QAAQ,CAAA;IAChB,MAAM,EAAG,SAAS,CAAA;IAClB,QAAQ,EAAG,gBAAgB,CAAA;IAC3B,aAAa,EAAG,gBAAgB,CAAA;IAChC,aAAa,EAAG,gBAAgB,CAAA;IAChC,SAAS,EAAG,YAAY,CAAA;IACxB,WAAW,EAAG,cAAc,CAAA;IAC5B,IAAI,EAAG,YAAY,CAAA;IAC1B,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAC,CAAe;IAEnC;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAAC,CAAkD;IAE1E;;;OAGG;IACH,IAAW,GAAG;QAEV;;;WAGG;yBAEQ,IAAI,CAAC,wBAAwB,EAAE,iBAAiB,CAAC,KACzD,uBAAuB;QAE1B;;;;WAIG;6BACwB,GAAG;MAOjC;IAED;;;OAGG;IACH,IAAW,GAAG;;;sDA+JO,CAAA,cAAc,CAAC,2LAEgC,CAAC;sDAE/C,CAAC,cAAc,CAAC,uEAGrC,CAAA;oFAGsC,CAAC,cAC1B,CAAC,mLAGwC,CAAC;;;;;;;6FA4B4yB,CAAC,cAAc,CAAC;8IAAwd,CAAC,cAAwB,CAAC;+FAAyc,CAAC,cAAc,CAAC;;;kBAJvyD,CAAC;;;;mBAIqvK,CAAC;;;;;;;;;MApM9wK;IAED;;;;;;;OAOG;IACH,IAAW,UAAU,IAAI,aAAa,CAUrC;IAED;;;OAGG;IACH,MAAM,CAAC,GAAG;;MAA4B;IAEtC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,cAAc;IAO1C;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc;IAoBjD;;;;;OAKG;IACH,OAAO;IAOP;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;;;;;;;;;OAUG;IACI,OAAO;IAMd;;;;;;;;;OASG;IACI,MAAM;IAIb;;;;;;;;;;;;;;;;;;;;OAoBG;IACa,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAgBtE;;;;;;;OAOG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;CACF"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nevermined-io/payments",
3
- "version": "1.8.0",
3
+ "version": "1.10.0",
4
4
  "description": "Typescript SDK to interact with the Nevermined Payments Protocol",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",
@@ -53,6 +53,8 @@
53
53
  "format": "prettier --check ./src",
54
54
  "prepublishOnly": "pnpm build",
55
55
  "doc": "typedoc --out docs ./src",
56
+ "docs:lint-links": "python3 ./scripts/lint_doc_links.py",
57
+ "docs:check-links": "./scripts/check_synced_doc_links.sh",
56
58
  "cli:build": "cd cli && pnpm build",
57
59
  "cli:dev": "cd cli && pnpm dev",
58
60
  "cli:test": "cd cli && pnpm test",