@hasna/connectors 1.3.23 → 1.3.25

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

@@ -0,0 +1,258 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { IMessage } from '../api/index';
+import {
+  getBridgeUrl,
+  setBridgeUrl,
+  setApiKey,
+  setDeviceId,
+  getCurrentProfile,
+  setCurrentProfile,
+  listProfiles,
+  createProfile,
+  deleteProfile,
+  loadProfile,
+  getConfigDir,
+} from '../utils/config';
+import { output } from '../utils/output';
+
+const program = new Command();
+
+program
+  .name('connect-imessage')
+  .description('iMessage connector CLI - bridge-first iMessage transport')
+  .version('0.0.1')
+  .option('-p, --profile <name>', 'Profile to use')
+  .option('-f, --format <format>', 'Output format: json, pretty', 'pretty');
+
+// ============================================
+// Profile
+// ============================================
+
+const profileCmd = program.command('profile').description('Manage profiles');
+
+profileCmd
+  .command('list')
+  .description('List all profiles')
+  .action(() => {
+    const profiles = listProfiles();
+    const current = getCurrentProfile();
+    for (const name of profiles) {
+      const marker = name === current ? chalk.green('* ') : '  ';
+      console.log(marker + name);
+    }
+    if (profiles.length === 0) {
+      console.log(chalk.dim('No profiles found'));
+    }
+  });
+
+profileCmd
+  .command('create <name>')
+  .description('Create a new profile')
+  .action((name: string) => {
+    createProfile(name);
+    console.log(chalk.green('Created profile: ' + name));
+  });
+
+profileCmd
+  .command('delete <name>')
+  .description('Delete a profile')
+  .action((name: string) => {
+    if (deleteProfile(name)) {
+      console.log(chalk.green('Deleted profile: ' + name));
+    } else {
+      console.log(chalk.red('Failed to delete profile: ' + name));
+    }
+  });
+
+profileCmd
+  .command('use <name>')
+  .description('Switch to a profile')
+  .action((name: string) => {
+    setCurrentProfile(name);
+    console.log(chalk.green('Now using profile: ' + name));
+  });
+
+// ============================================
+// Config
+// ============================================
+
+const configCmd = program.command('config').description('Configure settings');
+
+configCmd
+  .command('set <key> <value>')
+  .description('Set a config value (bridgeUrl, apiKey, deviceId)')
+  .action((key: string, value: string) => {
+    if (key === 'bridgeUrl') setBridgeUrl(value);
+    else if (key === 'apiKey') setApiKey(value);
+    else if (key === 'deviceId') setDeviceId(value);
+    else {
+      console.log(chalk.red('Unknown key: ' + key));
+      process.exit(1);
+    }
+    console.log(chalk.green('Set ' + key));
+  });
+
+configCmd
+  .command('show')
+  .description('Show current configuration')
+  .action(() => {
+    const config = loadProfile();
+    const profile = getCurrentProfile();
+    console.log(chalk.bold('Profile:'), profile);
+    console.log(chalk.bold('Config dir:'), getConfigDir());
+    console.log('');
+    console.log(chalk.bold('Settings:'));
+    console.log('  bridgeUrl:', config.bridgeUrl || '(not set)');
+    console.log('  apiKey:', config.apiKey ? '****' : '(not set)');
+    console.log('  deviceId:', config.deviceId || '(not set)');
+  });
+
+// ============================================
+// Health
+// ============================================
+
+program
+  .command('health')
+  .description('Check bridge health')
+  .action(async () => {
+    const client = createClient();
+    try {
+      const health = await client.health.check();
+      output(health, getFormat());
+    } catch (error) {
+      console.log(chalk.red('Health check failed: ' + (error as Error).message));
+      process.exit(1);
+    }
+  });
+
+// ============================================
+// Conversations
+// ============================================
+
+const convCmd = program.command('conversation').description('Manage conversations');
+
+convCmd
+  .command('list')
+  .description('List conversations')
+  .option('-l, --limit <n>', 'Max conversations to return')
+  .action(async (opts: { limit?: string }) => {
+    const client = createClient();
+    try {
+      const convs = await client.conversations.list({
+        limit: opts.limit ? parseInt(opts.limit) : undefined,
+      });
+      output(convs, getFormat());
+    } catch (error) {
+      console.log(chalk.red('Failed to list conversations: ' + (error as Error).message));
+      process.exit(1);
+    }
+  });
+
+convCmd
+  .command('get <chatGuid>')
+  .description('Get a conversation by GUID')
+  .action(async (chatGuid: string) => {
+    const client = createClient();
+    try {
+      const conv = await client.conversations.get(chatGuid);
+      output(conv, getFormat());
+    } catch (error) {
+      console.log(chalk.red('Failed to get conversation: ' + (error as Error).message));
+      process.exit(1);
+    }
+  });
+
+// ============================================
+// Messages
+// ============================================
+
+const msgCmd = program.command('message').description('Manage messages');
+
+msgCmd
+  .command('list <chatGuid>')
+  .description('List messages in a conversation')
+  .option('-l, --limit <n>', 'Max messages to return')
+  .action(async (chatGuid: string, opts: { limit?: string }) => {
+    const client = createClient();
+    try {
+      const msgs = await client.messages.list({
+        chatGuid,
+        limit: opts.limit ? parseInt(opts.limit) : undefined,
+      });
+      output(msgs, getFormat());
+    } catch (error) {
+      console.log(chalk.red('Failed to list messages: ' + (error as Error).message));
+      process.exit(1);
+    }
+  });
+
+msgCmd
+  .command('send')
+  .description('Send a message')
+  .requiredOption('-r, --recipient <handle>', 'Recipient handle or chat GUID')
+  .requiredOption('-t, --text <text>', 'Message text')
+  .action(async (opts: { recipient: string; text: string }) => {
+    const client = createClient();
+    try {
+      const msg = await client.messages.send({
+        chatGuid: opts.recipient.includes('chat=') ? opts.recipient : undefined,
+        recipient: opts.recipient.includes('chat=') ? undefined : opts.recipient,
+        text: opts.text,
+      });
+      output(msg, getFormat());
+    } catch (error) {
+      console.log(chalk.red('Failed to send message: ' + (error as Error).message));
+      process.exit(1);
+    }
+  });
+
+msgCmd
+  .command('reply <messageGuid>')
+  .description('Reply to a specific message')
+  .requiredOption('-t, --text <text>', 'Reply text')
+  .action(async (messageGuid: string, opts: { text: string }) => {
+    const client = createClient();
+    try {
+      const msg = await client.messages.reply(messageGuid, {
+        text: opts.text,
+        selectedMessageGuid: messageGuid,
+      });
+      output(msg, getFormat());
+    } catch (error) {
+      console.log(chalk.red('Failed to reply: ' + (error as Error).message));
+      process.exit(1);
+    }
+  });
+
+// ============================================
+// Helpers
+// ============================================
+
+function createClient(): IMessage {
+  const bridgeUrl = getBridgeUrl();
+  if (!bridgeUrl) {
+    console.log(chalk.red('Error: bridgeUrl not configured'));
+    console.log('  Set it with: connect-imessage config set bridgeUrl <url>');
+    console.log('  Or set IMESSAGE_BRIDGE_URL env var');
+    process.exit(1);
+  }
+
+  return new IMessage({
+    bridgeUrl,
+    apiKey: process.env.IMESSAGE_API_KEY,
+    deviceId: process.env.IMESSAGE_DEVICE_ID,
+  });
+}
+
+function getFormat(): 'json' | 'pretty' {
+  const format = program.opts().format;
+  return format === 'json' ? 'json' : 'pretty';
+}
+
+// Parse async
+program.parseAsync().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/connectors/connect-imessage/src/index.ts

@@ -0,0 +1,26 @@
+// iMessage Connector
+// TypeScript wrapper for iMessage via bridge API
+
+export { IMessage } from './api';
+export * from './types';
+
+// Re-export individual API classes for advanced usage
+export { ImessageClient, HealthApi, ConversationsApi, MessagesApi } from './api';
+
+// Export config utilities
+export {
+  getBridgeUrl,
+  getApiKey,
+  getDeviceId,
+  setBridgeUrl,
+  setApiKey,
+  setDeviceId,
+  getCurrentProfile,
+  setCurrentProfile,
+  listProfiles,
+  createProfile,
+  deleteProfile,
+  loadProfile,
+  saveProfile,
+  clearConfig,
+} from './utils/config';

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

@@ -0,0 +1,134 @@
+// iMessage Connector Types
+
+// ============================================
+// Configuration
+// ============================================
+
+export interface IMessageConfig {
+  bridgeUrl: string;
+  apiKey?: string;
+  deviceId?: string;
+}
+
+// ============================================
+// Common Types
+// ============================================
+
+export type OutputFormat = 'json' | 'pretty';
+
+// ============================================
+// Health Types
+// ============================================
+
+export interface IMessageHealth {
+  status: 'healthy' | 'degraded' | 'unhealthy';
+  bridge: {
+    reachable: boolean;
+    version?: string;
+    platform?: string;
+    lastSeen?: string;
+  };
+  imessage: {
+    signedIn: boolean;
+    account?: string;
+  };
+  timestamp: string;
+}
+
+// ============================================
+// Conversation Types
+// ============================================
+
+export interface IMessageConversation {
+  id: string;
+  chatIdentifier: string;
+  displayName: string;
+  type: 'single' | 'group';
+  participants: IMessageParticipant[];
+  lastMessage?: IMessagePreview;
+  unreadCount?: number;
+  createdDate?: string;
+  lastMessageDate?: string;
+}
+
+export interface IMessageParticipant {
+  handle: string;
+  name?: string;
+  isMe: boolean;
+}
+
+export interface IMessagePreview {
+  text: string;
+  fromMe: boolean;
+  date: string;
+}
+
+// ============================================
+// Message Types
+// ============================================
+
+export interface IMessage {
+  guid: string;
+  chatGuid: string;
+  text?: string;
+  attachments?: IMessageAttachment[];
+  fromMe: boolean;
+  handle?: string;
+  displayName?: string;
+  date: string;
+  dateRead?: string;
+  dateDelivered?: string;
+  error?: number;
+  isForward: boolean;
+  subject?: string;
+  threadOriginatorGuid?: string;
+}
+
+export interface IMessageAttachment {
+  guid: string;
+  mimeType: string;
+  fileName?: string;
+  transferState?: string;
+  totalBytes?: number;
+  transferredBytes?: number;
+}
+
+// ============================================
+// Contact Types
+// ============================================
+
+export interface IMessageContact {
+  handle: string;
+  name?: string;
+  firstName?: string;
+  lastName?: string;
+  phoneNumbers?: string[];
+  emails?: string[];
+}
+
+// ============================================
+// API Response Types
+// ============================================
+
+export interface IMessageApiResponse<T = unknown> {
+  ok: boolean;
+  data?: T;
+  error?: string;
+  code?: number;
+}
+
+// ============================================
+// API Error Types
+// ============================================
+
+export class IMessageApiError extends Error {
+  public readonly statusCode: number;
+  public readonly errorCode?: number;
+
+  constructor(message: string, statusCode: number, errorCode?: number) {
+    super(message);
+    this.name = 'IMessageApiError';
+    this.statusCode = statusCode;
+    this.errorCode = errorCode;
+  }
+}

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

@@ -0,0 +1,219 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+const CONNECTOR_NAME = 'connect-imessage';
+const DEFAULT_PROFILE = 'default';
+
+export interface ProfileConfig {
+  bridgeUrl?: string;
+  apiKey?: string;
+  deviceId?: string;
+}
+
+// Store for --profile flag override (set by CLI before commands run)
+let profileOverride: string | undefined;
+
+// Config directory: ~/.hasna/connectors/{connector-name}/
+const CONFIG_DIR = join(homedir(), '.hasna', 'connectors', CONNECTOR_NAME);
+const PROFILES_DIR = join(CONFIG_DIR, 'profiles');
+const CURRENT_PROFILE_FILE = join(CONFIG_DIR, 'current_profile');
+
+// ============================================
+// Profile Management
+// ============================================
+
+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(profileName: string): string {
+  return join(PROFILES_DIR, profileName + '.json');
+}
+
+/**
+ * Get the current active profile name
+ */
+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 to default
+    }
+  }
+
+  return DEFAULT_PROFILE;
+}
+
+/**
+ * Set the current active 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);
+}
+
+/**
+ * Check if a profile exists
+ */
+export function profileExists(profile: string): boolean {
+  return existsSync(getProfilePath(profile));
+}
+
+/**
+ * List all available profiles
+ */
+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();
+}
+
+/**
+ * Create a new profile
+ */
+export function createProfile(profile: string, config: ProfileConfig = {}): boolean {
+  ensureConfigDir();
+
+  if (profileExists(profile)) {
+    return false;
+  }
+
+  // Validate profile name
+  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;
+}
+
+/**
+ * Delete a profile
+ */
+export function deleteProfile(profile: string): boolean {
+  if (profile === DEFAULT_PROFILE) {
+    return false;
+  }
+
+  if (!profileExists(profile)) {
+    return false;
+  }
+
+  // Switch to default if deleting current profile
+  if (getCurrentProfile() === profile) {
+    setCurrentProfile(DEFAULT_PROFILE);
+  }
+
+  rmSync(getProfilePath(profile));
+  return true;
+}
+
+/**
+ * Load profile config
+ */
+export function loadProfile(profile?: string): ProfileConfig {
+  ensureConfigDir();
+  const profileName = profile || getCurrentProfile();
+  const profilePath = getProfilePath(profileName);
+
+  if (!existsSync(profilePath)) {
+    return {};
+  }
+
+  try {
+    return JSON.parse(readFileSync(profilePath, 'utf-8')) as ProfileConfig;
+  } catch {
+    return {};
+  }
+}
+
+/**
+ * Save profile config
+ */
+export function saveProfile(config: ProfileConfig, profile?: string): void {
+  ensureConfigDir();
+  const profileName = profile || getCurrentProfile();
+  writeFileSync(getProfilePath(profileName), JSON.stringify(config, null, 2));
+}
+
+// ============================================
+// Config Accessors
+// ============================================
+
+export function getBridgeUrl(): string | undefined {
+  return process.env.IMESSAGE_BRIDGE_URL || loadProfile().bridgeUrl;
+}
+
+export function getApiKey(): string | undefined {
+  return process.env.IMESSAGE_API_KEY || loadProfile().apiKey;
+}
+
+export function getDeviceId(): string | undefined {
+  return process.env.IMESSAGE_DEVICE_ID || loadProfile().deviceId;
+}
+
+export function setBridgeUrl(bridgeUrl: string): void {
+  const config = loadProfile();
+  config.bridgeUrl = bridgeUrl;
+  saveProfile(config);
+}
+
+export function setApiKey(apiKey: string): void {
+  const config = loadProfile();
+  config.apiKey = apiKey;
+  saveProfile(config);
+}
+
+export function setDeviceId(deviceId: string): void {
+  const config = loadProfile();
+  config.deviceId = deviceId;
+  saveProfile(config);
+}
+
+// ============================================
+// Utility Functions
+// ============================================
+
+export function clearConfig(): void {
+  saveProfile({});
+}
+
+export function getConfigDir(): string {
+  return CONFIG_DIR;
+}
+
+export function getActiveProfileName(): string {
+  return getCurrentProfile();
+}