@hasna/connectors 1.1.6 → 1.1.8

package/connectors/connect-yousign/src/types/index.ts

@@ -0,0 +1,275 @@
+// Yousign API v3 Types
+
+export interface YouSignConfig {
+  apiKey: string;
+  environment?: 'sandbox' | 'production';
+}
+
+// ============================================
+// Signature Requests
+// ============================================
+
+export type SignatureRequestStatus =
+  | 'draft'
+  | 'ongoing'
+  | 'done'
+  | 'deleted'
+  | 'expired'
+  | 'canceled'
+  | 'approval'
+  | 'rejected';
+
+export type SignatureRequestDeliveryMode = 'email' | 'none';
+export type SignatureLevel = 'electronic_signature' | 'advanced_electronic_signature' | 'qualified_electronic_signature';
+
+export interface SignatureRequest {
+  id: string;
+  status: SignatureRequestStatus;
+  name: string;
+  delivery_mode: SignatureRequestDeliveryMode;
+  created_at: string;
+  updated_at: string;
+  expiration_date?: string;
+  timezone?: string;
+  ordered_signers: boolean;
+  reminder_settings?: ReminderSettings;
+  signers?: Signer[];
+  approvers?: Approver[];
+  documents?: Document[];
+  external_id?: string;
+  source?: string;
+  sender?: Sender;
+  audit_trail_locale?: string;
+  signers_allowed_to_decline?: boolean;
+}
+
+export interface ReminderSettings {
+  interval_in_days: number;
+  max_occurrences: number;
+}
+
+export interface Sender {
+  id: string;
+  email: string;
+  first_name: string;
+  last_name: string;
+}
+
+export interface CreateSignatureRequestOptions {
+  name: string;
+  delivery_mode: SignatureRequestDeliveryMode;
+  timezone?: string;
+  ordered_signers?: boolean;
+  reminder_settings?: ReminderSettings;
+  expiration_date?: string;
+  template_id?: string;
+  external_id?: string;
+  custom_experience_id?: string;
+  signers_allowed_to_decline?: boolean;
+  audit_trail_locale?: string;
+  email_custom_note?: string;
+}
+
+export interface UpdateSignatureRequestOptions {
+  name?: string;
+  delivery_mode?: SignatureRequestDeliveryMode;
+  timezone?: string;
+  ordered_signers?: boolean;
+  reminder_settings?: ReminderSettings;
+  expiration_date?: string;
+  external_id?: string;
+  signers_allowed_to_decline?: boolean;
+  email_custom_note?: string;
+}
+
+// ============================================
+// Documents
+// ============================================
+
+export interface Document {
+  id: string;
+  filename: string;
+  nature: 'signable_document' | 'attachment';
+  content_type: string;
+  sha256: string;
+  created_at: string;
+  total_pages?: number;
+  is_protected?: boolean;
+  initials?: InitialsOptions;
+  signature_level?: SignatureLevel;
+  signature_authentication_mode?: string;
+  parse_anchors?: boolean;
+}
+
+export interface InitialsOptions {
+  enabled: boolean;
+  side?: 'left' | 'right';
+}
+
+// ============================================
+// Signers
+// ============================================
+
+export type SignerStatus = 'initiated' | 'notified' | 'verified' | 'processing' | 'consent_given' | 'signed' | 'aborted' | 'error';
+
+export interface Signer {
+  id: string;
+  status: SignerStatus;
+  info: SignerInfo;
+  fields?: SignatureField[];
+  signature_level?: SignatureLevel;
+  signature_authentication_mode?: string;
+  redirect_urls?: RedirectUrls;
+  delivery_mode?: SignatureRequestDeliveryMode;
+  identification_attestation_id?: string;
+  created_at?: string;
+  updated_at?: string;
+}
+
+export interface SignerInfo {
+  first_name: string;
+  last_name: string;
+  email: string;
+  phone_number?: string;
+  locale?: string;
+}
+
+export interface RedirectUrls {
+  success?: string;
+  error?: string;
+}
+
+export interface AddSignerOptions {
+  info: SignerInfo;
+  signature_level?: SignatureLevel;
+  signature_authentication_mode?: string;
+  fields?: CreateSignatureFieldOptions[];
+  redirect_urls?: RedirectUrls;
+  delivery_mode?: SignatureRequestDeliveryMode;
+}
+
+// ============================================
+// Approvers
+// ============================================
+
+export interface Approver {
+  id: string;
+  status: string;
+  info: SignerInfo;
+  created_at?: string;
+  updated_at?: string;
+}
+
+export interface AddApproverOptions {
+  info: SignerInfo;
+  redirect_urls?: RedirectUrls;
+}
+
+// ============================================
+// Signature Fields
+// ============================================
+
+export type FieldType = 'signature' | 'mention' | 'text' | 'checkbox' | 'radio_group';
+
+export interface SignatureField {
+  id: string;
+  type: FieldType;
+  document_id: string;
+  page: number;
+  x: number;
+  y: number;
+  width?: number;
+  height?: number;
+  optional?: boolean;
+  mention?: string;
+}
+
+export interface CreateSignatureFieldOptions {
+  type: FieldType;
+  document_id: string;
+  page: number;
+  x: number;
+  y: number;
+  width?: number;
+  height?: number;
+  optional?: boolean;
+  mention?: string;
+}
+
+// ============================================
+// Audit Trail
+// ============================================
+
+export interface AuditTrail {
+  signature_request_id: string;
+  signatures: AuditTrailSignature[];
+}
+
+export interface AuditTrailSignature {
+  signer_id: string;
+  signed_at: string;
+  ip_address?: string;
+  user_agent?: string;
+  location?: string;
+}
+
+// ============================================
+// Webhooks
+// ============================================
+
+export type WebhookEvent =
+  | 'signature_request.done'
+  | 'signature_request.expired'
+  | 'signature_request.canceled'
+  | 'signature_request.declined'
+  | 'signer.notified'
+  | 'signer.done';
+
+export interface Webhook {
+  id: string;
+  endpoint: string;
+  description?: string;
+  subscriptions: WebhookEvent[];
+  secret?: string;
+  created_at: string;
+  updated_at: string;
+  is_enabled?: boolean;
+  auto_retry?: boolean;
+  sandbox?: boolean;
+}
+
+export interface CreateWebhookOptions {
+  endpoint: string;
+  description?: string;
+  subscriptions: WebhookEvent[];
+  secret?: string;
+  sandbox?: boolean;
+  auto_retry?: boolean;
+}
+
+// ============================================
+// Pagination
+// ============================================
+
+export interface PaginatedResponse<T> {
+  data: T[];
+  meta: {
+    next_cursor?: string;
+    has_more: boolean;
+  };
+}
+
+// ============================================
+// Errors
+// ============================================
+
+export class YouSignApiError extends Error {
+  constructor(
+    public readonly status: number,
+    public readonly statusText: string,
+    public readonly body: unknown
+  ) {
+    super(`Yousign API error ${status} ${statusText}: ${JSON.stringify(body)}`);
+    this.name = 'YouSignApiError';
+  }
+}

package/connectors/connect-yousign/src/utils/config.ts

@@ -0,0 +1,121 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+const CONNECTOR_NAME = 'connect-yousign';
+const DEFAULT_PROFILE = 'default';
+
+export interface ProfileConfig {
+  apiKey?: string;
+  environment?: 'sandbox' | 'production';
+}
+
+let profileOverride: string | undefined;
+
+const CONFIG_DIR = join(homedir(), '.connectors', CONNECTOR_NAME);
+const PROFILES_DIR = join(CONFIG_DIR, 'profiles');
+const CURRENT_PROFILE_FILE = join(CONFIG_DIR, 'current_profile');
+
+export function setProfileOverride(profile: string | undefined): void {
+  profileOverride = profile;
+}
+
+export function ensureConfigDir(): void {
+  if (!existsSync(CONFIG_DIR)) mkdirSync(CONFIG_DIR, { recursive: true });
+  if (!existsSync(PROFILES_DIR)) mkdirSync(PROFILES_DIR, { recursive: true });
+}
+
+function getProfilePath(profile: string): string {
+  return join(PROFILES_DIR, `${profile}.json`);
+}
+
+export function getCurrentProfile(): string {
+  if (profileOverride) return profileOverride;
+  ensureConfigDir();
+  if (existsSync(CURRENT_PROFILE_FILE)) {
+    try {
+      const profile = readFileSync(CURRENT_PROFILE_FILE, 'utf-8').trim();
+      if (profile && profileExists(profile)) return profile;
+    } catch { /* fall through */ }
+  }
+  return DEFAULT_PROFILE;
+}
+
+export function setCurrentProfile(profile: string): void {
+  ensureConfigDir();
+  if (!profileExists(profile) && profile !== DEFAULT_PROFILE) {
+    throw new Error(`Profile "${profile}" does not exist`);
+  }
+  writeFileSync(CURRENT_PROFILE_FILE, profile);
+}
+
+export function profileExists(profile: string): boolean {
+  return existsSync(getProfilePath(profile));
+}
+
+export function listProfiles(): string[] {
+  ensureConfigDir();
+  if (!existsSync(PROFILES_DIR)) return [];
+  return readdirSync(PROFILES_DIR).filter(f => f.endsWith('.json')).map(f => f.replace('.json', '')).sort();
+}
+
+export function createProfile(profile: string, config: ProfileConfig = {}): boolean {
+  ensureConfigDir();
+  if (profileExists(profile)) return false;
+  if (!/^[a-zA-Z0-9_-]+$/.test(profile)) {
+    throw new Error('Profile name can only contain letters, numbers, hyphens, and underscores');
+  }
+  writeFileSync(getProfilePath(profile), JSON.stringify(config, null, 2));
+  return true;
+}
+
+export function deleteProfile(profile: string): boolean {
+  if (profile === DEFAULT_PROFILE) return false;
+  if (!profileExists(profile)) return false;
+  if (getCurrentProfile() === profile) setCurrentProfile(DEFAULT_PROFILE);
+  rmSync(getProfilePath(profile));
+  return true;
+}
+
+export function loadProfile(profile?: string): ProfileConfig {
+  ensureConfigDir();
+  const name = profile || getCurrentProfile();
+  const path = getProfilePath(name);
+  if (!existsSync(path)) return {};
+  try {
+    return JSON.parse(readFileSync(path, 'utf-8')) as ProfileConfig;
+  } catch { return {}; }
+}
+
+export function saveProfile(config: ProfileConfig, profile?: string): void {
+  ensureConfigDir();
+  const name = profile || getCurrentProfile();
+  writeFileSync(getProfilePath(name), JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+
+export function clearConfig(profile?: string): void {
+  saveProfile({}, profile);
+}
+
+export function getApiKey(): string | undefined {
+  return process.env.YOUSIGN_API_KEY || loadProfile().apiKey;
+}
+
+export function setApiKey(key: string): void {
+  const config = loadProfile();
+  config.apiKey = key;
+  saveProfile(config);
+}
+
+export function getEnvironment(): 'sandbox' | 'production' {
+  const envVar = process.env.YOUSIGN_ENV;
+  if (envVar === 'production') return 'production';
+  if (envVar === 'sandbox') return 'sandbox';
+  return loadProfile().environment || 'sandbox';
+}
+
+export function setEnvironment(env: 'sandbox' | 'production'): void {
+  const config = loadProfile();
+  config.environment = env;
+  saveProfile(config);
+}

package/connectors/connect-yousign/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "types": ["bun-types"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "bin"]
+}

package/dist/index.js

@@ -4890,6 +4890,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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {