@hasna/connectors 1.1.6 → 1.1.8

package/bin/index.js

@@ -6791,6 +6791,13 @@ var init_registry = __esm(() => {
       category: "Business Tools",
       tags: ["e-signature", "contracts", "digital", "documents", "legal"]
     },
+    {
+      name: "yousign",
+      displayName: "Yousign",
+      description: "eIDAS-compliant electronic signature API for EU workflows",
+      category: "Business Tools",
+      tags: ["e-signature", "eidas", "contracts", "documents", "legal", "eu"]
+    },
     {
       name: "signl4",
       displayName: "SIGNL4",
@@ -9744,6 +9751,19 @@ function saveApiKey(name, key, field) {
   const configDir = getConnectorConfigDir(name);
   const profile = getCurrentProfile(name);
   const keyField = field || guessKeyField(name);
+  if (keyField === "clientId" || keyField === "clientSecret") {
+    const credentialsFile = join3(configDir, "credentials.json");
+    mkdirSync2(configDir, { recursive: true });
+    let creds = {};
+    if (existsSync3(credentialsFile)) {
+      try {
+        creds = JSON.parse(readFileSync3(credentialsFile, "utf-8"));
+      } catch {}
+    }
+    creds[keyField] = key;
+    writeFileSync2(credentialsFile, JSON.stringify(creds, null, 2));
+    return;
+  }
   const profileFile = join3(configDir, "profiles", `${profile}.json`);
   const profileDir = join3(configDir, "profiles", profile);
   if (existsSync3(profileFile)) {
@@ -12361,7 +12381,7 @@ var PRESETS = {
   commerce: { description: "Commerce and finance", connectors: ["stripe", "shopify", "revolut", "mercury", "pandadoc"] }
 };
 var program2 = new Command;
-program2.name("connectors").description("Install API connectors for your project").version("1.1.6").enablePositionalOptions();
+program2.name("connectors").description("Install API connectors for your project").version("1.1.8").enablePositionalOptions();
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
   if (!isTTY) {
     console.log(`Non-interactive environment detected. Use a subcommand:

package/bin/mcp.js

@@ -24279,6 +24279,13 @@ var CONNECTORS = [
     category: "Business Tools",
     tags: ["e-signature", "contracts", "digital", "documents", "legal"]
   },
+  {
+    name: "yousign",
+    displayName: "Yousign",
+    description: "eIDAS-compliant electronic signature API for EU workflows",
+    category: "Business Tools",
+    tags: ["e-signature", "eidas", "contracts", "documents", "legal", "eu"]
+  },
   {
     name: "signl4",
     displayName: "SIGNL4",
@@ -25652,6 +25659,19 @@ function saveApiKey(name, key, field) {
   const configDir = getConnectorConfigDir(name);
   const profile = getCurrentProfile(name);
   const keyField = field || guessKeyField(name);
+  if (keyField === "clientId" || keyField === "clientSecret") {
+    const credentialsFile = join3(configDir, "credentials.json");
+    mkdirSync2(configDir, { recursive: true });
+    let creds = {};
+    if (existsSync3(credentialsFile)) {
+      try {
+        creds = JSON.parse(readFileSync3(credentialsFile, "utf-8"));
+      } catch {}
+    }
+    creds[keyField] = key;
+    writeFileSync2(credentialsFile, JSON.stringify(creds, null, 2));
+    return;
+  }
   const profileFile = join3(configDir, "profiles", `${profile}.json`);
   const profileDir = join3(configDir, "profiles", profile);
   if (existsSync3(profileFile)) {
@@ -25829,7 +25849,7 @@ async function getConnectorCommandHelp(name, command) {
 loadConnectorVersions();
 var server = new McpServer({
   name: "connectors",
-  version: "1.1.6"
+  version: "1.1.8"
 });
 server.registerTool("search_connectors", {
   title: "Search Connectors",
@@ -26134,11 +26154,18 @@ server.registerTool("run_connector_operation", {
   description: "Execute an API operation on a connector. Pass the connector name and CLI arguments. Use list_connector_operations first to discover available commands. Example: name='stripe', args=['products', 'list', '--limit', '5']",
   inputSchema: {
     name: exports_external.string().describe("Connector name (e.g. stripe, gmail, anthropic)"),
-    args: exports_external.array(exports_external.string()).describe("CLI arguments for the connector command (e.g. ['products', 'list', '--limit', '5'])"),
+    args: exports_external.union([exports_external.array(exports_external.string()), exports_external.string()]).describe("CLI arguments for the connector command (e.g. ['products', 'list', '--limit', '5'])"),
     format: exports_external.enum(["json", "pretty"]).optional().describe("Output format (default: json for structured parsing)"),
     timeout: exports_external.number().optional().describe("Timeout in milliseconds (default: 30000)")
   }
-}, async ({ name, args, format, timeout }) => {
+}, async ({ name, args: rawArgs, format, timeout }) => {
+  const args = typeof rawArgs === "string" ? (() => {
+    try {
+      return JSON.parse(rawArgs);
+    } catch {
+      return [rawArgs];
+    }
+  })() : rawArgs;
   const meta = getConnector(name);
   if (!meta) {
     return {

package/bin/serve.js

@@ -4878,6 +4878,13 @@ var CONNECTORS = [
     category: "Business Tools",
     tags: ["e-signature", "contracts", "digital", "documents", "legal"]
   },
+  {
+    name: "yousign",
+    displayName: "Yousign",
+    description: "eIDAS-compliant electronic signature API for EU workflows",
+    category: "Business Tools",
+    tags: ["e-signature", "eidas", "contracts", "documents", "legal", "eu"]
+  },
   {
     name: "signl4",
     displayName: "SIGNL4",
@@ -6248,6 +6255,19 @@ function saveApiKey(name, key, field) {
   const configDir = getConnectorConfigDir(name);
   const profile = getCurrentProfile(name);
   const keyField = field || guessKeyField(name);
+  if (keyField === "clientId" || keyField === "clientSecret") {
+    const credentialsFile = join3(configDir, "credentials.json");
+    mkdirSync2(configDir, { recursive: true });
+    let creds = {};
+    if (existsSync3(credentialsFile)) {
+      try {
+        creds = JSON.parse(readFileSync3(credentialsFile, "utf-8"));
+      } catch {}
+    }
+    creds[keyField] = key;
+    writeFileSync2(credentialsFile, JSON.stringify(creds, null, 2));
+    return;
+  }
   const profileFile = join3(configDir, "profiles", `${profile}.json`);
   const profileDir = join3(configDir, "profiles", profile);
   if (existsSync3(profileFile)) {

package/connectors/connect-gmail/src/api/attachments.ts

@@ -95,11 +95,19 @@ export class AttachmentsApi {
   /**
    * Download a specific attachment to disk
    */
-  async download(messageId: string, attachmentId: string, filename: string, mimeType: string): Promise<DownloadedAttachment> {
+  async download(messageId: string, attachmentId: string, filename: string, mimeType: string, outputDir?: string): Promise<DownloadedAttachment> {
     // Normalize Unicode whitespace characters in filename (e.g. non-breaking spaces from Gmail)
     const cleanFilename = filename.replace(/[\u00A0\u2000-\u200B\u202F\u205F\u3000]/g, ' ');
     const data = await this.get(messageId, attachmentId);
-    const dir = this.getAttachmentsDir(messageId);
+    let dir: string;
+    if (outputDir) {
+      if (!existsSync(outputDir)) {
+        mkdirSync(outputDir, { recursive: true });
+      }
+      dir = outputDir;
+    } else {
+      dir = this.getAttachmentsDir(messageId);
+    }
     const filepath = join(dir, cleanFilename);
 
     // Decode base64url to buffer
@@ -117,7 +125,7 @@ export class AttachmentsApi {
   /**
    * Download all attachments from a message
    */
-  async downloadAll(messageId: string): Promise<DownloadedAttachment[]> {
+  async downloadAll(messageId: string, outputDir?: string): Promise<DownloadedAttachment[]> {
     const attachments = await this.list(messageId);
     const downloaded: DownloadedAttachment[] = [];
 
@@ -126,7 +134,8 @@ export class AttachmentsApi {
         messageId,
         attachment.attachmentId,
         attachment.filename,
-        attachment.mimeType
+        attachment.mimeType,
+        outputDir
       );
       downloaded.push(result);
     }

package/connectors/connect-gmail/src/api/bulk.ts

@@ -3,6 +3,15 @@ import type { GmailMessage, GmailLabel } from '../types';
 import { MessagesApi } from './messages';
 import { LabelsApi } from './labels';
 
+/**
+ * Returns true if the value looks like a Gmail label ID rather than a label name.
+ * User-created label IDs start with "Label_". System label IDs are all-uppercase
+ * ASCII (e.g. INBOX, SENT, UNREAD, STARRED, IMPORTANT, TRASH, SPAM, CATEGORY_*).
+ */
+function isLabelId(value: string): boolean {
+  return value.startsWith('Label_') || /^[A-Z0-9_]+$/.test(value);
+}
+
 // ============================================
 // Bulk Operation Types
 // ============================================
@@ -136,19 +145,32 @@ export class BulkApi {
     const resolvedRemoveIds = [...removeLabelIds];
 
     if (addLabels.length > 0 || removeLabels.length > 0) {
-      const allLabels = await this.labels.list();
-      const labelMap = new Map(allLabels.labels.map(l => [l.name.toLowerCase(), l.id]));
+      // Lazily fetch the label list only if we have names that need resolving
+      const needsLookup = [...addLabels, ...removeLabels].some(v => !isLabelId(v));
+      let labelMap: Map<string, string> = new Map();
+      if (needsLookup) {
+        const allLabels = await this.labels.list();
+        labelMap = new Map(allLabels.labels.map(l => [l.name.toLowerCase(), l.id]));
+      }
 
-      for (const name of addLabels) {
-        const id = labelMap.get(name.toLowerCase());
-        if (id) resolvedAddIds.push(id);
-        else throw new Error(`Label not found: ${name}`);
+      for (const value of addLabels) {
+        if (isLabelId(value)) {
+          resolvedAddIds.push(value);
+        } else {
+          const id = labelMap.get(value.toLowerCase());
+          if (id) resolvedAddIds.push(id);
+          else throw new Error(`Label not found: ${value}`);
+        }
       }
 
-      for (const name of removeLabels) {
-        const id = labelMap.get(name.toLowerCase());
-        if (id) resolvedRemoveIds.push(id);
-        else throw new Error(`Label not found: ${name}`);
+      for (const value of removeLabels) {
+        if (isLabelId(value)) {
+          resolvedRemoveIds.push(value);
+        } else {
+          const id = labelMap.get(value.toLowerCase());
+          if (id) resolvedRemoveIds.push(id);
+          else throw new Error(`Label not found: ${value}`);
+        }
       }
     }
 
@@ -416,19 +438,32 @@ export class BulkApi {
     const resolvedRemoveIds = [...removeLabelIds];
 
     if (addLabels.length > 0 || removeLabels.length > 0) {
-      const allLabels = await this.labels.list();
-      const labelMap = new Map(allLabels.labels.map(l => [l.name.toLowerCase(), l.id]));
+      // Lazily fetch the label list only if we have names that need resolving
+      const needsLookup = [...addLabels, ...removeLabels].some(v => !isLabelId(v));
+      let labelMap: Map<string, string> = new Map();
+      if (needsLookup) {
+        const allLabels = await this.labels.list();
+        labelMap = new Map(allLabels.labels.map(l => [l.name.toLowerCase(), l.id]));
+      }
 
-      for (const name of addLabels) {
-        const id = labelMap.get(name.toLowerCase());
-        if (id) resolvedAddIds.push(id);
-        else throw new Error(`Label not found: ${name}`);
+      for (const value of addLabels) {
+        if (isLabelId(value)) {
+          resolvedAddIds.push(value);
+        } else {
+          const id = labelMap.get(value.toLowerCase());
+          if (id) resolvedAddIds.push(id);
+          else throw new Error(`Label not found: ${value}`);
+        }
       }
 
-      for (const name of removeLabels) {
-        const id = labelMap.get(name.toLowerCase());
-        if (id) resolvedRemoveIds.push(id);
-        else throw new Error(`Label not found: ${name}`);
+      for (const value of removeLabels) {
+        if (isLabelId(value)) {
+          resolvedRemoveIds.push(value);
+        } else {
+          const id = labelMap.get(value.toLowerCase());
+          if (id) resolvedRemoveIds.push(id);
+          else throw new Error(`Label not found: ${value}`);
+        }
       }
     }
 

package/connectors/connect-gmail/src/cli/index.ts

@@ -131,13 +131,24 @@ authCmd
         saveTokens(result.tokens);
       }
 
-      // Fetch user email and save it to the active profile
+      // Fetch user email and display name, save to the active profile
       try {
         const gmail = Gmail.create();
         const profile = await gmail.profile.get();
         const email = profile.emailAddress;
         setUserEmail(email);
         info(`Email: ${email}`);
+
+        // Try to get display name from Gmail send-as settings
+        try {
+          const displayName = await gmail.profile.getDisplayName();
+          if (displayName) {
+            setUserName(displayName);
+            info(`Name: ${displayName}`);
+          }
+        } catch {
+          // Display name fetch failed — not critical
+        }
       } catch (err) {
         // Email fetch failed but auth succeeded — tokens are saved
         warn(`Could not fetch email address: ${err}`);
@@ -542,11 +553,29 @@ messagesCmd
         if (exactMatch) {
           body = exactMatch.data;
         } else {
-          // Fallback: if looking for text/plain but only text/html exists, use that
+          // Fallback: if looking for text/plain but only text/html exists, strip HTML
           // Or if looking for text/html but only text/plain exists, use that
           const altMatch = textParts.find(p => p.mimeType.startsWith('text/'));
           if (altMatch) {
-            body = altMatch.data;
+            if (!opts.html && altMatch.mimeType === 'text/html') {
+              // Strip HTML to get readable plain text
+              body = altMatch.data
+                .replace(/<br\s*\/?>/gi, '\n')
+                .replace(/<\/p>/gi, '\n\n')
+                .replace(/<\/div>/gi, '\n')
+                .replace(/<\/li>/gi, '\n')
+                .replace(/<[^>]+>/g, '')
+                .replace(/&nbsp;/g, ' ')
+                .replace(/&amp;/g, '&')
+                .replace(/&lt;/g, '<')
+                .replace(/&gt;/g, '>')
+                .replace(/&quot;/g, '"')
+                .replace(/&#39;/g, "'")
+                .replace(/\n{3,}/g, '\n\n')
+                .trim();
+            } else {
+              body = altMatch.data;
+            }
           }
         }
       }
@@ -722,18 +751,43 @@ messagesCmd
   .requiredOption('-b, --body <body>', 'Reply body (supports markdown)')
   .option('--cc <emails>', 'CC recipients (comma-separated)')
   .option('--html', 'Send as HTML email')
+  .option('--attachment <path>', 'Attach a file (can be specified multiple times)', (val: string, prev: string[]) => prev.concat([val]), [] as string[])
   .action(async (messageId: string, opts) => {
     try {
       const gmail = requireAuth();
+
+      // Build attachments array from --attachment flags
+      type AttachmentEntry = { filename: string; mimeType: string; data: string };
+      const attachments: AttachmentEntry[] = [];
+      if (opts.attachment && (opts.attachment as string[]).length > 0) {
+        for (const attachPath of opts.attachment as string[]) {
+          const resolvedPath = resolve(attachPath);
+          if (!existsSync(resolvedPath)) {
+            error(`Attachment not found: ${attachPath}`);
+            process.exit(1);
+          }
+          const fileData = readFileSync(resolvedPath);
+          attachments.push({
+            filename: basename(resolvedPath),
+            mimeType: detectMimeType(resolvedPath),
+            data: fileData.toString('base64'),
+          });
+        }
+      }
+
       const result = await gmail.messages.reply(messageId, {
         body: opts.body,
         cc: opts.cc?.split(',').map((e: string) => e.trim()),
         isHtml: opts.html,
+        ...(attachments.length > 0 ? { attachments } : {}),
       });
 
       success(`Reply sent!`);
       info(`Message ID: ${result.id}`);
       info(`Thread ID: ${result.threadId}`);
+      if (attachments.length > 0) {
+        info(`Attachments: ${attachments.map((a) => a.filename).join(', ')}`);
+      }
     } catch (err) {
       error(String(err));
       process.exit(1);
@@ -1227,9 +1281,11 @@ attachmentsCmd
   .command('download <messageId>')
   .description('Download all attachments from a message')
   .option('-a, --attachment-id <id>', 'Download specific attachment by ID')
+  .option('-d, --dir <path>', 'Directory to save attachments (default: connector storage dir)')
   .action(async (messageId: string, opts) => {
     try {
       const gmail = requireAuth();
+      const outputDir = opts.dir ? resolve(opts.dir) : undefined;
 
       if (opts.attachmentId) {
         // Download specific attachment
@@ -1246,7 +1302,8 @@ attachmentsCmd
           messageId,
           attachment.attachmentId,
           attachment.filename,
-          attachment.mimeType
+          attachment.mimeType,
+          outputDir
         );
 
         success(`Downloaded: ${result.filename}`);
@@ -1255,7 +1312,7 @@ attachmentsCmd
       } else {
         // Download all attachments
         info('Downloading all attachments...');
-        const results = await gmail.attachments.downloadAll(messageId);
+        const results = await gmail.attachments.downloadAll(messageId, outputDir);
 
         if (results.length === 0) {
           info('No attachments found in this message');
@@ -1266,7 +1323,8 @@ attachmentsCmd
         for (const result of results) {
           info(`  • ${result.filename} (${Math.round(result.size / 1024)} KB)`);
         }
-        info(`\nSaved to: ${gmail.attachments.getStoragePath(messageId)}`);
+        const savedDir = outputDir ?? gmail.attachments.getStoragePath(messageId);
+        info(`\nSaved to: ${savedDir}`);
       }
     } catch (err) {
       error(String(err));

package/connectors/connect-googledrive/src/cli/index.ts

@@ -513,18 +513,82 @@ filesCmd
 
 filesCmd
   .command('share <fileId>')
-  .description('Share a file with a user')
-  .requiredOption('--email <email>', 'Email address to share with')
+  .description('Share a file with a user, group, domain, or make it public')
+  .option('--email <email>', 'Email address to share with (required for user/group types)')
+  .option('--type <type>', 'Permission type (user, group, domain, anyone)', 'user')
+  .option('--domain <domain>', 'Domain to share with (required for domain type)')
   .option('--role <role>', 'Permission role (reader, writer, commenter, owner)', 'reader')
   .option('--no-notify', 'Do not send notification email')
+  .option('--allow-discovery', 'Allow file discovery (for anyone/domain types)')
   .action(async (fileId: string, opts) => {
     try {
       const drive = requireAuth();
-      const permission = await drive.files.share(fileId, opts.email, opts.role as 'reader' | 'writer' | 'commenter' | 'owner', {
-        sendNotificationEmail: opts.notify !== false,
-      });
-      success('Shared with: ' + opts.email);
-      info('Role: ' + opts.role);
+      const type = opts.type as 'user' | 'group' | 'domain' | 'anyone';
+
+      const validTypes = ['user', 'group', 'domain', 'anyone'];
+      if (!validTypes.includes(type)) {
+        error('Invalid type "' + type + '". Must be one of: user, group, domain, anyone');
+        process.exit(1);
+      }
+
+      if ((type === 'user' || type === 'group') && !opts.email) {
+        error('--email is required for type "' + type + '"');
+        process.exit(1);
+      }
+
+      if (type === 'domain' && !opts.domain) {
+        error('--domain is required for type "domain"');
+        process.exit(1);
+      }
+
+      if (type === 'anyone') {
+        // Create a public link permission directly
+        const permission: Record<string, unknown> = {
+          type: 'anyone',
+          role: opts.role,
+        };
+        if (opts.allowDiscovery) {
+          permission.allowFileDiscovery = true;
+        }
+        const params: Record<string, string | number | boolean | undefined> = {
+          supportsAllDrives: true,
+          sendNotificationEmail: false,
+        };
+        await drive.getClient().post(
+          '/files/' + fileId + '/permissions',
+          permission,
+          params
+        );
+        success('File is now publicly accessible');
+        info('Role: ' + opts.role);
+        info('Type: anyone');
+        if (opts.allowDiscovery) {
+          info('Allow discovery: yes');
+        }
+      } else if (type === 'domain') {
+        const permission: Record<string, unknown> = {
+          type: 'domain',
+          role: opts.role,
+          domain: opts.domain,
+        };
+        if (opts.allowDiscovery) {
+          permission.allowFileDiscovery = true;
+        }
+        const params: Record<string, string | number | boolean | undefined> = {
+          supportsAllDrives: true,
+          sendNotificationEmail: false,
+        };
+        await drive.getClient().post('/files/' + fileId + '/permissions', permission, params);
+        success('Shared with domain: ' + opts.domain);
+        info('Role: ' + opts.role);
+      } else {
+        await drive.files.share(fileId, opts.email, opts.role as 'reader' | 'writer' | 'commenter' | 'owner', {
+          sendNotificationEmail: opts.notify !== false,
+        });
+        success('Shared with: ' + opts.email);
+        info('Role: ' + opts.role);
+        info('Type: ' + type);
+      }
     } catch (err) {
       error(String(err));
       process.exit(1);

package/connectors/connect-mercury/CLAUDE.md

@@ -75,6 +75,7 @@ API Key authentication. Credentials can be set via:
 connect-mercury accounts list
 connect-mercury accounts get <accountId>
 connect-mercury accounts balance <accountId>
+connect-mercury accounts balance-at <accountId> --date <YYYY-MM-DD>
 connect-mercury accounts statements <accountId>
 connect-mercury accounts cards <accountId>