@layervai/qurl-mcp 0.4.1 → 0.5.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 (169) hide show
  1. package/README.md +742 -50
  2. package/assets/fonts/NotoSansSC-Regular.ttf +0 -0
  3. package/assets/fonts/OFL.txt +93 -0
  4. package/assets/fonts/README.md +18 -0
  5. package/dist/auth/request-context.d.ts +13 -0
  6. package/dist/auth/request-context.d.ts.map +1 -0
  7. package/dist/auth/request-context.js +21 -0
  8. package/dist/auth/request-context.js.map +1 -0
  9. package/dist/auth/static-bearer.d.ts +12 -0
  10. package/dist/auth/static-bearer.d.ts.map +1 -0
  11. package/dist/auth/static-bearer.js +47 -0
  12. package/dist/auth/static-bearer.js.map +1 -0
  13. package/dist/client.d.ts +1 -1
  14. package/dist/client.d.ts.map +1 -1
  15. package/dist/client.js +15 -4
  16. package/dist/client.js.map +1 -1
  17. package/dist/config.d.ts +98 -0
  18. package/dist/config.d.ts.map +1 -0
  19. package/dist/config.js +543 -0
  20. package/dist/config.js.map +1 -0
  21. package/dist/credential-rate-limit-store.d.ts +38 -0
  22. package/dist/credential-rate-limit-store.d.ts.map +1 -0
  23. package/dist/credential-rate-limit-store.js +135 -0
  24. package/dist/credential-rate-limit-store.js.map +1 -0
  25. package/dist/email-addresses.d.ts +7 -0
  26. package/dist/email-addresses.d.ts.map +1 -0
  27. package/dist/email-addresses.js +36 -0
  28. package/dist/email-addresses.js.map +1 -0
  29. package/dist/email-types.d.ts +33 -0
  30. package/dist/email-types.d.ts.map +1 -0
  31. package/dist/email-types.js +28 -0
  32. package/dist/email-types.js.map +1 -0
  33. package/dist/emf-metrics.d.ts +25 -0
  34. package/dist/emf-metrics.d.ts.map +1 -0
  35. package/dist/emf-metrics.js +87 -0
  36. package/dist/emf-metrics.js.map +1 -0
  37. package/dist/http-config.d.ts +38 -0
  38. package/dist/http-config.d.ts.map +1 -0
  39. package/dist/http-config.js +243 -0
  40. package/dist/http-config.js.map +1 -0
  41. package/dist/http-routes.d.ts +5 -0
  42. package/dist/http-routes.d.ts.map +1 -0
  43. package/dist/http-routes.js +12 -0
  44. package/dist/http-routes.js.map +1 -0
  45. package/dist/http.d.ts +33 -0
  46. package/dist/http.d.ts.map +1 -0
  47. package/dist/http.js +1116 -0
  48. package/dist/http.js.map +1 -0
  49. package/dist/index.d.ts +1 -1
  50. package/dist/index.d.ts.map +1 -1
  51. package/dist/index.js +42 -26
  52. package/dist/index.js.map +1 -1
  53. package/dist/logging.d.ts +7 -0
  54. package/dist/logging.d.ts.map +1 -0
  55. package/dist/logging.js +110 -0
  56. package/dist/logging.js.map +1 -0
  57. package/dist/server.d.ts +12 -4
  58. package/dist/server.d.ts.map +1 -1
  59. package/dist/server.js +33 -8
  60. package/dist/server.js.map +1 -1
  61. package/dist/services/email.d.ts +17 -0
  62. package/dist/services/email.d.ts.map +1 -0
  63. package/dist/services/email.js +351 -0
  64. package/dist/services/email.js.map +1 -0
  65. package/dist/services/html.d.ts +5 -0
  66. package/dist/services/html.d.ts.map +1 -0
  67. package/dist/services/html.js +28 -0
  68. package/dist/services/html.js.map +1 -0
  69. package/dist/services/legal-pages.d.ts +12 -0
  70. package/dist/services/legal-pages.d.ts.map +1 -0
  71. package/dist/services/legal-pages.js +588 -0
  72. package/dist/services/legal-pages.js.map +1 -0
  73. package/dist/services/text-pdf.d.ts +16 -0
  74. package/dist/services/text-pdf.d.ts.map +1 -0
  75. package/dist/services/text-pdf.js +141 -0
  76. package/dist/services/text-pdf.js.map +1 -0
  77. package/dist/services/video-page.d.ts +4 -0
  78. package/dist/services/video-page.d.ts.map +1 -0
  79. package/dist/services/video-page.js +311 -0
  80. package/dist/services/video-page.js.map +1 -0
  81. package/dist/text.d.ts +4 -0
  82. package/dist/text.d.ts.map +1 -0
  83. package/dist/text.js +16 -0
  84. package/dist/text.js.map +1 -0
  85. package/dist/tools/_shared.d.ts +9 -1
  86. package/dist/tools/_shared.d.ts.map +1 -1
  87. package/dist/tools/_shared.js +20 -8
  88. package/dist/tools/_shared.js.map +1 -1
  89. package/dist/tools/batch-create.d.ts +12 -11
  90. package/dist/tools/batch-create.d.ts.map +1 -1
  91. package/dist/tools/batch-create.js +6 -4
  92. package/dist/tools/batch-create.js.map +1 -1
  93. package/dist/tools/create-qurl.d.ts +43 -4
  94. package/dist/tools/create-qurl.d.ts.map +1 -1
  95. package/dist/tools/create-qurl.js +63 -30
  96. package/dist/tools/create-qurl.js.map +1 -1
  97. package/dist/tools/delete-qurl.d.ts +3 -2
  98. package/dist/tools/delete-qurl.d.ts.map +1 -1
  99. package/dist/tools/delete-qurl.js +3 -10
  100. package/dist/tools/delete-qurl.js.map +1 -1
  101. package/dist/tools/email-delivery.d.ts +37 -0
  102. package/dist/tools/email-delivery.d.ts.map +1 -0
  103. package/dist/tools/email-delivery.js +115 -0
  104. package/dist/tools/email-delivery.js.map +1 -0
  105. package/dist/tools/extend-qurl.d.ts +6 -5
  106. package/dist/tools/extend-qurl.d.ts.map +1 -1
  107. package/dist/tools/extend-qurl.js +3 -3
  108. package/dist/tools/extend-qurl.js.map +1 -1
  109. package/dist/tools/get-qurl.d.ts +6 -5
  110. package/dist/tools/get-qurl.d.ts.map +1 -1
  111. package/dist/tools/get-qurl.js +5 -3
  112. package/dist/tools/get-qurl.js.map +1 -1
  113. package/dist/tools/list-qurl-sessions.d.ts +5 -4
  114. package/dist/tools/list-qurl-sessions.d.ts.map +1 -1
  115. package/dist/tools/list-qurl-sessions.js +2 -2
  116. package/dist/tools/list-qurl-sessions.js.map +1 -1
  117. package/dist/tools/list-qurls.d.ts +8 -7
  118. package/dist/tools/list-qurls.d.ts.map +1 -1
  119. package/dist/tools/list-qurls.js +9 -7
  120. package/dist/tools/list-qurls.js.map +1 -1
  121. package/dist/tools/mint-link.d.ts +39 -3
  122. package/dist/tools/mint-link.d.ts.map +1 -1
  123. package/dist/tools/mint-link.js +24 -13
  124. package/dist/tools/mint-link.js.map +1 -1
  125. package/dist/tools/output-schemas.d.ts +102 -45
  126. package/dist/tools/output-schemas.d.ts.map +1 -1
  127. package/dist/tools/output-schemas.js +54 -29
  128. package/dist/tools/output-schemas.js.map +1 -1
  129. package/dist/tools/resolve-qurl.d.ts +4 -3
  130. package/dist/tools/resolve-qurl.d.ts.map +1 -1
  131. package/dist/tools/resolve-qurl.js +3 -3
  132. package/dist/tools/resolve-qurl.js.map +1 -1
  133. package/dist/tools/revoke-qurl-token.d.ts +3 -2
  134. package/dist/tools/revoke-qurl-token.d.ts.map +1 -1
  135. package/dist/tools/revoke-qurl-token.js +2 -2
  136. package/dist/tools/revoke-qurl-token.js.map +1 -1
  137. package/dist/tools/terminate-qurl-sessions.d.ts +3 -2
  138. package/dist/tools/terminate-qurl-sessions.d.ts.map +1 -1
  139. package/dist/tools/terminate-qurl-sessions.js +7 -3
  140. package/dist/tools/terminate-qurl-sessions.js.map +1 -1
  141. package/dist/tools/update-qurl-token.d.ts +5 -4
  142. package/dist/tools/update-qurl-token.d.ts.map +1 -1
  143. package/dist/tools/update-qurl-token.js +2 -2
  144. package/dist/tools/update-qurl-token.js.map +1 -1
  145. package/dist/tools/update-qurl.d.ts +6 -5
  146. package/dist/tools/update-qurl.d.ts.map +1 -1
  147. package/dist/tools/update-qurl.js +4 -4
  148. package/dist/tools/update-qurl.js.map +1 -1
  149. package/dist/tools/upload-file-data-qurl.d.ts +182 -0
  150. package/dist/tools/upload-file-data-qurl.d.ts.map +1 -0
  151. package/dist/tools/upload-file-data-qurl.js +200 -0
  152. package/dist/tools/upload-file-data-qurl.js.map +1 -0
  153. package/dist/tools/upload-file-qurl.d.ts +162 -0
  154. package/dist/tools/upload-file-qurl.d.ts.map +1 -0
  155. package/dist/tools/upload-file-qurl.js +167 -0
  156. package/dist/tools/upload-file-qurl.js.map +1 -0
  157. package/dist/tools/upload-file-shared.d.ts +36 -0
  158. package/dist/tools/upload-file-shared.d.ts.map +1 -0
  159. package/dist/tools/upload-file-shared.js +347 -0
  160. package/dist/tools/upload-file-shared.js.map +1 -0
  161. package/dist/tools/upload-mint-options.d.ts +22 -0
  162. package/dist/tools/upload-mint-options.d.ts.map +1 -0
  163. package/dist/tools/upload-mint-options.js +29 -0
  164. package/dist/tools/upload-mint-options.js.map +1 -0
  165. package/dist/tools/upload-text-qurl.d.ts +144 -0
  166. package/dist/tools/upload-text-qurl.d.ts.map +1 -0
  167. package/dist/tools/upload-text-qurl.js +102 -0
  168. package/dist/tools/upload-text-qurl.js.map +1 -0
  169. package/package.json +25 -7
@@ -0,0 +1,347 @@
1
+ import { Buffer } from "node:buffer";
2
+ import { basename, extname } from "node:path";
3
+ import { getRequestMaxUploadFileDataBytes, getRequestQurlApiKey, getRequestQurlConnectorUrl, } from "../auth/request-context.js";
4
+ import { MISSING_API_KEY_MESSAGE, QURLAPIError, } from "../client.js";
5
+ import { loadRuntimeConfig, normalizeServiceBaseUrl } from "../config.js";
6
+ import { formatErrorForLog } from "../logging.js";
7
+ import { flattenControlCharacters, isControlCodePoint } from "../text.js";
8
+ import { RESOURCE_ID_PATTERN } from "./_shared.js";
9
+ export const supportedMimeTypes = [
10
+ "application/pdf",
11
+ "image/gif",
12
+ "image/jpeg",
13
+ "image/png",
14
+ "image/webp",
15
+ ];
16
+ const PNG_SIGNATURE = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
17
+ const PNG_IEND_CHUNK = Buffer.from([0, 0, 0, 0, 73, 69, 78, 68, 174, 66, 96, 130]);
18
+ const PDF_EOF_MARKER = Buffer.from("%%EOF", "ascii");
19
+ export const mimeTypeByExtension = new Map([
20
+ [".gif", "image/gif"],
21
+ [".jpeg", "image/jpeg"],
22
+ [".jpg", "image/jpeg"],
23
+ [".pdf", "application/pdf"],
24
+ [".png", "image/png"],
25
+ [".webp", "image/webp"],
26
+ ]);
27
+ export function getConnectorConfig(allowServerApiKeyFallback = false) {
28
+ let runtimeConfig;
29
+ const getRuntimeConfig = () => (runtimeConfig ??= loadRuntimeConfig());
30
+ const serverApiKey = allowServerApiKeyFallback
31
+ ? (process.env.QURL_API_KEY?.trim() ?? getRuntimeConfig().qurlApiKey)
32
+ : undefined;
33
+ const apiKey = getRequestQurlApiKey() ?? serverApiKey ?? "";
34
+ if (!apiKey) {
35
+ throw new QURLAPIError(0, "missing_api_key", MISSING_API_KEY_MESSAGE);
36
+ }
37
+ const connectorURL = getRequestQurlConnectorUrl() ??
38
+ process.env.QURL_CONNECTOR_URL?.trim() ??
39
+ getRuntimeConfig().defaultQurlConnectorUrl ??
40
+ "";
41
+ if (!connectorURL) {
42
+ throw new QURLAPIError(0, "missing_connector_url", "QURL_CONNECTOR_URL is not set. Set it in the MCP server environment or runtime config to enable file uploads.");
43
+ }
44
+ // Validate operator configuration during preflight, before callers decode
45
+ // or read a potentially large upload payload.
46
+ const uploadUrl = getConnectorUploadUrl(connectorURL);
47
+ return { apiKey, uploadUrl };
48
+ }
49
+ export function getConnectorUploadUrl(connectorURL) {
50
+ let connectorBaseUrl;
51
+ try {
52
+ connectorBaseUrl = new URL(normalizeServiceBaseUrl(connectorURL, "QURL_CONNECTOR_URL", true));
53
+ }
54
+ catch (error) {
55
+ throw new QURLAPIError(0, "invalid_connector_url", error instanceof Error ? error.message : "QURL_CONNECTOR_URL must be a valid absolute URL.");
56
+ }
57
+ const basePath = connectorBaseUrl.pathname.replace(/\/$/, "");
58
+ const containsAmbiguousUploadRoute = /(?:^|\/)(?:api\/)?upload(?:\/|$)/.test(basePath) && !basePath.endsWith("/api/upload");
59
+ if (containsAmbiguousUploadRoute) {
60
+ throw new QURLAPIError(0, "invalid_connector_url", "QURL_CONNECTOR_URL must be a connector service base URL or end exactly with /api/upload.");
61
+ }
62
+ connectorBaseUrl.pathname = basePath.endsWith("/api/upload")
63
+ ? basePath
64
+ : `${basePath}/api/upload`;
65
+ return connectorBaseUrl.toString();
66
+ }
67
+ export function normalizeFileName(input) {
68
+ const name = basename(input.replaceAll("\\", "/")).trim();
69
+ if (!name || name === "." || name === "..") {
70
+ throw new Error("file_name must not be empty");
71
+ }
72
+ const hasControlCharacter = [...name].some((character) => {
73
+ const codePoint = character.codePointAt(0) ?? 0;
74
+ return isControlCodePoint(codePoint);
75
+ });
76
+ if (Buffer.byteLength(name, "utf8") > 255 || hasControlCharacter) {
77
+ throw new Error("file_name must be at most 255 UTF-8 bytes and contain no control characters");
78
+ }
79
+ return name;
80
+ }
81
+ export function inferContentType(filePath) {
82
+ return mimeTypeByExtension.get(extname(filePath).toLowerCase());
83
+ }
84
+ export function getMaxUploadFileBytes() {
85
+ const requestScoped = getRequestMaxUploadFileDataBytes();
86
+ if (requestScoped !== undefined)
87
+ return requestScoped;
88
+ return loadRuntimeConfig().maxUploadFileDataBytes;
89
+ }
90
+ export function validateFileNameContentType(fileName, contentType) {
91
+ const inferred = inferContentType(fileName);
92
+ if (!inferred) {
93
+ throw new Error("file_name must include a basename and supported PDF or raster image extension (for example, image.png); content_type does not replace the required filename extension.");
94
+ }
95
+ if (inferred !== contentType) {
96
+ throw new Error(`content_type ${contentType} does not match the filename extension.`);
97
+ }
98
+ }
99
+ export function validateFileSignature(fileData, contentType) {
100
+ const bytes = fileData.buffer instanceof ArrayBuffer
101
+ ? Buffer.from(fileData.buffer, fileData.byteOffset, fileData.byteLength)
102
+ : Buffer.from(fileData);
103
+ // latin1 preserves byte values exactly; Node's ascii decoder masks the high
104
+ // bit and would let non-ASCII bytes impersonate an ASCII magic header.
105
+ // These are bounded type-confusion guards rather than full decoders. Start
106
+ // and end framing rejects bytes appended after a terminal marker, but JPEG
107
+ // and GIF internals and PNG chunk integrity are not parsed; downstream
108
+ // connector validation and nosniff delivery remain the authoritative content
109
+ // boundary.
110
+ const ascii = (start, end) => bytes.subarray(start, end).toString("latin1");
111
+ const hasPdfTrailer = () => {
112
+ const pdfEofIndex = bytes.lastIndexOf(PDF_EOF_MARKER);
113
+ return (pdfEofIndex >= 0 &&
114
+ bytes
115
+ .subarray(pdfEofIndex + PDF_EOF_MARKER.length)
116
+ .every((byte) => byte === 9 || byte === 10 || byte === 12 || byte === 13 || byte === 32));
117
+ };
118
+ const valid = (contentType === "application/pdf" && ascii(0, 5) === "%PDF-" && hasPdfTrailer()) ||
119
+ (contentType === "image/png" &&
120
+ bytes.length >= PNG_SIGNATURE.length + PNG_IEND_CHUNK.length &&
121
+ bytes.subarray(0, PNG_SIGNATURE.length).equals(PNG_SIGNATURE) &&
122
+ bytes.subarray(-PNG_IEND_CHUNK.length).equals(PNG_IEND_CHUNK)) ||
123
+ (contentType === "image/jpeg" &&
124
+ bytes.length >= 6 &&
125
+ bytes[0] === 0xff &&
126
+ bytes[1] === 0xd8 &&
127
+ bytes[2] === 0xff &&
128
+ bytes[bytes.length - 2] === 0xff &&
129
+ bytes[bytes.length - 1] === 0xd9) ||
130
+ (contentType === "image/gif" &&
131
+ ["GIF87a", "GIF89a"].includes(ascii(0, 6)) &&
132
+ bytes[bytes.length - 1] === 0x3b) ||
133
+ (contentType === "image/webp" &&
134
+ bytes.length >= 16 &&
135
+ ascii(0, 4) === "RIFF" &&
136
+ // WebP requires RIFF size + 8 to equal the complete file size. Reject
137
+ // trailing bytes deliberately so a valid prefix cannot bless a polyglot.
138
+ bytes.readUInt32LE(4) + 8 === bytes.length &&
139
+ ascii(8, 12) === "WEBP" &&
140
+ ["VP8 ", "VP8L", "VP8X"].includes(ascii(12, 16)));
141
+ if (!valid) {
142
+ throw new Error(`File content does not match declared content_type ${contentType}.`);
143
+ }
144
+ }
145
+ /**
146
+ * Parse JSON response body safely, returning undefined on parse failure.
147
+ */
148
+ function parseJsonBody(raw) {
149
+ try {
150
+ return raw ? JSON.parse(raw) : undefined;
151
+ }
152
+ catch {
153
+ return undefined;
154
+ }
155
+ }
156
+ function extractConnectorError(parsed) {
157
+ const body = typeof parsed === "object" && parsed !== null ? parsed : {};
158
+ const nestedError = typeof body.error === "object" && body.error !== null
159
+ ? body.error
160
+ : {};
161
+ const stringField = (record, field) => {
162
+ const value = record[field];
163
+ return typeof value === "string" ? value : undefined;
164
+ };
165
+ return {
166
+ code: stringField(nestedError, "code") ?? stringField(body, "code") ?? "connector_upload_failed",
167
+ detail: stringField(nestedError, "detail") ??
168
+ stringField(nestedError, "message") ??
169
+ stringField(body, "detail") ??
170
+ stringField(body, "message"),
171
+ type: stringField(nestedError, "type"),
172
+ instance: stringField(nestedError, "instance"),
173
+ };
174
+ }
175
+ /**
176
+ * Throw a QURLAPIError from a failed connector response.
177
+ */
178
+ function throwConnectorError(response, parsed, requestId) {
179
+ const { code, detail, type, instance } = extractConnectorError(parsed);
180
+ const safeDetail = detail
181
+ ? flattenControlCharacters(detail).replace(/\s+/g, " ").trim().slice(0, 1024)
182
+ : undefined;
183
+ throw new QURLAPIError(response.status, code, safeDetail || `Connector upload failed with HTTP ${response.status}`, type, instance, requestId);
184
+ }
185
+ /**
186
+ * Extract the raw resource_id field from a connector success response.
187
+ * Handles both `{ resource_id }` and `{ data: { resource_id } }` shapes.
188
+ */
189
+ function extractResourceId(parsed) {
190
+ if (typeof parsed !== "object" || parsed === null) {
191
+ return undefined;
192
+ }
193
+ // Direct shape: { resource_id: string }
194
+ if ("resource_id" in parsed) {
195
+ return parsed.resource_id;
196
+ }
197
+ // Wrapped shape: { data: { resource_id: string } }
198
+ if ("data" in parsed &&
199
+ typeof parsed.data === "object" &&
200
+ parsed.data !== null &&
201
+ "resource_id" in parsed.data) {
202
+ return parsed.data.resource_id;
203
+ }
204
+ return undefined;
205
+ }
206
+ async function readConnectorResponseBody(response) {
207
+ if (!response.body)
208
+ return "";
209
+ const reader = response.body.getReader();
210
+ const chunks = [];
211
+ let totalBytes = 0;
212
+ while (true) {
213
+ const { done, value } = await reader.read();
214
+ if (done)
215
+ break;
216
+ totalBytes += value.byteLength;
217
+ if (totalBytes > 64 * 1024) {
218
+ await reader.cancel();
219
+ throw new QURLAPIError(0, "connector_response_too_large", "Connector response exceeded the 64 KiB limit.");
220
+ }
221
+ chunks.push(Buffer.from(value));
222
+ }
223
+ return Buffer.concat(chunks).toString("utf8");
224
+ }
225
+ /**
226
+ * Process connector response and extract resource_id.
227
+ * Throws QURLAPIError on failure or missing resource_id.
228
+ */
229
+ async function processConnectorResponse(response) {
230
+ const requestId = response.headers.get("x-request-id") ?? undefined;
231
+ const raw = await readConnectorResponseBody(response);
232
+ const contentType = response.headers.get("content-type")?.toLowerCase();
233
+ if (response.ok && contentType && !contentType.includes("json")) {
234
+ throw new QURLAPIError(0, "unexpected_response", "Connector upload succeeded with a non-JSON response.", undefined, undefined, requestId);
235
+ }
236
+ const parsed = parseJsonBody(raw);
237
+ if (!response.ok) {
238
+ throwConnectorError(response, parsed, requestId);
239
+ }
240
+ const resourceId = extractResourceId(parsed);
241
+ if (resourceId === undefined) {
242
+ throw new QURLAPIError(0, "unexpected_response", "Connector upload succeeded but did not return a resource_id.", undefined, undefined, requestId);
243
+ }
244
+ if (typeof resourceId !== "string" || !RESOURCE_ID_PATTERN.test(resourceId)) {
245
+ throw new QURLAPIError(0, "invalid_resource_id", "Connector upload returned a resource_id with an invalid format.", undefined, undefined, requestId);
246
+ }
247
+ return { resource_id: resourceId };
248
+ }
249
+ export async function mintUploadedFile(client, resourceId, file, input) {
250
+ let minted;
251
+ try {
252
+ minted = await client.mintLink(resourceId, {
253
+ label: input.label,
254
+ expires_in: input.expires_in,
255
+ one_time_use: input.one_time_use ?? true,
256
+ max_sessions: input.max_sessions,
257
+ session_duration: input.session_duration,
258
+ access_policy: input.access_policy,
259
+ });
260
+ }
261
+ catch (error) {
262
+ // The connector API currently exposes upload but no delete endpoint. Keep
263
+ // the mint error primary and log the orphan resource for operator cleanup.
264
+ console.error(`Connector resource ${resourceId} remains after link minting failed (${formatErrorForLog(error)})`);
265
+ throw new QURLAPIError(error instanceof QURLAPIError ? error.statusCode : 0, "upload_mint_failed", `Upload succeeded but link creation failed. Resource ID: ${resourceId}. ` +
266
+ "Use mint_link with this resource_id to retry; do not upload the file again. " +
267
+ "A failed request may already have minted a token; inspect get_qurl before retrying.");
268
+ }
269
+ let qurlSite;
270
+ try {
271
+ qurlSite = (await client.getQURL(resourceId)).data.qurl_site;
272
+ }
273
+ catch (error) {
274
+ // Non-fatal: qurl_site is optional metadata. Log for debugging but don't fail the upload.
275
+ console.error(`Failed to fetch qurl_site for resource ${resourceId} (${formatErrorForLog(error)})`);
276
+ }
277
+ return {
278
+ resource_id: resourceId,
279
+ qurl_id: minted.data.qurl_id,
280
+ qurl_link: minted.data.qurl_link,
281
+ qurl_site: qurlSite,
282
+ expires_at: minted.data.expires_at,
283
+ file_name: file.name,
284
+ content_type: file.contentType,
285
+ size_bytes: file.sizeBytes,
286
+ branded_domain: minted.data.branded_domain,
287
+ type: minted.data.type,
288
+ };
289
+ }
290
+ function connectorTransportError(error) {
291
+ const code = error instanceof Error && ["AbortError", "TimeoutError"].includes(error.name)
292
+ ? "connector_timeout"
293
+ : "connector_unreachable";
294
+ return new QURLAPIError(0, code, code === "connector_timeout"
295
+ ? "Connector upload timed out."
296
+ : "Connector upload request failed.");
297
+ }
298
+ async function fetchConnector(uploadUrl, init) {
299
+ try {
300
+ return await fetch(uploadUrl, {
301
+ ...init,
302
+ redirect: "error",
303
+ signal: globalThis.AbortSignal.timeout(60_000),
304
+ });
305
+ }
306
+ catch (error) {
307
+ throw connectorTransportError(error);
308
+ }
309
+ }
310
+ export async function uploadToConnector(fileData, fileName, contentType, connectorConfig) {
311
+ // Security boundary: uploadUrl comes only from operator configuration.
312
+ // Never accept a per-request connector destination here; doing so would
313
+ // turn the caller's forwarded qURL credential into an SSRF disclosure.
314
+ const { apiKey, uploadUrl } = connectorConfig;
315
+ const form = new globalThis.FormData();
316
+ // BlobPart's DOM type excludes SharedArrayBuffer-backed views. Reuse the
317
+ // normal ArrayBuffer view without copying; only copy the theoretical shared
318
+ // buffer case into an ordinary Uint8Array.
319
+ const blobData = fileData.buffer instanceof ArrayBuffer
320
+ ? new Uint8Array(fileData.buffer, fileData.byteOffset, fileData.byteLength)
321
+ : new Uint8Array(fileData);
322
+ form.append("file",
323
+ // lgtm[js/file-access-to-http] This tool explicitly uploads caller-provided bytes to the operator-configured connector.
324
+ new globalThis.Blob([blobData], { type: contentType }), fileName);
325
+ // The standards-based FormData serializer owns Content-Disposition filename
326
+ // quoting/escaping; never interpolate this value into a raw header.
327
+ // lgtm[js/file-access-to-http] The validated destination and upload are the explicit behavior of this MCP tool.
328
+ const response = await fetchConnector(uploadUrl, {
329
+ method: "POST",
330
+ headers: {
331
+ Authorization: `Bearer ${apiKey}`,
332
+ Accept: "application/json",
333
+ },
334
+ body: form, // lgtm[js/file-access-to-http]
335
+ });
336
+ // fetchConnector's signal remains attached while this reads the response
337
+ // body, so a connector that stalls after sending headers is still bounded.
338
+ try {
339
+ return await processConnectorResponse(response);
340
+ }
341
+ catch (error) {
342
+ if (error instanceof QURLAPIError)
343
+ throw error;
344
+ throw connectorTransportError(error);
345
+ }
346
+ }
347
+ //# sourceMappingURL=upload-file-shared.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload-file-shared.js","sourceRoot":"","sources":["../../src/tools/upload-file-shared.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import { z } from "zod";
2
+ export declare const uploadMintOptionsShape: {
3
+ label: z.ZodOptional<z.ZodString>;
4
+ expires_in: z.ZodOptional<z.ZodString>;
5
+ one_time_use: z.ZodOptional<z.ZodBoolean>;
6
+ max_sessions: z.ZodOptional<z.ZodNumber>;
7
+ session_duration: z.ZodOptional<z.ZodString>;
8
+ access_policy: z.ZodOptional<z.ZodObject<{
9
+ ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
10
+ ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
11
+ geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
12
+ geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
13
+ user_agent_allow_regex: z.ZodOptional<z.ZodString>;
14
+ user_agent_deny_regex: z.ZodOptional<z.ZodString>;
15
+ ai_agent_policy: z.ZodOptional<z.ZodObject<{
16
+ block_all: z.ZodOptional<z.ZodBoolean>;
17
+ deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
18
+ allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
19
+ }, z.core.$strip>>;
20
+ }, z.core.$strip>>;
21
+ };
22
+ //# sourceMappingURL=upload-mint-options.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload-mint-options.d.ts","sourceRoot":"","sources":["../../src/tools/upload-mint-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;CA2BlC,CAAC"}
@@ -0,0 +1,29 @@
1
+ import { z } from "zod";
2
+ import { accessPolicySchema } from "./create-qurl.js";
3
+ export const uploadMintOptionsShape = {
4
+ label: z
5
+ .string()
6
+ .min(1)
7
+ .max(500)
8
+ .optional()
9
+ .describe("Human-readable label identifying who this qURL is for (max 500 chars)"),
10
+ expires_in: z.string().min(1).optional().describe('Duration string (e.g., "1h", "24h", "7d")'),
11
+ one_time_use: z
12
+ .boolean()
13
+ .optional()
14
+ .describe("Whether the link can only be used once. Defaults to true for uploaded content."),
15
+ max_sessions: z
16
+ .number()
17
+ .int()
18
+ .min(0)
19
+ .max(1000)
20
+ .optional()
21
+ .describe("Maximum concurrent sessions for this qURL token (max 1000). Set one_time_use to false explicitly for 0 to mean unlimited visitors."),
22
+ session_duration: z
23
+ .string()
24
+ .min(1)
25
+ .optional()
26
+ .describe('How long access lasts after clicking (e.g., "1h")'),
27
+ access_policy: accessPolicySchema.optional().describe("Access control policy for this link"),
28
+ };
29
+ //# sourceMappingURL=upload-mint-options.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload-mint-options.js","sourceRoot":"","sources":["../../src/tools/upload-mint-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uEAAuE,CAAC;IACpF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC9F,YAAY,EAAE,CAAC;SACZ,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,gFAAgF,CAAC;IAC7F,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,oIAAoI,CACrI;IACH,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;IAChE,aAAa,EAAE,kBAAkB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CAC7F,CAAC"}
@@ -0,0 +1,144 @@
1
+ import { z } from "zod";
2
+ import type { IQURLClient } from "../client.js";
3
+ import { type ToolRuntimeOptions } from "./_shared.js";
4
+ export declare const uploadTextQurlSchema: z.ZodObject<{
5
+ type: z.ZodEnum<{
6
+ text: "text";
7
+ html: "html";
8
+ json: "json";
9
+ markdown: "markdown";
10
+ }>;
11
+ content: z.ZodString;
12
+ file_name: z.ZodOptional<z.ZodString>;
13
+ email_delivery: z.ZodOptional<z.ZodObject<{
14
+ to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
15
+ subject: z.ZodOptional<z.ZodString>;
16
+ message: z.ZodOptional<z.ZodString>;
17
+ }, z.core.$strip>>;
18
+ label: z.ZodOptional<z.ZodString>;
19
+ expires_in: z.ZodOptional<z.ZodString>;
20
+ one_time_use: z.ZodOptional<z.ZodBoolean>;
21
+ max_sessions: z.ZodOptional<z.ZodNumber>;
22
+ session_duration: z.ZodOptional<z.ZodString>;
23
+ access_policy: z.ZodOptional<z.ZodObject<{
24
+ ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
25
+ ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
26
+ geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
27
+ geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
28
+ user_agent_allow_regex: z.ZodOptional<z.ZodString>;
29
+ user_agent_deny_regex: z.ZodOptional<z.ZodString>;
30
+ ai_agent_policy: z.ZodOptional<z.ZodObject<{
31
+ block_all: z.ZodOptional<z.ZodBoolean>;
32
+ deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
33
+ allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
34
+ }, z.core.$strip>>;
35
+ }, z.core.$strip>>;
36
+ }, z.core.$strip>;
37
+ export declare function uploadTextQurlTool(client: IQURLClient, runtime: ToolRuntimeOptions): {
38
+ name: string;
39
+ title: string;
40
+ description: string;
41
+ inputSchema: z.ZodObject<{
42
+ type: z.ZodEnum<{
43
+ text: "text";
44
+ html: "html";
45
+ json: "json";
46
+ markdown: "markdown";
47
+ }>;
48
+ content: z.ZodString;
49
+ file_name: z.ZodOptional<z.ZodString>;
50
+ email_delivery: z.ZodOptional<z.ZodObject<{
51
+ to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
52
+ subject: z.ZodOptional<z.ZodString>;
53
+ message: z.ZodOptional<z.ZodString>;
54
+ }, z.core.$strip>>;
55
+ label: z.ZodOptional<z.ZodString>;
56
+ expires_in: z.ZodOptional<z.ZodString>;
57
+ one_time_use: z.ZodOptional<z.ZodBoolean>;
58
+ max_sessions: z.ZodOptional<z.ZodNumber>;
59
+ session_duration: z.ZodOptional<z.ZodString>;
60
+ access_policy: z.ZodOptional<z.ZodObject<{
61
+ ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
62
+ ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
63
+ geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
64
+ geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
65
+ user_agent_allow_regex: z.ZodOptional<z.ZodString>;
66
+ user_agent_deny_regex: z.ZodOptional<z.ZodString>;
67
+ ai_agent_policy: z.ZodOptional<z.ZodObject<{
68
+ block_all: z.ZodOptional<z.ZodBoolean>;
69
+ deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
70
+ allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
71
+ }, z.core.$strip>>;
72
+ }, z.core.$strip>>;
73
+ }, z.core.$strip>;
74
+ outputSchema: z.ZodObject<{
75
+ resource_id: z.ZodString;
76
+ qurl_id: z.ZodString;
77
+ qurl_link: z.ZodString;
78
+ qurl_site: z.ZodOptional<z.ZodString>;
79
+ expires_at: z.ZodOptional<z.ZodString>;
80
+ file_name: z.ZodString;
81
+ content_type: z.ZodString;
82
+ size_bytes: z.ZodNumber;
83
+ branded_domain: z.ZodOptional<z.ZodString>;
84
+ type: z.ZodOptional<z.ZodString>;
85
+ email_delivery: z.ZodOptional<z.ZodObject<{
86
+ attempted: z.ZodBoolean;
87
+ enabled: z.ZodBoolean;
88
+ recipients: z.ZodArray<z.ZodString>;
89
+ sent: z.ZodNumber;
90
+ failed: z.ZodNumber;
91
+ skipped_reason: z.ZodOptional<z.ZodString>;
92
+ results: z.ZodArray<z.ZodObject<{
93
+ email: z.ZodString;
94
+ success: z.ZodBoolean;
95
+ skipped: z.ZodBoolean;
96
+ error: z.ZodOptional<z.ZodString>;
97
+ message_id: z.ZodOptional<z.ZodString>;
98
+ }, z.core.$strip>>;
99
+ }, z.core.$strip>>;
100
+ }, z.core.$loose>;
101
+ annotations: {
102
+ title: string;
103
+ readOnlyHint: boolean;
104
+ destructiveHint: boolean;
105
+ idempotentHint: boolean;
106
+ openWorldHint: boolean;
107
+ };
108
+ handler: (input: {
109
+ type: "text" | "html" | "json" | "markdown";
110
+ content: string;
111
+ file_name?: string | undefined;
112
+ email_delivery?: {
113
+ to: string[];
114
+ subject?: string | undefined;
115
+ message?: string | undefined;
116
+ } | undefined;
117
+ label?: string | undefined;
118
+ expires_in?: string | undefined;
119
+ one_time_use?: boolean | undefined;
120
+ max_sessions?: number | undefined;
121
+ session_duration?: string | undefined;
122
+ access_policy?: {
123
+ ip_allowlist?: string[] | undefined;
124
+ ip_denylist?: string[] | undefined;
125
+ geo_allowlist?: string[] | undefined;
126
+ geo_denylist?: string[] | undefined;
127
+ user_agent_allow_regex?: string | undefined;
128
+ user_agent_deny_regex?: string | undefined;
129
+ ai_agent_policy?: {
130
+ block_all?: boolean | undefined;
131
+ deny_categories?: string[] | undefined;
132
+ allow_categories?: string[] | undefined;
133
+ } | undefined;
134
+ } | undefined;
135
+ }) => Promise<{
136
+ content: Array<{
137
+ type: "text";
138
+ text: string;
139
+ }>;
140
+ structuredContent?: Record<string, unknown>;
141
+ isError?: boolean;
142
+ }>;
143
+ };
144
+ //# sourceMappingURL=upload-text-qurl.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload-text-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/upload-text-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOhD,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AActB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+BA,CAAC;AAElC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+ElF"}