@sendsafely/mcp-server-local 0.0.0-stage → 1.0.5

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 (134) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +22 -0
  3. package/README.md +390 -2
  4. package/dist/context.d.ts +2 -0
  5. package/dist/context.js +21 -0
  6. package/dist/credentials.d.ts +7 -0
  7. package/dist/credentials.js +59 -0
  8. package/dist/server.d.ts +2 -0
  9. package/dist/server.js +47 -0
  10. package/dist/setupCredentials.d.ts +2 -0
  11. package/dist/setupCredentials.js +151 -0
  12. package/dist/trustedDeviceKeyStore.d.ts +3 -0
  13. package/dist/trustedDeviceKeyStore.js +34 -0
  14. package/node_modules/@sendsafely/mcp-tools-core/LICENSE +201 -0
  15. package/node_modules/@sendsafely/mcp-tools-core/dist/approval.d.ts +51 -0
  16. package/node_modules/@sendsafely/mcp-tools-core/dist/approval.js +148 -0
  17. package/node_modules/@sendsafely/mcp-tools-core/dist/constants.d.ts +5 -0
  18. package/node_modules/@sendsafely/mcp-tools-core/dist/constants.js +8 -0
  19. package/node_modules/@sendsafely/mcp-tools-core/dist/context.d.ts +25 -0
  20. package/node_modules/@sendsafely/mcp-tools-core/dist/context.js +16 -0
  21. package/node_modules/@sendsafely/mcp-tools-core/dist/index.d.ts +18 -0
  22. package/node_modules/@sendsafely/mcp-tools-core/dist/index.js +17 -0
  23. package/node_modules/@sendsafely/mcp-tools-core/dist/instructions.d.ts +1 -0
  24. package/node_modules/@sendsafely/mcp-tools-core/dist/instructions.js +17 -0
  25. package/node_modules/@sendsafely/mcp-tools-core/dist/jsonResult.d.ts +3 -0
  26. package/node_modules/@sendsafely/mcp-tools-core/dist/jsonResult.js +15 -0
  27. package/node_modules/@sendsafely/mcp-tools-core/dist/recipientAddContext.d.ts +42 -0
  28. package/node_modules/@sendsafely/mcp-tools-core/dist/recipientAddContext.js +182 -0
  29. package/node_modules/@sendsafely/mcp-tools-core/dist/runTool.d.ts +2 -0
  30. package/node_modules/@sendsafely/mcp-tools-core/dist/runTool.js +22 -0
  31. package/node_modules/@sendsafely/mcp-tools-core/dist/safeHandler.d.ts +17 -0
  32. package/node_modules/@sendsafely/mcp-tools-core/dist/safeHandler.js +32 -0
  33. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/clientFactory.d.ts +17 -0
  34. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/clientFactory.js +29 -0
  35. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/oauthError.d.ts +9 -0
  36. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/oauthError.js +34 -0
  37. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/sdkPromise.d.ts +53 -0
  38. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/sdkPromise.js +462 -0
  39. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/signedFetch.d.ts +6 -0
  40. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/signedFetch.js +28 -0
  41. package/node_modules/@sendsafely/mcp-tools-core/dist/store/keyStore.d.ts +6 -0
  42. package/node_modules/@sendsafely/mcp-tools-core/dist/store/keyStore.js +1 -0
  43. package/node_modules/@sendsafely/mcp-tools-core/dist/store/packageSecretCache.d.ts +18 -0
  44. package/node_modules/@sendsafely/mcp-tools-core/dist/store/packageSecretCache.js +39 -0
  45. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/createDirectory.d.ts +9 -0
  46. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/createDirectory.js +53 -0
  47. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteDirectory.d.ts +10 -0
  48. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteDirectory.js +46 -0
  49. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteFile.d.ts +11 -0
  50. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteFile.js +53 -0
  51. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getActivityLog.d.ts +8 -0
  52. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getActivityLog.js +44 -0
  53. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getDirectory.d.ts +12 -0
  54. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getDirectory.js +51 -0
  55. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getEnterpriseInfo.d.ts +5 -0
  56. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getEnterpriseInfo.js +27 -0
  57. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getFileInformation.d.ts +9 -0
  58. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getFileInformation.js +34 -0
  59. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getPackageInformation.d.ts +7 -0
  60. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getPackageInformation.js +41 -0
  61. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getReceivedPackages.d.ts +5 -0
  62. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getReceivedPackages.js +54 -0
  63. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getRecipient.d.ts +8 -0
  64. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getRecipient.js +30 -0
  65. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getSentPackages.d.ts +7 -0
  66. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getSentPackages.js +84 -0
  67. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getWorkspaces.d.ts +5 -0
  68. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getWorkspaces.js +114 -0
  69. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/index.d.ts +46 -0
  70. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/index.js +92 -0
  71. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/moveDirectory.d.ts +9 -0
  72. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/moveDirectory.js +39 -0
  73. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/removeRecipient.d.ts +8 -0
  74. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/removeRecipient.js +34 -0
  75. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/renameDirectory.d.ts +9 -0
  76. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/renameDirectory.js +34 -0
  77. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/setRecipientPhoneNumber.d.ts +10 -0
  78. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/setRecipientPhoneNumber.js +40 -0
  79. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addPackageMessage.d.ts +9 -0
  80. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addPackageMessage.js +37 -0
  81. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipient.d.ts +9 -0
  82. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipient.js +109 -0
  83. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientWithSms.d.ts +11 -0
  84. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientWithSms.js +115 -0
  85. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientsBulk.d.ts +9 -0
  86. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientsBulk.js +110 -0
  87. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createPackage.d.ts +6 -0
  88. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createPackage.js +65 -0
  89. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createWorkspace.d.ts +10 -0
  90. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createWorkspace.js +107 -0
  91. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/deletePackage.d.ts +10 -0
  92. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/deletePackage.js +39 -0
  93. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadFileFromDirectory.d.ts +12 -0
  94. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadFileFromDirectory.js +91 -0
  95. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadPackageFiles.d.ts +12 -0
  96. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadPackageFiles.js +205 -0
  97. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizePackage.d.ts +9 -0
  98. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizePackage.js +111 -0
  99. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizeUndisclosedPackage.d.ts +9 -0
  100. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizeUndisclosedPackage.js +57 -0
  101. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/generateTrustedDeviceKeypair.d.ts +10 -0
  102. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/generateTrustedDeviceKeypair.js +75 -0
  103. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageInformationFromLink.d.ts +8 -0
  104. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageInformationFromLink.js +50 -0
  105. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageKeycode.d.ts +11 -0
  106. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageKeycode.js +120 -0
  107. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageMessage.d.ts +9 -0
  108. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageMessage.js +59 -0
  109. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/listDownloadedFiles.d.ts +5 -0
  110. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/listDownloadedFiles.js +71 -0
  111. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/readDownloadedFile.d.ts +8 -0
  112. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/readDownloadedFile.js +176 -0
  113. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/uploadFile.d.ts +12 -0
  114. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/uploadFile.js +69 -0
  115. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateFile.d.ts +9 -0
  116. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateFile.js +38 -0
  117. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updatePackage.d.ts +14 -0
  118. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updatePackage.js +122 -0
  119. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateRecipientRole.d.ts +9 -0
  120. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateRecipientRole.js +45 -0
  121. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/verifyCredentials.d.ts +5 -0
  122. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/verifyCredentials.js +27 -0
  123. package/node_modules/@sendsafely/mcp-tools-core/dist/types/sendsafely.d.ts +432 -0
  124. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageChecksum.d.ts +1 -0
  125. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageChecksum.js +7 -0
  126. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageDir.d.ts +8 -0
  127. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageDir.js +50 -0
  128. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageLink.d.ts +2 -0
  129. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageLink.js +4 -0
  130. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/sanitizeFilename.d.ts +4 -0
  131. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/sanitizeFilename.js +8 -0
  132. package/node_modules/@sendsafely/mcp-tools-core/package.json +40 -0
  133. package/npm-shrinkwrap.json +1632 -0
  134. package/package.json +58 -4
@@ -0,0 +1,34 @@
1
+ export class SendSafelyApiError extends Error {
2
+ code;
3
+ constructor(message, code) {
4
+ super(message);
5
+ this.name = "SendSafelyApiError";
6
+ this.code = code;
7
+ }
8
+ }
9
+ const CODE_TO_KIND = {
10
+ OAUTH_TOKEN_INVALID: "invalid_token",
11
+ OAUTH_INSUFFICIENT_SCOPE: "insufficient_scope",
12
+ OAUTH_TEMPORARILY_UNAVAILABLE: "temporarily_unavailable",
13
+ };
14
+ export function oauthFailureKind(err) {
15
+ if (!(err instanceof SendSafelyApiError))
16
+ return undefined;
17
+ return CODE_TO_KIND[err.code];
18
+ }
19
+ export const OAUTH_FAILURE_KEY = "oauthFailure";
20
+ export function recordOAuthFailure(bag, kind) {
21
+ if (bag === undefined)
22
+ return;
23
+ if (bag[OAUTH_FAILURE_KEY] === undefined)
24
+ bag[OAUTH_FAILURE_KEY] = kind;
25
+ }
26
+ const KINDS = [
27
+ "invalid_token",
28
+ "insufficient_scope",
29
+ "temporarily_unavailable",
30
+ ];
31
+ export function readOAuthFailure(bag) {
32
+ const recorded = bag?.[OAUTH_FAILURE_KEY];
33
+ return KINDS.find((kind) => kind === recorded);
34
+ }
@@ -0,0 +1,53 @@
1
+ import type SendSafely from "@sendsafely/sendsafely";
2
+ import type { ActivityLogResult, CreatePackageResult, DirectoryListing, DownloadConfig, EnterpriseInfo, FileInfo, FinalizeResult, PackageInfo, Recipient, ReceivedPackagesResult, RecipientsResult, SentPackagesResult, UploadedPublicKey, UserInfo, WorkspacesResult } from "@sendsafely/sendsafely";
3
+ export declare function verifyCredentials(ss: SendSafely): Promise<string>;
4
+ export declare function getUserInformation(ss: SendSafely): Promise<UserInfo>;
5
+ export declare function enterpriseInfo(ss: SendSafely): Promise<EnterpriseInfo>;
6
+ export declare function getReceivedPackagesPage(ss: SendSafely, rowIndex: number): Promise<ReceivedPackagesResult>;
7
+ export declare function getActivePackagesPage(ss: SendSafely, rowIndex: number): Promise<SentPackagesResult>;
8
+ export declare function getArchivedPackagesPage(ss: SendSafely, rowIndex: number): Promise<SentPackagesResult>;
9
+ export declare function getWorkspacesPage(ss: SendSafely, rowIndex: number): Promise<WorkspacesResult>;
10
+ export declare function packageInformation(ss: SendSafely, packageId: string): Promise<PackageInfo>;
11
+ export declare function packageInformationFromLink(ss: SendSafely, link: string): Promise<PackageInfo>;
12
+ export declare function getPackageMessage(ss: SendSafely, packageId: string, packageCode: string, keyCode: string): Promise<unknown>;
13
+ export declare function decryptMessage(ss: SendSafely, packageId: string, keyCode: string, serverSecret: string, ciphertext: string): Promise<string>;
14
+ export declare function getDecryptedPackageMessage(ss: SendSafely, packageId: string, packageCode: string, keyCode: string, serverSecret: string): Promise<string | null>;
15
+ export declare function getActivityLog(ss: SendSafely, packageId: string, rowIndex: number): Promise<ActivityLogResult>;
16
+ export declare function getFileInformation(ss: SendSafely, packageId: string, directoryId: string | undefined, fileId: string): Promise<FileInfo>;
17
+ export declare function downloadFileToPath(ss: SendSafely, packageId: string, fileId: string, keyCode: string, config: DownloadConfig): Promise<void>;
18
+ export declare function downloadFileFromDirectoryToPath(ss: SendSafely, packageId: string, directoryId: string, fileId: string, keyCode: string, config: DownloadConfig): Promise<void>;
19
+ export declare function createPackage(ss: SendSafely): Promise<CreatePackageResult>;
20
+ export declare function createWorkspace(ss: SendSafely): Promise<CreatePackageResult>;
21
+ export interface UploadedFile {
22
+ packageId: string;
23
+ fileId: string;
24
+ fileSize: number;
25
+ fileName: string;
26
+ }
27
+ export declare function encryptAndUploadFile(ss: SendSafely, packageId: string, keyCode: string, serverSecret: string, filePath: string, directoryId?: string): Promise<UploadedFile>;
28
+ export declare function encryptAndUploadMessage(ss: SendSafely, packageId: string, keyCode: string, serverSecret: string, message: string): Promise<unknown>;
29
+ export declare function finalizePackage(ss: SendSafely, packageId: string, packageCode: string, keyCode: string): Promise<FinalizeResult>;
30
+ export declare function notifyPackageRecipients(ss: SendSafely, packageId: string, keyCode: string): Promise<void>;
31
+ export declare function finalizeUndisclosedPackage(ss: SendSafely, packageId: string, packageCode: string, keyCode: string, password: string): Promise<FinalizeResult>;
32
+ export declare function addRecipient(ss: SendSafely, packageId: string, email: string, keyCode: string): Promise<Recipient>;
33
+ export declare function addRecipients(ss: SendSafely, packageId: string, emails: string[], keyCode: string): Promise<RecipientsResult>;
34
+ export declare function addRecipientWithSMS(ss: SendSafely, packageId: string, email: string, keyCode: string, phonenumber: string, countryCode: string): Promise<Recipient>;
35
+ export declare function addRecipientPhonenumber(ss: SendSafely, packageId: string, recipientId: string, phonenumber: string, countryCode: string): Promise<unknown>;
36
+ export declare function updateRecipientRole(ss: SendSafely, packageId: string, recipientId: string, roleName: string): Promise<unknown>;
37
+ export declare function removeRecipient(ss: SendSafely, packageId: string, recipientId: string): Promise<unknown>;
38
+ export declare function getRecipient(ss: SendSafely, packageId: string, recipientId: string): Promise<Recipient>;
39
+ export interface GeneratedTrustedDeviceKey {
40
+ privateKey: string;
41
+ publicKey: UploadedPublicKey;
42
+ }
43
+ export declare function generateRsaKeyPair(ss: SendSafely, description: string): Promise<GeneratedTrustedDeviceKey>;
44
+ export declare function getKeycode(ss: SendSafely, privateKey: string, publicKeyId: string, packageId: string): Promise<string>;
45
+ export declare function deletePackage(ss: SendSafely, packageId: string): Promise<unknown>;
46
+ export declare function updatePackage(ss: SendSafely, packageId: string, data: Record<string, unknown>): Promise<PackageInfo>;
47
+ export declare function deleteFile(ss: SendSafely, packageId: string, fileId: string, directoryId?: string): Promise<unknown>;
48
+ export declare function updateFile(ss: SendSafely, packageId: string, fileId: string, fileName: string): Promise<unknown>;
49
+ export declare function createDirectory(ss: SendSafely, packageId: string, directoryName: string, parentDirectoryId?: string): Promise<unknown>;
50
+ export declare function getDirectory(ss: SendSafely, packageId: string, directoryId: string, directoryIndex: number, fileIndex: number, sortField: string, sortOrder: string): Promise<DirectoryListing>;
51
+ export declare function renameDirectory(ss: SendSafely, packageId: string, directoryId: string, directoryName: string): Promise<unknown>;
52
+ export declare function moveDirectory(ss: SendSafely, packageId: string, sourceDirectoryId: string, targetDirectoryId: string): Promise<unknown>;
53
+ export declare function deleteDirectory(ss: SendSafely, packageId: string, directoryId: string): Promise<unknown>;
@@ -0,0 +1,462 @@
1
+ import { SendSafelyApiError } from "./oauthError.js";
2
+ import { signedRequest } from "./signedFetch.js";
3
+ function toErrorMessage(code, message) {
4
+ if (message && message.length > 0)
5
+ return message;
6
+ if (code !== undefined && code !== null && code !== "") {
7
+ return `SendSafely error ${code}`;
8
+ }
9
+ return "Unknown SendSafely error";
10
+ }
11
+ function toSdkError(code, message) {
12
+ const rawCode = code === undefined || code === null ? "" : String(code);
13
+ return new SendSafelyApiError(toErrorMessage(code, message), rawCode);
14
+ }
15
+ function withErrorListener(ss, invoke) {
16
+ return new Promise((resolve, reject) => {
17
+ let settled = false;
18
+ const errorId = ss.on("sendsafely.error", (code, message) => {
19
+ if (settled)
20
+ return;
21
+ settled = true;
22
+ ss.unbind("sendsafely.error", errorId);
23
+ reject(toSdkError(code, message));
24
+ });
25
+ try {
26
+ invoke((value) => {
27
+ if (settled)
28
+ return;
29
+ settled = true;
30
+ ss.unbind("sendsafely.error", errorId);
31
+ resolve(value);
32
+ });
33
+ }
34
+ catch (err) {
35
+ if (settled)
36
+ return;
37
+ settled = true;
38
+ ss.unbind("sendsafely.error", errorId);
39
+ reject(err instanceof Error ? err : new Error(String(err)));
40
+ }
41
+ });
42
+ }
43
+ export function verifyCredentials(ss) {
44
+ return withErrorListener(ss, (resolve) => {
45
+ ss.verifyCredentials(resolve);
46
+ });
47
+ }
48
+ export function getUserInformation(ss) {
49
+ return withErrorListener(ss, (resolve) => {
50
+ ss.getUserInformation(resolve);
51
+ });
52
+ }
53
+ export function enterpriseInfo(ss) {
54
+ return withErrorListener(ss, (resolve) => {
55
+ ss.enterpriseInfo((host, systemName, allowUndisclosedRecipients, headerColor, linkColor, messageEncryption) => {
56
+ const result = {
57
+ host,
58
+ systemName,
59
+ allowUndisclosedRecipients,
60
+ ...(headerColor !== undefined ? { headerColor } : {}),
61
+ ...(linkColor !== undefined ? { linkColor } : {}),
62
+ ...(messageEncryption !== undefined ? { messageEncryption } : {}),
63
+ };
64
+ resolve(result);
65
+ });
66
+ });
67
+ }
68
+ export function getReceivedPackagesPage(ss, rowIndex) {
69
+ return withErrorListener(ss, (resolve) => {
70
+ ss.getReceivedPackages(rowIndex, resolve);
71
+ });
72
+ }
73
+ export function getActivePackagesPage(ss, rowIndex) {
74
+ return withErrorListener(ss, (resolve) => {
75
+ ss.getActivePackages(rowIndex, resolve);
76
+ });
77
+ }
78
+ export function getArchivedPackagesPage(ss, rowIndex) {
79
+ return withErrorListener(ss, (resolve) => {
80
+ ss.getArchivedPackages(rowIndex, resolve);
81
+ });
82
+ }
83
+ export function getWorkspacesPage(ss, rowIndex) {
84
+ const query = rowIndex > 0 ? `?rowIndex=${encodeURIComponent(String(rowIndex))}` : "";
85
+ return signedRequest(ss, `/package/workspaces/${query}`, "GET");
86
+ }
87
+ function fetchPackageInfoRaw(ss, packageIdOrCode) {
88
+ return withErrorListener(ss, (resolve) => {
89
+ const endpoint = {
90
+ url: `/package/${encodeURIComponent(packageIdOrCode)}/`,
91
+ HTTPMethod: "GET",
92
+ mimetype: "application/json",
93
+ };
94
+ const ajax = ss.request.sendRequest(endpoint, null, true);
95
+ ss.request.processAjaxData(ajax, (data) => {
96
+ resolve(data);
97
+ });
98
+ });
99
+ }
100
+ function parseSecureLink(link) {
101
+ const url = (() => {
102
+ try {
103
+ return new URL(link);
104
+ }
105
+ catch {
106
+ return null;
107
+ }
108
+ })();
109
+ const packageCode = url?.searchParams.get("packageCode") ?? "";
110
+ const fragment = (link.split("#")[1] ?? "");
111
+ const params = new URLSearchParams(fragment);
112
+ const keyCode = params.get("keyCode") ?? params.get("keycode") ?? "";
113
+ return { packageCode, keyCode };
114
+ }
115
+ export function packageInformation(ss, packageId) {
116
+ return fetchPackageInfoRaw(ss, packageId);
117
+ }
118
+ export async function packageInformationFromLink(ss, link) {
119
+ const { packageCode, keyCode } = parseSecureLink(link);
120
+ if (!packageCode) {
121
+ throw new Error("Invalid SendSafely link: missing packageCode parameter.");
122
+ }
123
+ const info = await fetchPackageInfoRaw(ss, packageCode);
124
+ return { ...info, keyCode };
125
+ }
126
+ export function getPackageMessage(ss, packageId, packageCode, keyCode) {
127
+ return withErrorListener(ss, (resolve) => {
128
+ ss.getPackageMessage(packageId, packageCode, keyCode, resolve);
129
+ });
130
+ }
131
+ export function decryptMessage(ss, packageId, keyCode, serverSecret, ciphertext) {
132
+ return withErrorListener(ss, (resolve) => {
133
+ ss.decryptMessage(packageId, keyCode, serverSecret, ciphertext, resolve);
134
+ });
135
+ }
136
+ export async function getDecryptedPackageMessage(ss, packageId, packageCode, keyCode, serverSecret) {
137
+ const fetched = (await getPackageMessage(ss, packageId, packageCode, keyCode));
138
+ const ciphertext = fetched?.message;
139
+ if (!ciphertext)
140
+ return null;
141
+ return decryptMessage(ss, packageId, keyCode, serverSecret, ciphertext);
142
+ }
143
+ export function getActivityLog(ss, packageId, rowIndex) {
144
+ return withErrorListener(ss, (resolve) => {
145
+ ss.getActivityLog(packageId, rowIndex, resolve);
146
+ });
147
+ }
148
+ export function getFileInformation(ss, packageId, directoryId, fileId) {
149
+ return withErrorListener(ss, (resolve) => {
150
+ ss.getFileInformation(packageId, directoryId, fileId, resolve);
151
+ });
152
+ }
153
+ export function downloadFileToPath(ss, packageId, fileId, keyCode, config) {
154
+ return new Promise((resolve, reject) => {
155
+ let settled = false;
156
+ const cleanup = () => {
157
+ ss.unbind("file.saved", savedId);
158
+ ss.unbind("sendsafely.error", errorId);
159
+ };
160
+ const savedId = ss.on("file.saved", (evt) => {
161
+ if (settled)
162
+ return;
163
+ if (evt?.fileId !== fileId)
164
+ return;
165
+ settled = true;
166
+ cleanup();
167
+ resolve();
168
+ });
169
+ const errorId = ss.on("sendsafely.error", (code, message) => {
170
+ if (settled)
171
+ return;
172
+ settled = true;
173
+ cleanup();
174
+ reject(toSdkError(code, message));
175
+ });
176
+ try {
177
+ ss.downloadFile(packageId, fileId, keyCode, config);
178
+ }
179
+ catch (err) {
180
+ if (settled)
181
+ return;
182
+ settled = true;
183
+ cleanup();
184
+ reject(err instanceof Error ? err : new Error(String(err)));
185
+ }
186
+ });
187
+ }
188
+ export function downloadFileFromDirectoryToPath(ss, packageId, directoryId, fileId, keyCode, config) {
189
+ return new Promise((resolve, reject) => {
190
+ let settled = false;
191
+ const cleanup = () => {
192
+ ss.unbind("file.saved", savedId);
193
+ ss.unbind("sendsafely.error", errorId);
194
+ };
195
+ const savedId = ss.on("file.saved", (evt) => {
196
+ if (settled)
197
+ return;
198
+ if (evt?.fileId !== fileId)
199
+ return;
200
+ settled = true;
201
+ cleanup();
202
+ resolve();
203
+ });
204
+ const errorId = ss.on("sendsafely.error", (code, message) => {
205
+ if (settled)
206
+ return;
207
+ settled = true;
208
+ cleanup();
209
+ reject(toSdkError(code, message));
210
+ });
211
+ try {
212
+ ss.downloadFileFromDirectory(packageId, directoryId, fileId, keyCode, config);
213
+ }
214
+ catch (err) {
215
+ if (settled)
216
+ return;
217
+ settled = true;
218
+ cleanup();
219
+ reject(err instanceof Error ? err : new Error(String(err)));
220
+ }
221
+ });
222
+ }
223
+ export function createPackage(ss) {
224
+ return withErrorListener(ss, (resolve) => {
225
+ ss.createPackage((packageId, serverSecret, packageCode, keyCode) => {
226
+ resolve({ packageId, serverSecret, packageCode, keyCode });
227
+ });
228
+ });
229
+ }
230
+ export function createWorkspace(ss) {
231
+ return withErrorListener(ss, (resolve) => {
232
+ ss.createWorkspace((packageId, serverSecret, packageCode, keyCode) => {
233
+ resolve({ packageId, serverSecret, packageCode, keyCode });
234
+ });
235
+ });
236
+ }
237
+ export function encryptAndUploadFile(ss, packageId, keyCode, serverSecret, filePath, directoryId) {
238
+ return withErrorListener(ss, (resolve) => {
239
+ const callback = (pkgId, fileId, fileSize, fileName) => {
240
+ resolve({ packageId: pkgId, fileId, fileSize, fileName });
241
+ };
242
+ if (directoryId && directoryId.length > 0) {
243
+ ss.encryptAndUploadFilesToDirectory(packageId, keyCode, serverSecret, [filePath], "NODE_API", directoryId, callback);
244
+ }
245
+ else {
246
+ ss.encryptAndUploadFiles(packageId, keyCode, serverSecret, [filePath], "NODE_API", callback);
247
+ }
248
+ });
249
+ }
250
+ export function encryptAndUploadMessage(ss, packageId, keyCode, serverSecret, message) {
251
+ return withErrorListener(ss, (resolve) => {
252
+ ss.encryptAndUploadMessage(packageId, keyCode, serverSecret, message, resolve);
253
+ });
254
+ }
255
+ function withFinalizeListeners(ss, invoke) {
256
+ return new Promise((resolve, reject) => {
257
+ let settled = false;
258
+ const cleanup = () => {
259
+ ss.unbind("sendsafely.error", errorId);
260
+ ss.unbind("finalization.error", finalizeErrorId);
261
+ };
262
+ const errorId = ss.on("sendsafely.error", (code, message) => {
263
+ if (settled)
264
+ return;
265
+ settled = true;
266
+ cleanup();
267
+ reject(toSdkError(code, message));
268
+ });
269
+ const finalizeErrorId = ss.on("finalization.error", (data) => {
270
+ if (settled)
271
+ return;
272
+ settled = true;
273
+ cleanup();
274
+ const code = String(data?.response ?? "FINALIZE_ERROR");
275
+ const safeMessage = String(data?.message ?? "").split("#")[0] ?? "";
276
+ const text = safeMessage.length > 0 ? `${code}: ${safeMessage}` : code;
277
+ reject(new Error(text));
278
+ });
279
+ try {
280
+ invoke((value) => {
281
+ if (settled)
282
+ return;
283
+ settled = true;
284
+ cleanup();
285
+ resolve(value);
286
+ }, (err) => {
287
+ if (settled)
288
+ return;
289
+ settled = true;
290
+ cleanup();
291
+ reject(err);
292
+ });
293
+ }
294
+ catch (err) {
295
+ if (settled)
296
+ return;
297
+ settled = true;
298
+ cleanup();
299
+ reject(err instanceof Error ? err : new Error(String(err)));
300
+ }
301
+ });
302
+ }
303
+ export function finalizePackage(ss, packageId, packageCode, keyCode) {
304
+ ss.notifyRecipients = false;
305
+ return withFinalizeListeners(ss, (resolve) => {
306
+ ss.finalizePackage(packageId, packageCode, keyCode, (url, recipients, approvers, message, needsLink) => {
307
+ resolve({
308
+ bare_url: message,
309
+ recipients,
310
+ approvers,
311
+ needs_link: needsLink,
312
+ secure_link: url,
313
+ });
314
+ });
315
+ });
316
+ }
317
+ export async function notifyPackageRecipients(ss, packageId, keyCode) {
318
+ await signedRequest(ss, `/package/${encodeURIComponent(packageId)}/notify/`, "POST", { keycode: keyCode });
319
+ }
320
+ export function finalizeUndisclosedPackage(ss, packageId, packageCode, keyCode, password) {
321
+ return withFinalizeListeners(ss, (resolve) => {
322
+ ss.finalizeUndisclosedPackage(packageId, packageCode, keyCode, password, (_url, recipients, approvers, message, needsLink) => {
323
+ resolve({ bare_url: message, recipients, approvers, needs_link: needsLink });
324
+ });
325
+ });
326
+ }
327
+ export function addRecipient(ss, packageId, email, keyCode) {
328
+ return withErrorListener(ss, (resolve) => {
329
+ ss.addRecipient(packageId, email, keyCode, resolve);
330
+ });
331
+ }
332
+ export function addRecipients(ss, packageId, emails, keyCode) {
333
+ return withErrorListener(ss, (resolve) => {
334
+ ss.addRecipients(packageId, emails, keyCode, resolve);
335
+ });
336
+ }
337
+ export function addRecipientWithSMS(ss, packageId, email, keyCode, phonenumber, countryCode) {
338
+ return withErrorListener(ss, (resolve) => {
339
+ ss.addRecipientWithSMS(packageId, email, keyCode, phonenumber, countryCode, resolve);
340
+ });
341
+ }
342
+ export function addRecipientPhonenumber(ss, packageId, recipientId, phonenumber, countryCode) {
343
+ return withErrorListener(ss, (resolve) => {
344
+ ss.addRecipientPhonenumber(packageId, recipientId, phonenumber, countryCode, resolve);
345
+ });
346
+ }
347
+ export function updateRecipientRole(ss, packageId, recipientId, roleName) {
348
+ return withErrorListener(ss, (resolve) => {
349
+ ss.updateRecipientRole(packageId, recipientId, roleName, resolve);
350
+ });
351
+ }
352
+ export function removeRecipient(ss, packageId, recipientId) {
353
+ return withErrorListener(ss, (resolve) => {
354
+ ss.removeRecipient(packageId, recipientId, resolve);
355
+ });
356
+ }
357
+ export function getRecipient(ss, packageId, recipientId) {
358
+ return withErrorListener(ss, (resolve) => {
359
+ ss.getRecipient(packageId, recipientId, resolve);
360
+ });
361
+ }
362
+ export function generateRsaKeyPair(ss, description) {
363
+ return withErrorListener(ss, (resolve) => {
364
+ ss.generateRsaKeyPair(description, (privateKey, publicKey) => {
365
+ resolve({ privateKey, publicKey });
366
+ });
367
+ });
368
+ }
369
+ export function getKeycode(ss, privateKey, publicKeyId, packageId) {
370
+ return new Promise((resolve, reject) => {
371
+ let settled = false;
372
+ const cleanup = () => {
373
+ ss.unbind("sendsafely.error", errorId);
374
+ ss.unbind("keycode.get.failed", failedId);
375
+ };
376
+ const errorId = ss.on("sendsafely.error", (code, message) => {
377
+ if (settled)
378
+ return;
379
+ settled = true;
380
+ cleanup();
381
+ reject(toSdkError(code, message));
382
+ });
383
+ const failedId = ss.on("keycode.get.failed", (code, message) => {
384
+ if (settled)
385
+ return;
386
+ settled = true;
387
+ cleanup();
388
+ reject(toSdkError(code, message));
389
+ });
390
+ try {
391
+ ss.getKeycode(privateKey, publicKeyId, packageId, (keycode) => {
392
+ if (settled)
393
+ return;
394
+ settled = true;
395
+ cleanup();
396
+ resolve(keycode);
397
+ });
398
+ }
399
+ catch (err) {
400
+ if (settled)
401
+ return;
402
+ settled = true;
403
+ cleanup();
404
+ reject(err instanceof Error ? err : new Error(String(err)));
405
+ }
406
+ });
407
+ }
408
+ export function deletePackage(ss, packageId) {
409
+ return withErrorListener(ss, (resolve) => {
410
+ ss.deletePackage(packageId, resolve);
411
+ });
412
+ }
413
+ export function updatePackage(ss, packageId, data) {
414
+ return withErrorListener(ss, (resolve) => {
415
+ ss.updatePackage(packageId, data, resolve);
416
+ });
417
+ }
418
+ export function deleteFile(ss, packageId, fileId, directoryId) {
419
+ return withErrorListener(ss, (resolve) => {
420
+ if (directoryId && directoryId.length > 0) {
421
+ ss.deleteFileWithDirectory(packageId, fileId, directoryId, resolve);
422
+ }
423
+ else {
424
+ ss.deleteFile(packageId, fileId, resolve);
425
+ }
426
+ });
427
+ }
428
+ export function updateFile(ss, packageId, fileId, fileName) {
429
+ return withErrorListener(ss, (resolve) => {
430
+ ss.updateFile(packageId, fileId, fileName, resolve);
431
+ });
432
+ }
433
+ export function createDirectory(ss, packageId, directoryName, parentDirectoryId) {
434
+ return withErrorListener(ss, (resolve) => {
435
+ if (parentDirectoryId && parentDirectoryId.length > 0) {
436
+ ss.createSubdirectory(packageId, directoryName, parentDirectoryId, resolve);
437
+ }
438
+ else {
439
+ ss.createDirectory(packageId, directoryName, resolve);
440
+ }
441
+ });
442
+ }
443
+ export function getDirectory(ss, packageId, directoryId, directoryIndex, fileIndex, sortField, sortOrder) {
444
+ return withErrorListener(ss, (resolve) => {
445
+ ss.getDirectory(packageId, directoryId, directoryIndex, fileIndex, sortField, sortOrder, resolve);
446
+ });
447
+ }
448
+ export function renameDirectory(ss, packageId, directoryId, directoryName) {
449
+ return withErrorListener(ss, (resolve) => {
450
+ ss.renameDirectory(packageId, directoryId, directoryName, resolve);
451
+ });
452
+ }
453
+ export function moveDirectory(ss, packageId, sourceDirectoryId, targetDirectoryId) {
454
+ return withErrorListener(ss, (resolve) => {
455
+ ss.updateDirectory(packageId, sourceDirectoryId, targetDirectoryId, resolve);
456
+ });
457
+ }
458
+ export function deleteDirectory(ss, packageId, directoryId) {
459
+ return withErrorListener(ss, (resolve) => {
460
+ ss.deleteDirectory(packageId, directoryId, resolve);
461
+ });
462
+ }
@@ -0,0 +1,6 @@
1
+ import type SendSafely from "@sendsafely/sendsafely";
2
+ import { SendSafelyApiError } from "./oauthError.js";
3
+ export declare function classifyHttpError(status: number, headers: {
4
+ get(name: string): string | null;
5
+ } | undefined): SendSafelyApiError;
6
+ export declare function signedRequest<T>(ss: SendSafely, endpoint: string, method: "GET" | "POST" | "PUT" | "DELETE", data?: unknown): Promise<T>;
@@ -0,0 +1,28 @@
1
+ import { SendSafelyApiError } from "./oauthError.js";
2
+ export function classifyHttpError(status, headers) {
3
+ const challenge = headers?.get("www-authenticate") ?? "";
4
+ if (status === 401) {
5
+ return new SendSafelyApiError("Access token expired or invalid", "OAUTH_TOKEN_INVALID");
6
+ }
7
+ if (status === 403 && /insufficient_scope/i.test(challenge)) {
8
+ return new SendSafelyApiError("The access token lacks a scope required by this request", "OAUTH_INSUFFICIENT_SCOPE");
9
+ }
10
+ if (status === 503 && (headers?.get("retry-after") ?? null) !== null) {
11
+ return new SendSafelyApiError("SendSafely is temporarily unavailable; retry shortly", "OAUTH_TEMPORARILY_UNAVAILABLE");
12
+ }
13
+ return new SendSafelyApiError(`SendSafely request failed with HTTP ${String(status)}.`, String(status));
14
+ }
15
+ export async function signedRequest(ss, endpoint, method, data = null) {
16
+ const response = await ss.wrapperRequest.sendSignedRequest({ url: endpoint, HTTPMethod: method, mimetype: "application/json" }, data);
17
+ if (!response.ok) {
18
+ throw classifyHttpError(response.status, response.headers);
19
+ }
20
+ const body = (await response.json());
21
+ if (body.response && body.response !== "SUCCESS") {
22
+ const msg = body.message;
23
+ throw new Error(msg && msg.length > 0
24
+ ? `SendSafely error ${body.response}: ${msg}`
25
+ : `SendSafely error ${body.response}`);
26
+ }
27
+ return body;
28
+ }
@@ -0,0 +1,6 @@
1
+ export interface KeyStore {
2
+ set(id: string, secret: string): Promise<void>;
3
+ get(id: string): Promise<string | undefined>;
4
+ delete(id: string): Promise<void>;
5
+ }
6
+ export declare const ACTIVE_KEY_ID = "_active";
@@ -0,0 +1 @@
1
+ export const ACTIVE_KEY_ID = "_active";
@@ -0,0 +1,18 @@
1
+ import type { ToolExtra } from "../context.js";
2
+ export interface PackageSecrets {
3
+ keyCode: string;
4
+ serverSecret: string;
5
+ packageCode?: string;
6
+ }
7
+ export interface PackageSecretCache {
8
+ set(packageId: string, secrets: PackageSecrets): void;
9
+ get(packageId: string): PackageSecrets | undefined;
10
+ delete(packageId: string): void;
11
+ clear(): void;
12
+ }
13
+ export declare function createPackageSecretCache(): PackageSecretCache;
14
+ export type CacheFor = (extra: ToolExtra) => PackageSecretCache;
15
+ export declare class MissingPackageSecretsError extends Error {
16
+ constructor(packageId: string);
17
+ }
18
+ export declare function stripPackageSecrets<T extends object>(info: T): Omit<T, "keyCode" | "serverSecret">;
@@ -0,0 +1,39 @@
1
+ export function createPackageSecretCache() {
2
+ const store = new Map();
3
+ return {
4
+ set(packageId, secrets) {
5
+ store.set(packageId, secrets);
6
+ },
7
+ get(packageId) {
8
+ return store.get(packageId);
9
+ },
10
+ delete(packageId) {
11
+ store.delete(packageId);
12
+ },
13
+ clear() {
14
+ store.clear();
15
+ },
16
+ };
17
+ }
18
+ export class MissingPackageSecretsError extends Error {
19
+ constructor(packageId) {
20
+ super(`No cached secrets for packageId '${packageId}'. ` +
21
+ "The package's secrets must be in the server-side cache, populated " +
22
+ "by one of: create_package / create_workspace (for packages being " +
23
+ "authored), get_package_information_from_link (when a keyed link " +
24
+ "is available), or get_package_keycode (when a Trusted Device " +
25
+ "private key is registered and authorized for the package). " +
26
+ "Note: get_package_information by ID does NOT populate the cache " +
27
+ "— the SDK's by-id endpoint omits the keyCode.");
28
+ this.name = "MissingPackageSecretsError";
29
+ }
30
+ }
31
+ export function stripPackageSecrets(info) {
32
+ const result = {};
33
+ for (const [key, value] of Object.entries(info)) {
34
+ if (key === "keyCode" || key === "serverSecret")
35
+ continue;
36
+ result[key] = value;
37
+ }
38
+ return result;
39
+ }
@@ -0,0 +1,9 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
3
+ import type { ToolContext, ToolExtra } from "../context.js";
4
+ export declare function handleCreateDirectory(args: {
5
+ package_id: string;
6
+ directory_name: string;
7
+ parent_directory_id?: string | undefined;
8
+ }, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
9
+ export declare function registerCreateDirectory(mcp: McpServer, ctx: ToolContext): void;