@hasna/connectors 1.3.1 → 1.3.2

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;
+            }
           }
         }
       }

package/connectors/connect-huggingface/src/api/client.ts

@@ -124,11 +124,6 @@ export class HuggingFaceClient {
     return this.request<T>(path, { method: 'DELETE', params });
   }
 
-  /** Get the raw API key (needed by InferenceApi for direct fetch) */
-  getApiKey(): string {
-    return this.apiKey;
-  }
-
   /**
    * Get a preview of the API key (for display/debugging)
    */

package/connectors/connect-huggingface/src/api/example.ts

@@ -0,0 +1,48 @@
+import type { HuggingFaceClient } from './client';
+import type { ExampleResource, ExampleListResponse, ExampleCreateParams } from '../types';
+
+/**
+ * Example API module - demonstrates the pattern for API modules
+ * Replace with actual HuggingFace API endpoints (models, datasets, spaces, etc.)
+ */
+export class ExampleApi {
+  constructor(private readonly client: HuggingFaceClient) {}
+
+  /**
+   * List resources with optional pagination
+   */
+  async list(options?: { maxResults?: number; pageToken?: string }): Promise<ExampleListResponse> {
+    return this.client.get<ExampleListResponse>('/resources', {
+      max_results: options?.maxResults,
+      page_token: options?.pageToken,
+    });
+  }
+
+  /**
+   * Get a single resource by ID
+   */
+  async get(id: string): Promise<ExampleResource> {
+    return this.client.get<ExampleResource>(`/resources/${id}`);
+  }
+
+  /**
+   * Create a new resource
+   */
+  async create(params: ExampleCreateParams): Promise<ExampleResource> {
+    return this.client.post<ExampleResource>('/resources', params);
+  }
+
+  /**
+   * Update an existing resource
+   */
+  async update(id: string, params: Partial<ExampleCreateParams>): Promise<ExampleResource> {
+    return this.client.patch<ExampleResource>(`/resources/${id}`, params);
+  }
+
+  /**
+   * Delete a resource
+   */
+  async delete(id: string): Promise<void> {
+    await this.client.delete(`/resources/${id}`);
+  }
+}

package/connectors/connect-huggingface/src/api/index.ts

@@ -1,9 +1,6 @@
 import type { HuggingFaceConfig } from '../types';
 import { HuggingFaceClient } from './client';
-import { ModelsApi } from './models';
-import { InferenceApi } from './inference';
-import { DatasetsApi } from './datasets';
-import { SpacesApi } from './spaces';
+import { ExampleApi } from './example';
 
 /**
  * Main HuggingFace API class
@@ -11,37 +8,42 @@ import { SpacesApi } from './spaces';
 export class HuggingFace {
   private readonly client: HuggingFaceClient;
 
-  public readonly models: ModelsApi;
-  public readonly inference: InferenceApi;
-  public readonly datasets: DatasetsApi;
-  public readonly spaces: SpacesApi;
+  // API modules - add more as needed
+  public readonly example: ExampleApi;
 
   constructor(config: HuggingFaceConfig) {
     this.client = new HuggingFaceClient(config);
-    this.models = new ModelsApi(this.client);
-    this.inference = new InferenceApi(this.client);
-    this.datasets = new DatasetsApi(this.client);
-    this.spaces = new SpacesApi(this.client);
+    this.example = new ExampleApi(this.client);
   }
 
+  /**
+   * Create a client from environment variables
+   * Looks for HUGGINGFACE_API_KEY or HF_TOKEN
+   */
   static fromEnv(): HuggingFace {
     const apiKey = process.env.HUGGINGFACE_API_KEY || process.env.HF_TOKEN;
     const apiSecret = process.env.HUGGINGFACE_API_SECRET;
-    if (!apiKey) throw new Error('HUGGINGFACE_API_KEY or HF_TOKEN environment variable is required');
+
+    if (!apiKey) {
+      throw new Error('HUGGINGFACE_API_KEY or HF_TOKEN environment variable is required');
+    }
     return new HuggingFace({ apiKey, apiSecret });
   }
 
+  /**
+   * Get a preview of the API key (for debugging)
+   */
   getApiKeyPreview(): string {
     return this.client.getApiKeyPreview();
   }
 
+  /**
+   * Get the underlying client for direct API access
+   */
   getClient(): HuggingFaceClient {
     return this.client;
   }
 }
 
 export { HuggingFaceClient } from './client';
-export { ModelsApi } from './models';
-export { InferenceApi } from './inference';
-export { DatasetsApi } from './datasets';
-export { SpacesApi } from './spaces';
+export { ExampleApi } from './example';

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

@@ -188,167 +188,55 @@ configCmd
   });
 
 // ============================================
-// Models Commands
+// Example API Commands - Replace with HuggingFace API commands
 // ============================================
-const modelsCmd = program.command('models').description('Search and browse HuggingFace models');
+const exampleCmd = program
+  .command('example')
+  .description('Example API commands (replace with HuggingFace commands)');
 
-modelsCmd
-  .command('search')
-  .description('Search models')
-  .argument('[query]', 'Search query')
-  .option('--task <task>', 'Filter by task (text-generation, text2text-generation, etc)')
-  .option('--library <lib>', 'Filter by library (transformers, gguf, pytorch)')
-  .option('--author <author>', 'Filter by author')
-  .option('--sort <field>', 'Sort by: likes, downloads, trending, lastModified', 'trending')
-  .option('--limit <n>', 'Max results', '20')
-  .action(async (query, opts) => {
-    try {
-      const client = getClient();
-      const results = await client.models.search({
-        search: query, filter: opts.task, library: opts.library,
-        author: opts.author, sort: opts.sort, limit: parseInt(opts.limit),
-      });
-      print(results.map(m => ({ id: m.id, task: m.pipeline_tag, library: m.library_name, downloads: m.downloads, likes: m.likes })), getFormat(modelsCmd));
-    } catch (err) { error(String(err)); process.exit(1); }
-  });
-
-modelsCmd
-  .command('get <id>')
-  .description('Get model details (e.g. meta-llama/Meta-Llama-3-8B)')
-  .action(async (id) => {
-    try {
-      const client = getClient();
-      const result = await client.models.get(id);
-      print(result, getFormat(modelsCmd));
-    } catch (err) { error(String(err)); process.exit(1); }
-  });
-
-modelsCmd
-  .command('files <id>')
-  .description('List files in a model repo')
-  .action(async (id) => {
-    try {
-      const client = getClient();
-      const files = await client.models.files(id);
-      print(files.map(f => ({ name: f.rfilename, size: f.lfs?.size ?? f.size ?? null })), getFormat(modelsCmd));
-    } catch (err) { error(String(err)); process.exit(1); }
-  });
-
-// ============================================
-// Inference Commands
-// ============================================
-const inferCmd = program.command('inference').description('Run model inference via HF Inference API');
-
-inferCmd
-  .command('text-generation <model>')
-  .description('Generate text from a prompt')
-  .requiredOption('--prompt <text>', 'Input prompt')
-  .option('--max-tokens <n>', 'Max new tokens', '256')
-  .option('--temperature <t>', 'Temperature', '0.7')
-  .action(async (model, opts) => {
-    try {
-      const client = getClient();
-      const results = await client.inference.textGeneration(model, opts.prompt, {
-        max_new_tokens: parseInt(opts.maxTokens), temperature: parseFloat(opts.temperature),
-      });
-      print(results, getFormat(inferCmd));
-    } catch (err) { error(String(err)); process.exit(1); }
-  });
-
-inferCmd
-  .command('chat <model>')
-  .description('Chat completion (for chat models)')
-  .requiredOption('--messages <json>', 'Messages JSON array')
-  .option('--max-tokens <n>', 'Max new tokens', '256')
-  .option('--temperature <t>', 'Temperature', '0.7')
-  .action(async (model, opts) => {
-    try {
-      const messages = JSON.parse(opts.messages);
-      const client = getClient();
-      const result = await client.inference.chat(model, messages, {
-        max_new_tokens: parseInt(opts.maxTokens), temperature: parseFloat(opts.temperature),
-      });
-      print(result, getFormat(inferCmd));
-    } catch (err) { error(String(err)); process.exit(1); }
-  });
-
-// ============================================
-// Datasets Commands
-// ============================================
-const datasetsCmd = program.command('datasets').description('Search and browse HuggingFace datasets');
-
-datasetsCmd
-  .command('search')
-  .description('Search datasets')
-  .argument('[query]', 'Search query')
-  .option('--author <author>', 'Filter by author')
-  .option('--sort <field>', 'Sort by: likes, downloads, trending', 'trending')
-  .option('--limit <n>', 'Max results', '20')
-  .action(async (query, opts) => {
+exampleCmd
+  .command('list')
+  .description('List resources')
+  .option('-n, --max <number>', 'Maximum results', '10')
+  .action(async (opts) => {
     try {
       const client = getClient();
-      const results = await client.datasets.search({
-        search: query, author: opts.author, sort: opts.sort, limit: parseInt(opts.limit),
-      });
-      print(results.map(d => ({ id: d.id, downloads: d.downloads, likes: d.likes, tags: d.tags?.slice(0, 5) })), getFormat(datasetsCmd));
-    } catch (err) { error(String(err)); process.exit(1); }
+      const result = await client.example.list({ maxResults: parseInt(opts.max) });
+      print(result, getFormat(exampleCmd));
+    } catch (err) {
+      error(String(err));
+      process.exit(1);
+    }
   });
 
-datasetsCmd
+exampleCmd
   .command('get <id>')
-  .description('Get dataset details')
-  .action(async (id) => {
-    try {
-      const client = getClient();
-      const result = await client.datasets.get(id);
-      print(result, getFormat(datasetsCmd));
-    } catch (err) { error(String(err)); process.exit(1); }
-  });
-
-datasetsCmd
-  .command('preview <id>')
-  .description('Preview first N rows of a dataset')
-  .option('--split <split>', 'Dataset split', 'train')
-  .option('--rows <n>', 'Number of rows', '10')
-  .action(async (id, opts) => {
+  .description('Get a resource by ID')
+  .action(async (id: string) => {
     try {
       const client = getClient();
-      const result = await client.datasets.preview(id, 'default', opts.split, parseInt(opts.rows));
-      print(result, getFormat(datasetsCmd));
-    } catch (err) { error(String(err)); process.exit(1); }
-  });
-
-// ============================================
-// Spaces Commands
-// ============================================
-const spacesCmd = program.command('spaces').description('Search and browse HuggingFace Spaces');
-
-spacesCmd
-  .command('search')
-  .description('Search spaces')
-  .argument('[query]', 'Search query')
-  .option('--author <author>', 'Filter by author')
-  .option('--sort <field>', 'Sort by: likes, trending', 'trending')
-  .option('--limit <n>', 'Max results', '20')
-  .action(async (query, opts) => {
-    try {
-      const client = getClient();
-      const results = await client.spaces.search({
-        search: query, author: opts.author, sort: opts.sort, limit: parseInt(opts.limit),
-      });
-      print(results.map(s => ({ id: s.id, sdk: s.sdk, likes: s.likes })), getFormat(spacesCmd));
-    } catch (err) { error(String(err)); process.exit(1); }
+      const result = await client.example.get(id);
+      print(result, getFormat(exampleCmd));
+    } catch (err) {
+      error(String(err));
+      process.exit(1);
+    }
   });
 
-spacesCmd
-  .command('get <id>')
-  .description('Get space details')
-  .action(async (id) => {
+exampleCmd
+  .command('create')
+  .description('Create a new resource')
+  .requiredOption('-n, --name <name>', 'Resource name')
+  .action(async (opts) => {
     try {
       const client = getClient();
-      const result = await client.spaces.get(id);
-      print(result, getFormat(spacesCmd));
-    } catch (err) { error(String(err)); process.exit(1); }
+      const result = await client.example.create({ name: opts.name });
+      success('Resource created!');
+      print(result, getFormat(exampleCmd));
+    } catch (err) {
+      error(String(err));
+      process.exit(1);
+    }
   });
 
 // Parse and execute

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>
 

package/connectors/connect-openai/src/api/images.ts

@@ -5,20 +5,8 @@ import type {
   ImageOptions,
 } from '../types';
 
-/** Models that use the new gpt-image API (different params than DALL-E) */
-const GPT_IMAGE_MODELS = ['gpt-image-1'];
-
-function isGptImage(model: string): boolean {
-  return GPT_IMAGE_MODELS.some((m) => model.startsWith(m));
-}
-
 /**
- * Images API — supports both DALL-E 3 and gpt-image-1
- *
- * gpt-image-1 differences:
- *   - Uses `output_format` instead of `response_format`
- *   - Does NOT support `style` parameter
- *   - Does NOT support `response_format` parameter
+ * Images API (DALL-E)
  */
 export class ImagesApi {
   constructor(private readonly client: OpenAIClient) {}
@@ -30,29 +18,13 @@ export class ImagesApi {
     prompt: string,
     options: ImageOptions = {}
   ): Promise<ImageResponse> {
-    const model = options.model || 'dall-e-3';
-
-    if (isGptImage(model)) {
-      // gpt-image-1: different parameter set
-      const request: Record<string, unknown> = {
-        model,
-        prompt,
-        n: options.n || 1,
-      };
-      if (options.size !== undefined) request.size = options.size;
-      if (options.quality !== undefined) request.quality = options.quality;
-      // gpt-image-1 uses output_format, not response_format. No style param.
-      request.output_format = 'url';
-      return this.client.post<ImageResponse>('/images/generations', request);
-    }
-
-    // DALL-E 3: original parameter set
     const request: ImageGenerateRequest = {
-      model,
+      model: options.model || 'dall-e-3',
       prompt,
       n: options.n || 1,
       response_format: 'url',
     };
+
     if (options.size !== undefined) request.size = options.size;
     if (options.quality !== undefined) request.quality = options.quality;
     if (options.style !== undefined) request.style = options.style;
@@ -82,38 +54,22 @@ export class ImagesApi {
     prompt: string,
     options: Omit<ImageOptions, 'n'> = {}
   ): Promise<string> {
-    const model = options.model || 'dall-e-3';
-
-    if (isGptImage(model)) {
-      const request: Record<string, unknown> = {
-        model,
-        prompt,
-        n: 1,
-        output_format: 'b64_json',
-      };
-      if (options.size !== undefined) request.size = options.size;
-      if (options.quality !== undefined) request.quality = options.quality;
-
-      const response = await this.client.post<ImageResponse>('/images/generations', request);
-      const b64 = response.data[0]?.b64_json;
-      if (!b64) throw new Error('No image data in response');
-      return b64;
-    }
-
-    // DALL-E 3
     const request: ImageGenerateRequest = {
-      model,
+      model: options.model || 'dall-e-3',
       prompt,
       n: 1,
       response_format: 'b64_json',
     };
+
     if (options.size !== undefined) request.size = options.size;
     if (options.quality !== undefined) request.quality = options.quality;
     if (options.style !== undefined) request.style = options.style;
 
     const response = await this.client.post<ImageResponse>('/images/generations', request);
     const b64 = response.data[0]?.b64_json;
-    if (!b64) throw new Error('No image data in response');
+    if (!b64) {
+      throw new Error('No image data in response');
+    }
     return b64;
   }
 }

package/connectors/connect-yousign/CLAUDE.md

@@ -0,0 +1,48 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code when working with this repository.
+
+## Project Overview
+
+connect-yousign is a TypeScript CLI and library for the Yousign electronic signature API v3. It provides eIDAS-compliant digital signature workflows — create signature requests, upload documents, add signers, and track audit trails.
+
+## Build & Run Commands
+
+```bash
+bun install
+bun run dev
+bun run build
+bun run typecheck
+```
+
+## Authentication
+
+Bearer token (API key). Set via:
+- Environment variable: `YOUSIGN_API_KEY`
+- Profile config: `connect-yousign config set-key <key>`
+
+## API Environments
+
+| Environment | Base URL |
+|---|---|
+| Sandbox | `https://api.sandbox.yousign.app/v3` |
+| Production | `https://api.yousign.app/v3` |
+
+Default: sandbox. Use `--production` flag or set `YOUSIGN_ENV=production`.
+
+## Environment Variables
+
+| Variable | Description |
+|---|---|
+| `YOUSIGN_API_KEY` | API key (Bearer token) |
+| `YOUSIGN_ENV` | `sandbox` (default) or `production` |
+
+## Data Storage
+
+```
+~/.connectors/connect-yousign/
+├── current_profile
+└── profiles/
+    ├── default.json
+    └── {name}.json
+```

package/connectors/connect-yousign/bun.lock

@@ -0,0 +1,32 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "@hasna/connect-yousign",
+      "dependencies": {
+        "chalk": "^5.3.0",
+        "commander": "^12.1.0",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+        "typescript": "^5",
+      },
+    },
+  },
+  "packages": {
+    "@types/bun": ["@types/bun@1.3.10", "", { "dependencies": { "bun-types": "1.3.10" } }, "sha512-0+rlrUrOrTSskibryHbvQkDOWRJwJZqZlxrUs1u4oOoTln8+WIXBPmAuCF35SWB2z4Zl3E84Nl/D0P7803nigQ=="],
+
+    "@types/node": ["@types/node@25.5.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw=="],
+
+    "bun-types": ["bun-types@1.3.10", "", { "dependencies": { "@types/node": "*" } }, "sha512-tcpfCCl6XWo6nCVnpcVrxQ+9AYN1iqMIzgrSKYMB/fjLtV2eyAVEg7AxQJuCq/26R6HpKWykQXuSOq/21RYcbg=="],
+
+    "chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
+
+    "commander": ["commander@12.1.0", "", {}, "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
+  }
+}

package/connectors/connect-yousign/node_modules/@types/bun/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/connectors/connect-yousign/node_modules/@types/bun/README.md

@@ -0,0 +1,20 @@
+# Installation
+> `npm install --save @types/bun`
+
+# Summary
+This package contains type definitions for bun (https://bun.com).
+
+# Details
+Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/bun.
+## [index.d.ts](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/bun/index.d.ts)
+````ts
+/// <reference types="bun-types" />
+
+````
+
+### Additional Details
+ * Last updated: Mon, 02 Mar 2026 23:04:36 GMT
+ * Dependencies: [bun-types](https://npmjs.com/package/bun-types)
+
+# Credits
+These definitions were written by [Jarred Sumner](https://github.com/Jarred-Sumner), [Robobun](https://github.com/robobun), [Dylan Conway](https://github.com/dylan-conway), [Ciro Spaciari](https://github.com/cirospaciari), [Sosuke Suzuki](https://github.com/sosukesuzuki), and [Alistair Smith](https://github.com/alii).

package/connectors/connect-yousign/node_modules/@types/bun/index.d.ts

@@ -0,0 +1 @@
+/// <reference types="bun-types" />