@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.
- package/LICENSE +21 -0
- package/README.md +322 -0
- package/dist/config.d.ts +16 -0
- package/dist/config.js +45 -0
- package/dist/config.js.map +1 -0
- package/dist/docs/README.md +128 -0
- package/dist/docs/api-reference/authentication.md +41 -0
- package/dist/docs/backend-integration/node-sdk.md +1040 -0
- package/dist/docs/backend-integration/python-sdk.md +1198 -0
- package/dist/docs/changelog/app.md +80 -0
- package/dist/docs/changelog/checkout-api.md +59 -0
- package/dist/docs/changelog/js-promotions-ui.md +14 -0
- package/dist/docs/changelog/js-sdk.md +281 -0
- package/dist/docs/changelog/node-sdk.md +378 -0
- package/dist/docs/changelog/python-sdk.md +456 -0
- package/dist/docs/changelog/react-sdk.md +580 -0
- package/dist/docs/checkout/checkout-configuration.md +434 -0
- package/dist/docs/coustomers-management/overview.md +111 -0
- package/dist/docs/customer-portal/overview.md +81 -0
- package/dist/docs/frontend-integration/js-sdk.md +676 -0
- package/dist/docs/frontend-integration/promotions-ui-js.md +265 -0
- package/dist/docs/frontend-integration/react-promotions-ui.md +361 -0
- package/dist/docs/frontend-integration/react-sdk.md +1187 -0
- package/dist/docs/frontend-integration/react-ui.md +771 -0
- package/dist/docs/getstarted/fees.md +160 -0
- package/dist/docs/getstarted/introduction-to-kelviq.md +80 -0
- package/dist/docs/getstarted/merchant-of-record.md +64 -0
- package/dist/docs/getstarted/review-process.md +190 -0
- package/dist/docs/guides/subscription-integration-for-nextjs.md +512 -0
- package/dist/docs/guides/subscription-integration.md +291 -0
- package/dist/docs/guides/webhooks.md +963 -0
- package/dist/docs/legal/approved-prohibited-policy.md +252 -0
- package/dist/docs/legal/buyer-terms.md +177 -0
- package/dist/docs/legal/compliant-user-flow.md +216 -0
- package/dist/docs/legal/master-service-agreement.md +404 -0
- package/dist/docs/legal/payment-flow-diagram.md +188 -0
- package/dist/docs/legal/seller-terms.md +169 -0
- package/dist/docs/manifest.json +415 -0
- package/dist/docs/monetization/offerings.md +156 -0
- package/dist/docs/monetization/pricing-tables.md +226 -0
- package/dist/docs/monetization/targeting-rules.md +278 -0
- package/dist/docs/openapi.json +5479 -0
- package/dist/docs/payouts/overview.md +43 -0
- package/dist/docs/payouts/payout-account.md +12 -0
- package/dist/docs/payouts/transactions.md +23 -0
- package/dist/docs/product-catalog/digital-downloads.md +117 -0
- package/dist/docs/product-catalog/discounts.md +69 -0
- package/dist/docs/product-catalog/entitlements.md +428 -0
- package/dist/docs/product-catalog/free-and-trials.md +36 -0
- package/dist/docs/product-catalog/license-keys.md +324 -0
- package/dist/docs/product-catalog/links.md +92 -0
- package/dist/docs/product-catalog/location-based-pricing.md +41 -0
- package/dist/docs/product-catalog/one-time-payments.md +24 -0
- package/dist/docs/product-catalog/plans.md +199 -0
- package/dist/docs/product-catalog/products.md +60 -0
- package/dist/docs/product-catalog/subscriptions.md +29 -0
- package/dist/docs/product-catalog/tax-settings.md +37 -0
- package/dist/docs/product-catalog/usage-based-billing.md +119 -0
- package/dist/docs/promotions/create-a-promotion.md +75 -0
- package/dist/docs/promotions/customize-banner.md +41 -0
- package/dist/docs/promotions/integrate.md +38 -0
- package/dist/docs/promotions/overview.md +51 -0
- package/dist/docs/quickstart/core-concepts.md +146 -0
- package/dist/docs/quickstart/dashboard-setup.md +129 -0
- package/dist/docs/quickstart/integrate-with-your-app.md +149 -0
- package/dist/docs/sales/checkout-sessions.md +58 -0
- package/dist/docs/sales/orders.md +76 -0
- package/dist/http/client.d.ts +28 -0
- package/dist/http/client.js +76 -0
- package/dist/http/client.js.map +1 -0
- package/dist/http/errors.d.ts +20 -0
- package/dist/http/errors.js +58 -0
- package/dist/http/errors.js.map +1 -0
- package/dist/resources/docs-index.d.ts +25 -0
- package/dist/resources/docs-index.js +109 -0
- package/dist/resources/docs-index.js.map +1 -0
- package/dist/resources/index.d.ts +2 -0
- package/dist/resources/index.js +73 -0
- package/dist/resources/index.js.map +1 -0
- package/dist/schemas/kelviq.d.ts +1304 -0
- package/dist/schemas/kelviq.js +468 -0
- package/dist/schemas/kelviq.js.map +1 -0
- package/dist/server.d.ts +2 -0
- package/dist/server.js +41 -0
- package/dist/server.js.map +1 -0
- package/dist/tools/_util.d.ts +15 -0
- package/dist/tools/_util.js +15 -0
- package/dist/tools/_util.js.map +1 -0
- package/dist/tools/checkout.d.ts +3 -0
- package/dist/tools/checkout.js +18 -0
- package/dist/tools/checkout.js.map +1 -0
- package/dist/tools/customers.d.ts +3 -0
- package/dist/tools/customers.js +32 -0
- package/dist/tools/customers.js.map +1 -0
- package/dist/tools/docs.d.ts +2 -0
- package/dist/tools/docs.js +43 -0
- package/dist/tools/docs.js.map +1 -0
- package/dist/tools/entitlements.d.ts +3 -0
- package/dist/tools/entitlements.js +22 -0
- package/dist/tools/entitlements.js.map +1 -0
- package/dist/tools/features.d.ts +3 -0
- package/dist/tools/features.js +55 -0
- package/dist/tools/features.js.map +1 -0
- package/dist/tools/index.d.ts +3 -0
- package/dist/tools/index.js +44 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/licenses.d.ts +3 -0
- package/dist/tools/licenses.js +44 -0
- package/dist/tools/licenses.js.map +1 -0
- package/dist/tools/media.d.ts +3 -0
- package/dist/tools/media.js +18 -0
- package/dist/tools/media.js.map +1 -0
- package/dist/tools/offerings.d.ts +3 -0
- package/dist/tools/offerings.js +21 -0
- package/dist/tools/offerings.js.map +1 -0
- package/dist/tools/partner.d.ts +3 -0
- package/dist/tools/partner.js +55 -0
- package/dist/tools/partner.js.map +1 -0
- package/dist/tools/plan-entitlements.d.ts +3 -0
- package/dist/tools/plan-entitlements.js +56 -0
- package/dist/tools/plan-entitlements.js.map +1 -0
- package/dist/tools/plan-files.d.ts +3 -0
- package/dist/tools/plan-files.js +43 -0
- package/dist/tools/plan-files.js.map +1 -0
- package/dist/tools/plans.d.ts +3 -0
- package/dist/tools/plans.js +120 -0
- package/dist/tools/plans.js.map +1 -0
- package/dist/tools/portal.d.ts +3 -0
- package/dist/tools/portal.js +18 -0
- package/dist/tools/portal.js.map +1 -0
- package/dist/tools/product-files.d.ts +3 -0
- package/dist/tools/product-files.js +31 -0
- package/dist/tools/product-files.js.map +1 -0
- package/dist/tools/product-settings.d.ts +3 -0
- package/dist/tools/product-settings.js +31 -0
- package/dist/tools/product-settings.js.map +1 -0
- package/dist/tools/products.d.ts +3 -0
- package/dist/tools/products.js +69 -0
- package/dist/tools/products.js.map +1 -0
- package/dist/tools/promotions.d.ts +3 -0
- package/dist/tools/promotions.js +19 -0
- package/dist/tools/promotions.js.map +1 -0
- package/dist/tools/subscriptions.d.ts +3 -0
- package/dist/tools/subscriptions.js +63 -0
- package/dist/tools/subscriptions.js.map +1 -0
- package/dist/tools/usage.d.ts +3 -0
- package/dist/tools/usage.js +18 -0
- package/dist/tools/usage.js.map +1 -0
- 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,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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"}
|