@layervai/qurl-mcp 0.4.0 → 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 (173) hide show
  1. package/README.md +742 -46
  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 +112 -23
  14. package/dist/client.d.ts.map +1 -1
  15. package/dist/client.js +173 -78
  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 -25
  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/prompts/secure-a-service.d.ts +16 -4
  58. package/dist/prompts/secure-a-service.d.ts.map +1 -1
  59. package/dist/prompts/secure-a-service.js +7 -15
  60. package/dist/prompts/secure-a-service.js.map +1 -1
  61. package/dist/server.d.ts +18 -6
  62. package/dist/server.d.ts.map +1 -1
  63. package/dist/server.js +41 -8
  64. package/dist/server.js.map +1 -1
  65. package/dist/services/email.d.ts +17 -0
  66. package/dist/services/email.d.ts.map +1 -0
  67. package/dist/services/email.js +351 -0
  68. package/dist/services/email.js.map +1 -0
  69. package/dist/services/html.d.ts +5 -0
  70. package/dist/services/html.d.ts.map +1 -0
  71. package/dist/services/html.js +28 -0
  72. package/dist/services/html.js.map +1 -0
  73. package/dist/services/legal-pages.d.ts +12 -0
  74. package/dist/services/legal-pages.d.ts.map +1 -0
  75. package/dist/services/legal-pages.js +588 -0
  76. package/dist/services/legal-pages.js.map +1 -0
  77. package/dist/services/text-pdf.d.ts +16 -0
  78. package/dist/services/text-pdf.d.ts.map +1 -0
  79. package/dist/services/text-pdf.js +141 -0
  80. package/dist/services/text-pdf.js.map +1 -0
  81. package/dist/services/video-page.d.ts +4 -0
  82. package/dist/services/video-page.d.ts.map +1 -0
  83. package/dist/services/video-page.js +311 -0
  84. package/dist/services/video-page.js.map +1 -0
  85. package/dist/text.d.ts +4 -0
  86. package/dist/text.d.ts.map +1 -0
  87. package/dist/text.js +16 -0
  88. package/dist/text.js.map +1 -0
  89. package/dist/tools/_shared.d.ts +13 -3
  90. package/dist/tools/_shared.d.ts.map +1 -1
  91. package/dist/tools/_shared.js +31 -7
  92. package/dist/tools/_shared.js.map +1 -1
  93. package/dist/tools/batch-create.d.ts +36 -343
  94. package/dist/tools/batch-create.d.ts.map +1 -1
  95. package/dist/tools/batch-create.js +7 -4
  96. package/dist/tools/batch-create.js.map +1 -1
  97. package/dist/tools/create-qurl.d.ts +79 -237
  98. package/dist/tools/create-qurl.d.ts.map +1 -1
  99. package/dist/tools/create-qurl.js +77 -47
  100. package/dist/tools/create-qurl.js.map +1 -1
  101. package/dist/tools/delete-qurl.d.ts +5 -22
  102. package/dist/tools/delete-qurl.d.ts.map +1 -1
  103. package/dist/tools/delete-qurl.js +19 -13
  104. package/dist/tools/delete-qurl.js.map +1 -1
  105. package/dist/tools/email-delivery.d.ts +37 -0
  106. package/dist/tools/email-delivery.d.ts.map +1 -0
  107. package/dist/tools/email-delivery.js +115 -0
  108. package/dist/tools/email-delivery.js.map +1 -0
  109. package/dist/tools/extend-qurl.d.ts +36 -189
  110. package/dist/tools/extend-qurl.d.ts.map +1 -1
  111. package/dist/tools/extend-qurl.js +3 -3
  112. package/dist/tools/extend-qurl.js.map +1 -1
  113. package/dist/tools/get-qurl.d.ts +36 -185
  114. package/dist/tools/get-qurl.d.ts.map +1 -1
  115. package/dist/tools/get-qurl.js +8 -5
  116. package/dist/tools/get-qurl.js.map +1 -1
  117. package/dist/tools/list-qurl-sessions.d.ts +45 -0
  118. package/dist/tools/list-qurl-sessions.d.ts.map +1 -0
  119. package/dist/tools/list-qurl-sessions.js +33 -0
  120. package/dist/tools/list-qurl-sessions.js.map +1 -0
  121. package/dist/tools/list-qurls.d.ts +38 -319
  122. package/dist/tools/list-qurls.d.ts.map +1 -1
  123. package/dist/tools/list-qurls.js +45 -20
  124. package/dist/tools/list-qurls.js.map +1 -1
  125. package/dist/tools/mint-link.d.ts +72 -303
  126. package/dist/tools/mint-link.d.ts.map +1 -1
  127. package/dist/tools/mint-link.js +35 -21
  128. package/dist/tools/mint-link.js.map +1 -1
  129. package/dist/tools/output-schemas.d.ts +326 -1112
  130. package/dist/tools/output-schemas.d.ts.map +1 -1
  131. package/dist/tools/output-schemas.js +141 -40
  132. package/dist/tools/output-schemas.js.map +1 -1
  133. package/dist/tools/resolve-qurl.d.ts +6 -37
  134. package/dist/tools/resolve-qurl.d.ts.map +1 -1
  135. package/dist/tools/resolve-qurl.js +5 -5
  136. package/dist/tools/resolve-qurl.js.map +1 -1
  137. package/dist/tools/revoke-qurl-token.d.ts +41 -0
  138. package/dist/tools/revoke-qurl-token.d.ts.map +1 -0
  139. package/dist/tools/revoke-qurl-token.js +40 -0
  140. package/dist/tools/revoke-qurl-token.js.map +1 -0
  141. package/dist/tools/terminate-qurl-sessions.d.ts +41 -0
  142. package/dist/tools/terminate-qurl-sessions.d.ts.map +1 -0
  143. package/dist/tools/terminate-qurl-sessions.js +68 -0
  144. package/dist/tools/terminate-qurl-sessions.js.map +1 -0
  145. package/dist/tools/update-qurl-token.d.ts +142 -0
  146. package/dist/tools/update-qurl-token.d.ts.map +1 -0
  147. package/dist/tools/update-qurl-token.js +75 -0
  148. package/dist/tools/update-qurl-token.js.map +1 -0
  149. package/dist/tools/update-qurl.d.ts +43 -264
  150. package/dist/tools/update-qurl.d.ts.map +1 -1
  151. package/dist/tools/update-qurl.js +57 -8
  152. package/dist/tools/update-qurl.js.map +1 -1
  153. package/dist/tools/upload-file-data-qurl.d.ts +182 -0
  154. package/dist/tools/upload-file-data-qurl.d.ts.map +1 -0
  155. package/dist/tools/upload-file-data-qurl.js +200 -0
  156. package/dist/tools/upload-file-data-qurl.js.map +1 -0
  157. package/dist/tools/upload-file-qurl.d.ts +162 -0
  158. package/dist/tools/upload-file-qurl.d.ts.map +1 -0
  159. package/dist/tools/upload-file-qurl.js +167 -0
  160. package/dist/tools/upload-file-qurl.js.map +1 -0
  161. package/dist/tools/upload-file-shared.d.ts +36 -0
  162. package/dist/tools/upload-file-shared.d.ts.map +1 -0
  163. package/dist/tools/upload-file-shared.js +347 -0
  164. package/dist/tools/upload-file-shared.js.map +1 -0
  165. package/dist/tools/upload-mint-options.d.ts +22 -0
  166. package/dist/tools/upload-mint-options.d.ts.map +1 -0
  167. package/dist/tools/upload-mint-options.js +29 -0
  168. package/dist/tools/upload-mint-options.js.map +1 -0
  169. package/dist/tools/upload-text-qurl.d.ts +144 -0
  170. package/dist/tools/upload-text-qurl.d.ts.map +1 -0
  171. package/dist/tools/upload-text-qurl.js +102 -0
  172. package/dist/tools/upload-text-qurl.js.map +1 -0
  173. package/package.json +27 -8
@@ -1,19 +1,11 @@
1
1
  import { z } from "zod";
2
2
  import { QURLAPIError } from "../client.js";
3
- import { withMissingApiKeyHandler } from "./_shared.js";
3
+ import { resourceOnlyIdSchema, withMissingApiKeyHandler, } from "./_shared.js";
4
4
  import { deleteQurlOutputSchema } from "./output-schemas.js";
5
5
  export const deleteQurlSchema = z.object({
6
- // DELETE only accepts r_ (resource) IDs per the API spec — unlike
7
- // get/update/extend/mint_link which also accept q_ prefixes. Reject
8
- // non-r_ IDs at the schema boundary so agents get a clear error
9
- // instead of a confusing API-side rejection.
10
- resource_id: z
11
- .string()
12
- .min(1)
13
- .startsWith("r_", "delete_qurl only accepts resource IDs (r_ prefix). Use update_qurl or mint_link for q_ IDs.")
14
- .describe("The resource ID (must start with r_). delete_qurl does not accept q_ (qURL display) IDs."),
6
+ resource_id: resourceOnlyIdSchema("revoke (all tokens; q_ display IDs are not accepted)"),
15
7
  });
16
- export function deleteQurlTool(client) {
8
+ export function deleteQurlTool(client, _runtime = { mode: "stdio" }) {
17
9
  return {
18
10
  name: "delete_qurl",
19
11
  title: "Delete qURL",
@@ -21,8 +13,10 @@ export function deleteQurlTool(client) {
21
13
  "**This action is irreversible.** Use this when you want to cut off access entirely (compromised link, departed user, end-of-engagement). " +
22
14
  "Use `update_qurl` instead when you only need to shorten/extend the expiration, retag, or rename — those preserve the existing access tokens. " +
23
15
  "Use `extend_qurl` when you only need to push the expiration out. " +
24
- "**Idempotent:** re-deletes return success even if the resource was already revoked or never existed — verify with `get_qurl` first if the ID came from user input, or branch on the `was_already_revoked` flag in the response to distinguish the two cases. " +
25
- "Returns a confirmation payload. By default the resource is excluded from `list_qurls`; pass `status: \"revoked\"` to see it.",
16
+ "**Idempotent:** the API returns 404 for re-deletes, never-existed IDs, and resources owned by another API key (ownership-mismatch is collapsed into 404 server-side to avoid existence disclosure); this tool swallows all three. " +
17
+ "Branch on `was_already_revoked` to distinguish the no-op case from a successful revoke on this call. " +
18
+ "When the ID came from user input and ownership matters, call `get_qurl` first — a 200 confirms ownership; a thrown 404 is equally ambiguous on that endpoint too. " +
19
+ 'Returns a confirmation payload. By default the resource is excluded from `list_qurls`; pass `status: "revoked"` to see it.',
26
20
  inputSchema: deleteQurlSchema,
27
21
  outputSchema: deleteQurlOutputSchema,
28
22
  annotations: {
@@ -45,6 +39,18 @@ export function deleteQurlTool(client) {
45
39
  // `was_already_revoked: true` in the payload so defensive
46
40
  // agents can branch when they care.
47
41
  //
42
+ // Verified against qurl-service: the service-layer
43
+ // `QurlService.RevokeQurl` and `QurlService.GetQurl` both
44
+ // collapse ownership-mismatch into `ErrResourceNotFound` — so
45
+ // 404 covers "you don't own this resource" on both endpoints.
46
+ // The collapse is server-side policy to avoid existence
47
+ // disclosure. The tool description tells callers that
48
+ // `get_qurl` only confirms ownership in the *positive* case
49
+ // (200), since `get_qurl`'s 404 is just as ambiguous as
50
+ // `delete_qurl`'s. (Function names only — line numbers in a
51
+ // separate repo rot on the next refactor; grep
52
+ // `func.*RevokeQurl\b` / `func.*GetQurl\b` in qurl-service.)
53
+ //
48
54
  // Intentionally checks status only, not `code`. A 404 with a
49
55
  // non-JSON body (e.g. an HTML error page from a proxy in front
50
56
  // of the API) lands here as `code: "parse_error"` — the
@@ -1 +1 @@
1
- {"version":3,"file":"delete-qurl.js","sourceRoot":"","sources":["../../src/tools/delete-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,kEAAkE;IAClE,oEAAoE;IACpE,gEAAgE;IAChE,6CAA6C;IAC7C,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,UAAU,CAAC,IAAI,EAAE,6FAA6F,CAAC;SAC/G,QAAQ,CACP,0FAA0F,CAC3F;CACJ,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,iGAAiG;YACjG,2IAA2I;YAC3I,+IAA+I;YAC/I,mEAAmE;YACnE,+PAA+P;YAC/P,8HAA8H;QAChI,WAAW,EAAE,gBAAgB;QAC7B,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE;YACX,KAAK,EAAE,aAAa;YACpB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAuC,EAAE,EAAE;YAClF,IAAI,iBAAiB,GAAG,KAAK,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,+DAA+D;gBAC/D,8DAA8D;gBAC9D,+DAA+D;gBAC/D,kDAAkD;gBAClD,0DAA0D;gBAC1D,oCAAoC;gBACpC,EAAE;gBACF,6DAA6D;gBAC7D,+DAA+D;gBAC/D,wDAAwD;gBACxD,+DAA+D;gBAC/D,2DAA2D;gBAC3D,8BAA8B;gBAC9B,IAAI,CAAC,CAAC,GAAG,YAAY,YAAY,CAAC,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG;oBAAE,MAAM,GAAG,CAAC;gBACxE,iBAAiB,GAAG,IAAI,CAAC;YAC3B,CAAC;YACD,MAAM,OAAO,GAAG;gBACd,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,OAAO,EAAE,IAAa;gBACtB,mBAAmB,EAAE,iBAAiB;gBACtC,OAAO,EAAE,QAAQ,KAAK,CAAC,WAAW,cAAc;aACjD,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,OAAO,CAAC,OAAO;qBACtB;iBACF;gBACD,iBAAiB,EAAE,OAAO;aAC3B,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"delete-qurl.js","sourceRoot":"","sources":["../../src/tools/delete-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GAEzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,WAAW,EAAE,oBAAoB,CAAC,sDAAsD,CAAC;CAC1F,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAC5B,MAAmB,EACnB,WAA+B,EAAE,IAAI,EAAE,OAAO,EAAE;IAEhD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,iGAAiG;YACjG,2IAA2I;YAC3I,+IAA+I;YAC/I,mEAAmE;YACnE,oOAAoO;YACpO,uGAAuG;YACvG,oKAAoK;YACpK,4HAA4H;QAC9H,WAAW,EAAE,gBAAgB;QAC7B,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE;YACX,KAAK,EAAE,aAAa;YACpB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAuC,EAAE,EAAE;YAClF,IAAI,iBAAiB,GAAG,KAAK,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,+DAA+D;gBAC/D,8DAA8D;gBAC9D,+DAA+D;gBAC/D,kDAAkD;gBAClD,0DAA0D;gBAC1D,oCAAoC;gBACpC,EAAE;gBACF,mDAAmD;gBACnD,0DAA0D;gBAC1D,8DAA8D;gBAC9D,8DAA8D;gBAC9D,wDAAwD;gBACxD,sDAAsD;gBACtD,4DAA4D;gBAC5D,wDAAwD;gBACxD,4DAA4D;gBAC5D,+CAA+C;gBAC/C,6DAA6D;gBAC7D,EAAE;gBACF,6DAA6D;gBAC7D,+DAA+D;gBAC/D,wDAAwD;gBACxD,+DAA+D;gBAC/D,2DAA2D;gBAC3D,8BAA8B;gBAC9B,IAAI,CAAC,CAAC,GAAG,YAAY,YAAY,CAAC,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG;oBAAE,MAAM,GAAG,CAAC;gBACxE,iBAAiB,GAAG,IAAI,CAAC;YAC3B,CAAC;YACD,MAAM,OAAO,GAAG;gBACd,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,OAAO,EAAE,IAAa;gBACtB,mBAAmB,EAAE,iBAAiB;gBACtC,OAAO,EAAE,QAAQ,KAAK,CAAC,WAAW,cAAc;aACjD,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,OAAO,CAAC,OAAO;qBACtB;iBACF;gBACD,iBAAiB,EAAE,OAAO;aAC3B,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}
@@ -0,0 +1,37 @@
1
+ import { z } from "zod";
2
+ import type { EmailDeliveryResult } from "../email-types.js";
3
+ export declare const emailDeliveryInputSchema: z.ZodObject<{
4
+ to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
5
+ subject: z.ZodOptional<z.ZodString>;
6
+ message: z.ZodOptional<z.ZodString>;
7
+ }, z.core.$strip>;
8
+ export type EmailDeliveryInput = z.infer<typeof emailDeliveryInputSchema>;
9
+ export interface ToolEmailInput {
10
+ allowServerApiKeyFallback: boolean;
11
+ delivery?: EmailDeliveryInput;
12
+ defaultSubject: string;
13
+ detailLines: string[];
14
+ }
15
+ export interface UploadEmailDetails {
16
+ intro: string;
17
+ fileName: string;
18
+ contentType: string;
19
+ qurlLink: string;
20
+ expiresAt?: string;
21
+ qurlSite?: string;
22
+ label?: string;
23
+ extraLines?: string[];
24
+ }
25
+ export declare function singleLineEmailDetail(value: string): string;
26
+ export declare function uploadEmailDetailLines(details: UploadEmailDetails): string[];
27
+ export declare function toEmailAugmentedResult<T extends object & {
28
+ length?: never;
29
+ }>(base: T, emailResult: EmailDeliveryResult | undefined): {
30
+ content: {
31
+ type: "text";
32
+ text: string;
33
+ }[];
34
+ structuredContent: Record<string, unknown>;
35
+ };
36
+ export declare function maybeDeliverToolEmail(input: ToolEmailInput): Promise<EmailDeliveryResult | undefined>;
37
+ //# sourceMappingURL=email-delivery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"email-delivery.d.ts","sourceRoot":"","sources":["../../src/tools/email-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAM7D,eAAO,MAAM,wBAAwB;;;;iBAuBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,yBAAyB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAW5E;AAID,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,EAC1E,IAAI,EAAE,CAAC,EACP,WAAW,EAAE,mBAAmB,GAAG,SAAS;;;;;;EAO7C;AAiCD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CA2C1C"}
@@ -0,0 +1,115 @@
1
+ import { z } from "zod";
2
+ import { normalizedEmailAddressSchema, uniqueRecipients } from "../email-addresses.js";
3
+ import { EmailDeliverySetupError, MAX_EMAIL_SUBJECT_CHARACTERS, MAX_EMAIL_TEXT_CHARACTERS, } from "../email-types.js";
4
+ import { formatErrorForLog } from "../logging.js";
5
+ import { sendEmailMessage } from "../services/email.js";
6
+ import { flattenControlCharacters } from "../text.js";
7
+ import { toStructuredContent } from "./_shared.js";
8
+ export const emailDeliveryInputSchema = z.object({
9
+ to: z
10
+ .array(normalizedEmailAddressSchema)
11
+ .min(1)
12
+ .max(100)
13
+ .describe("One or more recipient email addresses. The server's SMTP recipient policy may enforce a lower limit."),
14
+ subject: z
15
+ .string()
16
+ .max(MAX_EMAIL_SUBJECT_CHARACTERS)
17
+ .refine((subject) => !/[\r\n]/.test(subject), "Subject must be a single line.")
18
+ .optional()
19
+ .describe("Optional single-line email subject. Defaults to a tool-specific subject when omitted."),
20
+ message: z
21
+ .string()
22
+ .max(5000)
23
+ .optional()
24
+ .describe(`Optional plain-text message to prepend above generated qURL details. The final assembled email is limited to ${MAX_EMAIL_TEXT_CHARACTERS.toLocaleString("en-US")} characters.`),
25
+ });
26
+ export function singleLineEmailDetail(value) {
27
+ return flattenControlCharacters(value);
28
+ }
29
+ export function uploadEmailDetailLines(details) {
30
+ return [
31
+ details.intro,
32
+ `File Name: ${singleLineEmailDetail(details.fileName)}`,
33
+ `Content Type: ${singleLineEmailDetail(details.contentType)}`,
34
+ `Secure Link: ${singleLineEmailDetail(details.qurlLink)}`,
35
+ ...(details.expiresAt ? [`Expires At: ${singleLineEmailDetail(details.expiresAt)}`] : []),
36
+ ...(details.qurlSite ? [`qURL Site: ${singleLineEmailDetail(details.qurlSite)}`] : []),
37
+ ...(details.label ? [`Label: ${singleLineEmailDetail(details.label)}`] : []),
38
+ ...(details.extraLines ?? []),
39
+ ];
40
+ }
41
+ // Match toStructuredContent's plain-object boundary; `length?: never` keeps
42
+ // arrays from being silently spread into numeric object keys.
43
+ export function toEmailAugmentedResult(base, emailResult) {
44
+ const payload = emailResult ? { ...base, email_delivery: emailResult } : base;
45
+ return {
46
+ content: [{ type: "text", text: JSON.stringify(payload) }],
47
+ structuredContent: toStructuredContent(payload),
48
+ };
49
+ }
50
+ function getSanitizedDeliveryFailureReason(error) {
51
+ if (error instanceof EmailDeliverySetupError) {
52
+ switch (error.kind) {
53
+ case "authorization":
54
+ return "Email delivery authorization context was unavailable.";
55
+ case "smtp":
56
+ return "Email delivery was not attempted because SMTP configuration or connection failed.";
57
+ case "input":
58
+ return "Email delivery was not attempted because recipient or message validation failed.";
59
+ }
60
+ }
61
+ return "Email delivery was not attempted because delivery setup failed.";
62
+ }
63
+ function skippedDeliveryResult(recipients, skippedReason) {
64
+ return {
65
+ attempted: false,
66
+ enabled: true,
67
+ recipients,
68
+ sent: 0,
69
+ failed: recipients.length,
70
+ results: recipients.map((email) => ({
71
+ email,
72
+ success: false,
73
+ skipped: true,
74
+ error: skippedReason,
75
+ })),
76
+ skipped_reason: skippedReason,
77
+ };
78
+ }
79
+ export async function maybeDeliverToolEmail(input) {
80
+ if (!input.delivery)
81
+ return undefined;
82
+ const subject = flattenControlCharacters(input.delivery.subject?.trim() || input.defaultSubject.trim());
83
+ // Preserve formatting in the caller-authored message because it is sent only
84
+ // as the plain-text body. Generated detail fields are flattened separately
85
+ // so an untrusted value cannot visually create another structured detail row.
86
+ const sections = [
87
+ input.delivery.message?.trim(),
88
+ input.detailLines.join("\n"),
89
+ "Sent by qURL.",
90
+ ].filter((section) => typeof section === "string" && section.length > 0);
91
+ const text = sections.join("\n\n");
92
+ const recipients = uniqueRecipients(input.delivery.to);
93
+ // Fail with a structured skipped result here for tool callers. The service
94
+ // repeats this boundary check because it is also exported for direct use.
95
+ // Match Zod's UTF-16-unit maxLength semantics for caller-provided sections.
96
+ if (text.length > MAX_EMAIL_TEXT_CHARACTERS) {
97
+ return skippedDeliveryResult(recipients, `Email delivery was not attempted because the assembled message exceeds ${MAX_EMAIL_TEXT_CHARACTERS.toLocaleString("en-US")} characters.`);
98
+ }
99
+ try {
100
+ return await sendEmailMessage({
101
+ to: recipients,
102
+ subject,
103
+ text,
104
+ }, { allowServerApiKeyFallback: input.allowServerApiKeyFallback });
105
+ }
106
+ catch (error) {
107
+ // Link creation has already succeeded when this helper runs. Never turn a
108
+ // delivery failure into a failed tool call because qurl_link is one-shot
109
+ // output that cannot be recovered later.
110
+ console.error(`Email delivery failed after qURL creation (${formatErrorForLog(error)})`);
111
+ const skippedReason = getSanitizedDeliveryFailureReason(error);
112
+ return skippedDeliveryResult(recipients, skippedReason);
113
+ }
114
+ }
115
+ //# sourceMappingURL=email-delivery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"email-delivery.js","sourceRoot":"","sources":["../../src/tools/email-delivery.ts"],"names":[],"mappings":"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"}
@@ -1,221 +1,68 @@
1
1
  import { z } from "zod";
2
2
  import type { IQURLClient } from "../client.js";
3
+ import { type ToolRuntimeOptions } from "./_shared.js";
3
4
  export declare const extendQurlSchema: z.ZodObject<{
4
5
  resource_id: z.ZodString;
5
6
  extend_by: z.ZodString;
6
- }, "strip", z.ZodTypeAny, {
7
- resource_id: string;
8
- extend_by: string;
9
- }, {
10
- resource_id: string;
11
- extend_by: string;
12
- }>;
13
- export declare function extendQurlTool(client: IQURLClient): {
7
+ }, z.core.$strip>;
8
+ export declare function extendQurlTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
14
9
  name: string;
15
10
  title: string;
16
11
  description: string;
17
12
  inputSchema: z.ZodObject<{
18
13
  resource_id: z.ZodString;
19
14
  extend_by: z.ZodString;
20
- }, "strip", z.ZodTypeAny, {
21
- resource_id: string;
22
- extend_by: string;
23
- }, {
24
- resource_id: string;
25
- extend_by: string;
26
- }>;
15
+ }, z.core.$strip>;
27
16
  outputSchema: z.ZodObject<{
28
17
  resource_id: z.ZodString;
29
18
  qurl_site: z.ZodOptional<z.ZodString>;
30
- target_url: z.ZodString;
19
+ target_url: z.ZodOptional<z.ZodString>;
31
20
  description: z.ZodOptional<z.ZodString>;
32
- tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
21
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
33
22
  expires_at: z.ZodString;
34
23
  created_at: z.ZodString;
35
- status: z.ZodEnum<["active", "revoked"]>;
24
+ status: z.ZodCatch<z.ZodEnum<{
25
+ active: "active";
26
+ expired: "expired";
27
+ revoked: "revoked";
28
+ unknown: "unknown";
29
+ }>>;
36
30
  custom_domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
31
+ slug: z.ZodOptional<z.ZodString>;
37
32
  preserve_host: z.ZodOptional<z.ZodBoolean>;
38
33
  qurl_count: z.ZodOptional<z.ZodNumber>;
39
34
  qurls: z.ZodOptional<z.ZodArray<z.ZodObject<{
40
35
  qurl_id: z.ZodString;
41
36
  label: z.ZodOptional<z.ZodString>;
42
- status: z.ZodEnum<["active", "consumed", "expired", "revoked"]>;
43
- one_time_use: z.ZodBoolean;
44
- max_sessions: z.ZodNumber;
45
- session_duration: z.ZodNumber;
46
- use_count: z.ZodNumber;
37
+ status: z.ZodCatch<z.ZodEnum<{
38
+ active: "active";
39
+ consumed: "consumed";
40
+ expired: "expired";
41
+ revoked: "revoked";
42
+ unknown: "unknown";
43
+ }>>;
44
+ one_time_use: z.ZodOptional<z.ZodBoolean>;
45
+ max_sessions: z.ZodOptional<z.ZodNumber>;
46
+ session_duration: z.ZodOptional<z.ZodNumber>;
47
+ use_count: z.ZodOptional<z.ZodNumber>;
47
48
  qurl_site: z.ZodOptional<z.ZodString>;
48
49
  access_policy: z.ZodOptional<z.ZodObject<{
49
- ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
50
- ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
51
- geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
52
- geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
50
+ ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
51
+ ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
52
+ geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
53
+ geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
53
54
  user_agent_allow_regex: z.ZodOptional<z.ZodString>;
54
55
  user_agent_deny_regex: z.ZodOptional<z.ZodString>;
55
56
  ai_agent_policy: z.ZodOptional<z.ZodObject<{
56
57
  block_all: z.ZodOptional<z.ZodBoolean>;
57
- deny_categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
58
- allow_categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
59
- }, "strip", z.ZodTypeAny, {
60
- block_all?: boolean | undefined;
61
- deny_categories?: string[] | undefined;
62
- allow_categories?: string[] | undefined;
63
- }, {
64
- block_all?: boolean | undefined;
65
- deny_categories?: string[] | undefined;
66
- allow_categories?: string[] | undefined;
67
- }>>;
68
- }, "strip", z.ZodTypeAny, {
69
- ip_allowlist?: string[] | undefined;
70
- ip_denylist?: string[] | undefined;
71
- geo_allowlist?: string[] | undefined;
72
- geo_denylist?: string[] | undefined;
73
- user_agent_allow_regex?: string | undefined;
74
- user_agent_deny_regex?: string | undefined;
75
- ai_agent_policy?: {
76
- block_all?: boolean | undefined;
77
- deny_categories?: string[] | undefined;
78
- allow_categories?: string[] | undefined;
79
- } | undefined;
80
- }, {
81
- ip_allowlist?: string[] | undefined;
82
- ip_denylist?: string[] | undefined;
83
- geo_allowlist?: string[] | undefined;
84
- geo_denylist?: string[] | undefined;
85
- user_agent_allow_regex?: string | undefined;
86
- user_agent_deny_regex?: string | undefined;
87
- ai_agent_policy?: {
88
- block_all?: boolean | undefined;
89
- deny_categories?: string[] | undefined;
90
- allow_categories?: string[] | undefined;
91
- } | undefined;
92
- }>>;
93
- created_at: z.ZodString;
94
- expires_at: z.ZodString;
95
- }, "strip", z.ZodTypeAny, {
96
- status: "active" | "consumed" | "expired" | "revoked";
97
- qurl_id: string;
98
- one_time_use: boolean;
99
- max_sessions: number;
100
- session_duration: number;
101
- use_count: number;
102
- created_at: string;
103
- expires_at: string;
104
- label?: string | undefined;
105
- qurl_site?: string | undefined;
106
- access_policy?: {
107
- ip_allowlist?: string[] | undefined;
108
- ip_denylist?: string[] | undefined;
109
- geo_allowlist?: string[] | undefined;
110
- geo_denylist?: string[] | undefined;
111
- user_agent_allow_regex?: string | undefined;
112
- user_agent_deny_regex?: string | undefined;
113
- ai_agent_policy?: {
114
- block_all?: boolean | undefined;
115
- deny_categories?: string[] | undefined;
116
- allow_categories?: string[] | undefined;
117
- } | undefined;
118
- } | undefined;
119
- }, {
120
- status: "active" | "consumed" | "expired" | "revoked";
121
- qurl_id: string;
122
- one_time_use: boolean;
123
- max_sessions: number;
124
- session_duration: number;
125
- use_count: number;
126
- created_at: string;
127
- expires_at: string;
128
- label?: string | undefined;
129
- qurl_site?: string | undefined;
130
- access_policy?: {
131
- ip_allowlist?: string[] | undefined;
132
- ip_denylist?: string[] | undefined;
133
- geo_allowlist?: string[] | undefined;
134
- geo_denylist?: string[] | undefined;
135
- user_agent_allow_regex?: string | undefined;
136
- user_agent_deny_regex?: string | undefined;
137
- ai_agent_policy?: {
138
- block_all?: boolean | undefined;
139
- deny_categories?: string[] | undefined;
140
- allow_categories?: string[] | undefined;
141
- } | undefined;
142
- } | undefined;
143
- }>, "many">>;
144
- }, "strip", z.ZodTypeAny, {
145
- status: "active" | "revoked";
146
- created_at: string;
147
- expires_at: string;
148
- resource_id: string;
149
- target_url: string;
150
- qurl_site?: string | undefined;
151
- description?: string | undefined;
152
- tags?: string[] | undefined;
153
- custom_domain?: string | null | undefined;
154
- preserve_host?: boolean | undefined;
155
- qurl_count?: number | undefined;
156
- qurls?: {
157
- status: "active" | "consumed" | "expired" | "revoked";
158
- qurl_id: string;
159
- one_time_use: boolean;
160
- max_sessions: number;
161
- session_duration: number;
162
- use_count: number;
163
- created_at: string;
164
- expires_at: string;
165
- label?: string | undefined;
166
- qurl_site?: string | undefined;
167
- access_policy?: {
168
- ip_allowlist?: string[] | undefined;
169
- ip_denylist?: string[] | undefined;
170
- geo_allowlist?: string[] | undefined;
171
- geo_denylist?: string[] | undefined;
172
- user_agent_allow_regex?: string | undefined;
173
- user_agent_deny_regex?: string | undefined;
174
- ai_agent_policy?: {
175
- block_all?: boolean | undefined;
176
- deny_categories?: string[] | undefined;
177
- allow_categories?: string[] | undefined;
178
- } | undefined;
179
- } | undefined;
180
- }[] | undefined;
181
- }, {
182
- status: "active" | "revoked";
183
- created_at: string;
184
- expires_at: string;
185
- resource_id: string;
186
- target_url: string;
187
- qurl_site?: string | undefined;
188
- description?: string | undefined;
189
- tags?: string[] | undefined;
190
- custom_domain?: string | null | undefined;
191
- preserve_host?: boolean | undefined;
192
- qurl_count?: number | undefined;
193
- qurls?: {
194
- status: "active" | "consumed" | "expired" | "revoked";
195
- qurl_id: string;
196
- one_time_use: boolean;
197
- max_sessions: number;
198
- session_duration: number;
199
- use_count: number;
200
- created_at: string;
201
- expires_at: string;
202
- label?: string | undefined;
203
- qurl_site?: string | undefined;
204
- access_policy?: {
205
- ip_allowlist?: string[] | undefined;
206
- ip_denylist?: string[] | undefined;
207
- geo_allowlist?: string[] | undefined;
208
- geo_denylist?: string[] | undefined;
209
- user_agent_allow_regex?: string | undefined;
210
- user_agent_deny_regex?: string | undefined;
211
- ai_agent_policy?: {
212
- block_all?: boolean | undefined;
213
- deny_categories?: string[] | undefined;
214
- allow_categories?: string[] | undefined;
215
- } | undefined;
216
- } | undefined;
217
- }[] | undefined;
218
- }>;
58
+ deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
59
+ allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
60
+ }, z.core.$loose>>;
61
+ }, z.core.$loose>>;
62
+ created_at: z.ZodOptional<z.ZodString>;
63
+ expires_at: z.ZodOptional<z.ZodString>;
64
+ }, z.core.$loose>>>;
65
+ }, z.core.$loose>;
219
66
  annotations: {
220
67
  title: string;
221
68
  readOnlyHint: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"extend-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/extend-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAEH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCjD"}
1
+ {"version":3,"file":"extend-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/extend-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAGtB,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AAEH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,kBAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCjD"}
@@ -1,11 +1,11 @@
1
1
  import { z } from "zod";
2
- import { resourceIdSchema, toStructuredContent, withMissingApiKeyHandler } from "./_shared.js";
2
+ import { resourceIdSchema, toStructuredContent, withMissingApiKeyHandler, } from "./_shared.js";
3
3
  import { extendQurlOutputSchema } from "./output-schemas.js";
4
4
  export const extendQurlSchema = z.object({
5
5
  resource_id: resourceIdSchema("extend"),
6
6
  extend_by: z.string().min(1).describe('Duration to extend by (e.g., "24h", "7d")'),
7
7
  });
8
- export function extendQurlTool(client) {
8
+ export function extendQurlTool(client, _runtime = { mode: "stdio" }) {
9
9
  return {
10
10
  name: "extend_qurl",
11
11
  title: "Extend qURL Expiration",
@@ -14,7 +14,7 @@ export function extendQurlTool(client) {
14
14
  "Use this when the only change you need is more time on the clock. " +
15
15
  "Use `update_qurl` instead when you also need to change tags, description, or set an absolute `expires_at`. " +
16
16
  "Use `delete_qurl` when you want to cut off access entirely. " +
17
- "Accepts both `r_` and `q_` IDs (q_ is auto-resolved to its parent resource). " +
17
+ "Accepts resource public keys, CRIDs, legacy `r_` IDs, and `q_` display IDs (q_ is auto-resolved to its parent resource). " +
18
18
  "**Not idempotent:** calling twice with the same `extend_by` extends the expiration twice. If you need an absolute target, use `update_qurl` with `expires_at` so retries on transient errors don't double-push. " +
19
19
  "Returns the updated resource with the new `expires_at` (same shape as `get_qurl`).",
20
20
  inputSchema: extendQurlSchema,
@@ -1 +1 @@
1
- {"version":3,"file":"extend-qurl.js","sourceRoot":"","sources":["../../src/tools/extend-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CACnF,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,oEAAoE;YACpE,4GAA4G;YAC5G,oEAAoE;YACpE,6GAA6G;YAC7G,8DAA8D;YAC9D,+EAA+E;YAC/E,kNAAkN;YAClN,oFAAoF;QACtF,WAAW,EAAE,gBAAgB;QAC7B,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE;YACX,KAAK,EAAE,wBAAwB;YAC/B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAuC,EAAE,EAAE;YAClF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE;gBACxD,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;qBAClC;iBACF;gBACD,iBAAiB,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC;aACpD,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"extend-qurl.js","sourceRoot":"","sources":["../../src/tools/extend-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GAEzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CACnF,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAC5B,MAAmB,EACnB,WAA+B,EAAE,IAAI,EAAE,OAAO,EAAE;IAEhD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,oEAAoE;YACpE,4GAA4G;YAC5G,oEAAoE;YACpE,6GAA6G;YAC7G,8DAA8D;YAC9D,2HAA2H;YAC3H,kNAAkN;YAClN,oFAAoF;QACtF,WAAW,EAAE,gBAAgB;QAC7B,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE;YACX,KAAK,EAAE,wBAAwB;YAC/B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAuC,EAAE,EAAE;YAClF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE;gBACxD,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;qBAClC;iBACF;gBACD,iBAAiB,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC;aACpD,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}