@kelviq/mcp-server 0.2.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 (149) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +322 -0
  3. package/dist/config.d.ts +16 -0
  4. package/dist/config.js +45 -0
  5. package/dist/config.js.map +1 -0
  6. package/dist/docs/README.md +128 -0
  7. package/dist/docs/api-reference/authentication.md +41 -0
  8. package/dist/docs/backend-integration/node-sdk.md +1040 -0
  9. package/dist/docs/backend-integration/python-sdk.md +1198 -0
  10. package/dist/docs/changelog/app.md +80 -0
  11. package/dist/docs/changelog/checkout-api.md +59 -0
  12. package/dist/docs/changelog/js-promotions-ui.md +14 -0
  13. package/dist/docs/changelog/js-sdk.md +281 -0
  14. package/dist/docs/changelog/node-sdk.md +378 -0
  15. package/dist/docs/changelog/python-sdk.md +456 -0
  16. package/dist/docs/changelog/react-sdk.md +580 -0
  17. package/dist/docs/checkout/checkout-configuration.md +434 -0
  18. package/dist/docs/coustomers-management/overview.md +111 -0
  19. package/dist/docs/customer-portal/overview.md +81 -0
  20. package/dist/docs/frontend-integration/js-sdk.md +676 -0
  21. package/dist/docs/frontend-integration/promotions-ui-js.md +265 -0
  22. package/dist/docs/frontend-integration/react-promotions-ui.md +361 -0
  23. package/dist/docs/frontend-integration/react-sdk.md +1187 -0
  24. package/dist/docs/frontend-integration/react-ui.md +771 -0
  25. package/dist/docs/getstarted/fees.md +160 -0
  26. package/dist/docs/getstarted/introduction-to-kelviq.md +80 -0
  27. package/dist/docs/getstarted/merchant-of-record.md +64 -0
  28. package/dist/docs/getstarted/review-process.md +190 -0
  29. package/dist/docs/guides/subscription-integration-for-nextjs.md +512 -0
  30. package/dist/docs/guides/subscription-integration.md +291 -0
  31. package/dist/docs/guides/webhooks.md +963 -0
  32. package/dist/docs/legal/approved-prohibited-policy.md +252 -0
  33. package/dist/docs/legal/buyer-terms.md +177 -0
  34. package/dist/docs/legal/compliant-user-flow.md +216 -0
  35. package/dist/docs/legal/master-service-agreement.md +404 -0
  36. package/dist/docs/legal/payment-flow-diagram.md +188 -0
  37. package/dist/docs/legal/seller-terms.md +169 -0
  38. package/dist/docs/manifest.json +415 -0
  39. package/dist/docs/monetization/offerings.md +156 -0
  40. package/dist/docs/monetization/pricing-tables.md +226 -0
  41. package/dist/docs/monetization/targeting-rules.md +278 -0
  42. package/dist/docs/openapi.json +5479 -0
  43. package/dist/docs/payouts/overview.md +43 -0
  44. package/dist/docs/payouts/payout-account.md +12 -0
  45. package/dist/docs/payouts/transactions.md +23 -0
  46. package/dist/docs/product-catalog/digital-downloads.md +117 -0
  47. package/dist/docs/product-catalog/discounts.md +69 -0
  48. package/dist/docs/product-catalog/entitlements.md +428 -0
  49. package/dist/docs/product-catalog/free-and-trials.md +36 -0
  50. package/dist/docs/product-catalog/license-keys.md +324 -0
  51. package/dist/docs/product-catalog/links.md +92 -0
  52. package/dist/docs/product-catalog/location-based-pricing.md +41 -0
  53. package/dist/docs/product-catalog/one-time-payments.md +24 -0
  54. package/dist/docs/product-catalog/plans.md +199 -0
  55. package/dist/docs/product-catalog/products.md +60 -0
  56. package/dist/docs/product-catalog/subscriptions.md +29 -0
  57. package/dist/docs/product-catalog/tax-settings.md +37 -0
  58. package/dist/docs/product-catalog/usage-based-billing.md +119 -0
  59. package/dist/docs/promotions/create-a-promotion.md +75 -0
  60. package/dist/docs/promotions/customize-banner.md +41 -0
  61. package/dist/docs/promotions/integrate.md +38 -0
  62. package/dist/docs/promotions/overview.md +51 -0
  63. package/dist/docs/quickstart/core-concepts.md +146 -0
  64. package/dist/docs/quickstart/dashboard-setup.md +129 -0
  65. package/dist/docs/quickstart/integrate-with-your-app.md +149 -0
  66. package/dist/docs/sales/checkout-sessions.md +58 -0
  67. package/dist/docs/sales/orders.md +76 -0
  68. package/dist/http/client.d.ts +28 -0
  69. package/dist/http/client.js +76 -0
  70. package/dist/http/client.js.map +1 -0
  71. package/dist/http/errors.d.ts +20 -0
  72. package/dist/http/errors.js +58 -0
  73. package/dist/http/errors.js.map +1 -0
  74. package/dist/resources/docs-index.d.ts +25 -0
  75. package/dist/resources/docs-index.js +109 -0
  76. package/dist/resources/docs-index.js.map +1 -0
  77. package/dist/resources/index.d.ts +2 -0
  78. package/dist/resources/index.js +73 -0
  79. package/dist/resources/index.js.map +1 -0
  80. package/dist/schemas/kelviq.d.ts +1304 -0
  81. package/dist/schemas/kelviq.js +468 -0
  82. package/dist/schemas/kelviq.js.map +1 -0
  83. package/dist/server.d.ts +2 -0
  84. package/dist/server.js +41 -0
  85. package/dist/server.js.map +1 -0
  86. package/dist/tools/_util.d.ts +15 -0
  87. package/dist/tools/_util.js +15 -0
  88. package/dist/tools/_util.js.map +1 -0
  89. package/dist/tools/checkout.d.ts +3 -0
  90. package/dist/tools/checkout.js +18 -0
  91. package/dist/tools/checkout.js.map +1 -0
  92. package/dist/tools/customers.d.ts +3 -0
  93. package/dist/tools/customers.js +32 -0
  94. package/dist/tools/customers.js.map +1 -0
  95. package/dist/tools/docs.d.ts +2 -0
  96. package/dist/tools/docs.js +43 -0
  97. package/dist/tools/docs.js.map +1 -0
  98. package/dist/tools/entitlements.d.ts +3 -0
  99. package/dist/tools/entitlements.js +22 -0
  100. package/dist/tools/entitlements.js.map +1 -0
  101. package/dist/tools/features.d.ts +3 -0
  102. package/dist/tools/features.js +55 -0
  103. package/dist/tools/features.js.map +1 -0
  104. package/dist/tools/index.d.ts +3 -0
  105. package/dist/tools/index.js +44 -0
  106. package/dist/tools/index.js.map +1 -0
  107. package/dist/tools/licenses.d.ts +3 -0
  108. package/dist/tools/licenses.js +44 -0
  109. package/dist/tools/licenses.js.map +1 -0
  110. package/dist/tools/media.d.ts +3 -0
  111. package/dist/tools/media.js +18 -0
  112. package/dist/tools/media.js.map +1 -0
  113. package/dist/tools/offerings.d.ts +3 -0
  114. package/dist/tools/offerings.js +21 -0
  115. package/dist/tools/offerings.js.map +1 -0
  116. package/dist/tools/partner.d.ts +3 -0
  117. package/dist/tools/partner.js +55 -0
  118. package/dist/tools/partner.js.map +1 -0
  119. package/dist/tools/plan-entitlements.d.ts +3 -0
  120. package/dist/tools/plan-entitlements.js +56 -0
  121. package/dist/tools/plan-entitlements.js.map +1 -0
  122. package/dist/tools/plan-files.d.ts +3 -0
  123. package/dist/tools/plan-files.js +43 -0
  124. package/dist/tools/plan-files.js.map +1 -0
  125. package/dist/tools/plans.d.ts +3 -0
  126. package/dist/tools/plans.js +120 -0
  127. package/dist/tools/plans.js.map +1 -0
  128. package/dist/tools/portal.d.ts +3 -0
  129. package/dist/tools/portal.js +18 -0
  130. package/dist/tools/portal.js.map +1 -0
  131. package/dist/tools/product-files.d.ts +3 -0
  132. package/dist/tools/product-files.js +31 -0
  133. package/dist/tools/product-files.js.map +1 -0
  134. package/dist/tools/product-settings.d.ts +3 -0
  135. package/dist/tools/product-settings.js +31 -0
  136. package/dist/tools/product-settings.js.map +1 -0
  137. package/dist/tools/products.d.ts +3 -0
  138. package/dist/tools/products.js +69 -0
  139. package/dist/tools/products.js.map +1 -0
  140. package/dist/tools/promotions.d.ts +3 -0
  141. package/dist/tools/promotions.js +19 -0
  142. package/dist/tools/promotions.js.map +1 -0
  143. package/dist/tools/subscriptions.d.ts +3 -0
  144. package/dist/tools/subscriptions.js +63 -0
  145. package/dist/tools/subscriptions.js.map +1 -0
  146. package/dist/tools/usage.d.ts +3 -0
  147. package/dist/tools/usage.js +18 -0
  148. package/dist/tools/usage.js.map +1 -0
  149. package/package.json +88 -0
@@ -0,0 +1,58 @@
1
+ export function isKelviqAPIError(value) {
2
+ return (typeof value === 'object' &&
3
+ value !== null &&
4
+ 'error' in value &&
5
+ typeof value.error === 'object');
6
+ }
7
+ export function fromHttpResponse(httpStatus, body) {
8
+ if (typeof body === 'object' && body !== null) {
9
+ const obj = body;
10
+ if (typeof obj.message === 'string' || typeof obj.status === 'string') {
11
+ return {
12
+ error: {
13
+ status: typeof obj.status === 'string' ? obj.status : `HTTP ${httpStatus}`,
14
+ message: typeof obj.message === 'string' ? obj.message : `Request failed with HTTP ${httpStatus}`,
15
+ httpStatus,
16
+ raw: body,
17
+ },
18
+ };
19
+ }
20
+ if (typeof obj.detail === 'string') {
21
+ return {
22
+ error: {
23
+ status: `HTTP ${httpStatus}`,
24
+ message: obj.detail,
25
+ httpStatus,
26
+ raw: body,
27
+ },
28
+ };
29
+ }
30
+ }
31
+ return {
32
+ error: {
33
+ status: `HTTP ${httpStatus}`,
34
+ message: typeof body === 'string' && body.length < 500
35
+ ? body
36
+ : `Request failed with HTTP ${httpStatus}`,
37
+ httpStatus,
38
+ raw: body,
39
+ },
40
+ };
41
+ }
42
+ export function fromException(err) {
43
+ if (err instanceof Error) {
44
+ return {
45
+ error: {
46
+ status: err.name || 'Error',
47
+ message: err.message,
48
+ },
49
+ };
50
+ }
51
+ return {
52
+ error: {
53
+ status: 'Error',
54
+ message: String(err),
55
+ },
56
+ };
57
+ }
58
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,IAAI,KAAK;QAChB,OAAQ,KAA4B,CAAC,KAAK,KAAK,QAAQ,CACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,IAAa;IAChE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,IAA+B,CAAC;QAC5C,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtE,OAAO;gBACL,KAAK,EAAE;oBACL,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,UAAU,EAAE;oBAC1E,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B,UAAU,EAAE;oBACjG,UAAU;oBACV,GAAG,EAAE,IAAI;iBACV;aACF,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO;gBACL,KAAK,EAAE;oBACL,MAAM,EAAE,QAAQ,UAAU,EAAE;oBAC5B,OAAO,EAAE,GAAG,CAAC,MAAM;oBACnB,UAAU;oBACV,GAAG,EAAE,IAAI;iBACV;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO;QACL,KAAK,EAAE;YACL,MAAM,EAAE,QAAQ,UAAU,EAAE;YAC5B,OAAO,EAAE,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;gBACpD,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,4BAA4B,UAAU,EAAE;YAC5C,UAAU;YACV,GAAG,EAAE,IAAI;SACV;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO;YACL,KAAK,EAAE;gBACL,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,OAAO;gBAC3B,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB;SACF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,EAAE;YACL,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;SACrB;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,25 @@
1
+ export interface DocEntry {
2
+ slug: string;
3
+ section: string;
4
+ title: string;
5
+ description: string | null;
6
+ path: string;
7
+ }
8
+ export interface DocSearchHit {
9
+ slug: string;
10
+ section: string;
11
+ title: string;
12
+ description: string | null;
13
+ score: number;
14
+ snippet: string;
15
+ }
16
+ interface IndexedDoc extends DocEntry {
17
+ body: string;
18
+ }
19
+ export declare function listDocs(): Promise<DocEntry[]>;
20
+ export declare function readDoc(slug: string): Promise<IndexedDoc | undefined>;
21
+ export declare function searchDocs(query: string, options?: {
22
+ limit?: number;
23
+ section?: string;
24
+ }): Promise<DocSearchHit[]>;
25
+ export {};
@@ -0,0 +1,109 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { existsSync, readFileSync } from 'node:fs';
3
+ import { dirname, join } from 'node:path';
4
+ import { fileURLToPath } from 'node:url';
5
+ import FlexSearchModule from 'flexsearch';
6
+ const HERE = dirname(fileURLToPath(import.meta.url));
7
+ const DOCS_DIR = join(HERE, '..', 'docs');
8
+ const MANIFEST_PATH = join(DOCS_DIR, 'manifest.json');
9
+ // FlexSearch ships as CJS; under NodeNext we land on the default export.
10
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
11
+ const FlexSearchAny = FlexSearchModule.default ?? FlexSearchModule;
12
+ let cache = null;
13
+ function loadManifest() {
14
+ if (!existsSync(MANIFEST_PATH)) {
15
+ throw new Error(`Docs manifest not found at ${MANIFEST_PATH}. Did the snapshot step run? Try: npm run snapshot`);
16
+ }
17
+ return JSON.parse(readFileSync(MANIFEST_PATH, 'utf8'));
18
+ }
19
+ async function buildIndex() {
20
+ const manifest = loadManifest();
21
+ const docs = new Map();
22
+ const index = new FlexSearchAny.Document({
23
+ document: {
24
+ id: 'slug',
25
+ index: ['title', 'description', 'body', 'section'],
26
+ store: ['slug', 'section', 'title', 'description'],
27
+ },
28
+ tokenize: 'forward',
29
+ cache: true,
30
+ });
31
+ await Promise.all(manifest.map(async (entry) => {
32
+ const full = join(DOCS_DIR, entry.path);
33
+ const text = await readFile(full, 'utf8');
34
+ // Strip our own frontmatter (added during snapshot) so the body alone is indexed.
35
+ const body = text.replace(/^---\n[\s\S]*?\n---\n/, '');
36
+ const indexed = { ...entry, body };
37
+ docs.set(entry.slug, indexed);
38
+ index.add({
39
+ slug: entry.slug,
40
+ section: entry.section,
41
+ title: entry.title,
42
+ description: entry.description ?? '',
43
+ body,
44
+ });
45
+ }));
46
+ cache = { index, docs, manifest };
47
+ }
48
+ async function ensureIndex() {
49
+ if (!cache)
50
+ await buildIndex();
51
+ return cache;
52
+ }
53
+ export async function listDocs() {
54
+ const { manifest } = await ensureIndex();
55
+ return manifest;
56
+ }
57
+ export async function readDoc(slug) {
58
+ const { docs } = await ensureIndex();
59
+ return docs.get(slug);
60
+ }
61
+ export async function searchDocs(query, options = {}) {
62
+ const { index, docs } = await ensureIndex();
63
+ const limit = options.limit ?? 8;
64
+ // FlexSearch returns one result group per indexed field.
65
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
66
+ const groups = index.search(query, {
67
+ limit: limit * 4,
68
+ enrich: true,
69
+ });
70
+ const seen = new Map();
71
+ for (const group of groups) {
72
+ for (const hit of group.result) {
73
+ const slug = String(hit.id);
74
+ if (seen.has(slug))
75
+ continue;
76
+ const doc = docs.get(slug);
77
+ if (!doc)
78
+ continue;
79
+ if (options.section && doc.section !== options.section)
80
+ continue;
81
+ seen.set(slug, {
82
+ slug: doc.slug,
83
+ section: doc.section,
84
+ title: doc.title,
85
+ description: doc.description,
86
+ score: group.field === 'title' ? 3 : group.field === 'description' ? 2 : 1,
87
+ snippet: makeSnippet(doc.body, query),
88
+ });
89
+ if (seen.size >= limit)
90
+ break;
91
+ }
92
+ if (seen.size >= limit)
93
+ break;
94
+ }
95
+ return [...seen.values()].sort((a, b) => b.score - a.score);
96
+ }
97
+ function makeSnippet(body, query, width = 200) {
98
+ const lower = body.toLowerCase();
99
+ const needle = query.toLowerCase().split(/\s+/).find((tok) => lower.includes(tok));
100
+ if (!needle)
101
+ return body.slice(0, width).trim() + (body.length > width ? '…' : '');
102
+ const idx = lower.indexOf(needle);
103
+ const start = Math.max(0, idx - Math.floor(width / 2));
104
+ const end = Math.min(body.length, start + width);
105
+ const prefix = start > 0 ? '…' : '';
106
+ const suffix = end < body.length ? '…' : '';
107
+ return prefix + body.slice(start, end).replace(/\s+/g, ' ').trim() + suffix;
108
+ }
109
+ //# sourceMappingURL=docs-index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs-index.js","sourceRoot":"","sources":["../../src/resources/docs-index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ export declare function registerResources(server: McpServer): void;
@@ -0,0 +1,73 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { dirname, join } from 'node:path';
3
+ import { fileURLToPath } from 'node:url';
4
+ import { existsSync } from 'node:fs';
5
+ import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
6
+ import { listDocs, readDoc } from './docs-index.js';
7
+ const HERE = dirname(fileURLToPath(import.meta.url));
8
+ const DOCS_DIR = join(HERE, '..', 'docs');
9
+ export function registerResources(server) {
10
+ // -- Doc pages (templated; one per MDX file) -----------------------------
11
+ server.registerResource('kelviq-doc', new ResourceTemplate('kelviq://docs/{+slug}', {
12
+ list: async () => {
13
+ const docs = await listDocs();
14
+ return {
15
+ resources: docs.map((d) => ({
16
+ uri: `kelviq://docs/${d.slug}`,
17
+ name: d.title,
18
+ description: d.description ?? `Kelviq documentation — ${d.section}`,
19
+ mimeType: 'text/markdown',
20
+ })),
21
+ };
22
+ },
23
+ }), {
24
+ title: 'Kelviq documentation page',
25
+ description: 'A single page from the Kelviq documentation. URIs look like kelviq://docs/<section>/<slug>.',
26
+ mimeType: 'text/markdown',
27
+ }, async (uri, variables) => {
28
+ const slugRaw = variables.slug;
29
+ const slug = Array.isArray(slugRaw) ? slugRaw.join('/') : String(slugRaw ?? '');
30
+ const doc = await readDoc(slug);
31
+ if (!doc) {
32
+ throw new Error(`Unknown doc slug: ${slug}`);
33
+ }
34
+ return {
35
+ contents: [
36
+ {
37
+ uri: uri.href,
38
+ mimeType: 'text/markdown',
39
+ text: `# ${doc.title}\n\n${doc.description ? `_${doc.description}_\n\n` : ''}${doc.body}`,
40
+ },
41
+ ],
42
+ };
43
+ });
44
+ // -- OpenAPI spec --------------------------------------------------------
45
+ server.registerResource('kelviq-openapi', 'kelviq://openapi.json', {
46
+ title: 'Kelviq OpenAPI spec',
47
+ description: 'Full OpenAPI 3.0 spec describing the Kelviq REST API. Useful when you need an exhaustive view of request/response shapes.',
48
+ mimeType: 'application/json',
49
+ }, async (uri) => {
50
+ const path = join(DOCS_DIR, 'openapi.json');
51
+ if (!existsSync(path))
52
+ throw new Error('openapi.json not bundled');
53
+ const text = await readFile(path, 'utf8');
54
+ return {
55
+ contents: [{ uri: uri.href, mimeType: 'application/json', text }],
56
+ };
57
+ });
58
+ // -- README --------------------------------------------------------------
59
+ server.registerResource('kelviq-readme', 'kelviq://README', {
60
+ title: 'Kelviq docs README',
61
+ description: 'Top-level overview of the Kelviq platform and where to find what.',
62
+ mimeType: 'text/markdown',
63
+ }, async (uri) => {
64
+ const path = join(DOCS_DIR, 'README.md');
65
+ if (!existsSync(path))
66
+ throw new Error('README.md not bundled');
67
+ const text = await readFile(path, 'utf8');
68
+ return {
69
+ contents: [{ uri: uri.href, mimeType: 'text/markdown', text }],
70
+ };
71
+ });
72
+ }
73
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"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"}