@hasna/connectors 0.4.0 → 0.4.2

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

@@ -0,0 +1,329 @@
+// Amplitude Connector Types
+
+// ============================================
+// Configuration
+// ============================================
+
+export interface AmplitudeConfig {
+  apiKey: string;
+  secretKey: string;
+}
+
+// ============================================
+// Common Types
+// ============================================
+
+export type OutputFormat = 'json' | 'pretty';
+
+// ============================================
+// Event Types
+// ============================================
+
+export interface Event {
+  user_id?: string;
+  device_id?: string;
+  event_type: string;
+  time?: number;
+  event_properties?: Record<string, unknown>;
+  user_properties?: Record<string, unknown>;
+  groups?: Record<string, string | string[]>;
+  app_version?: string;
+  platform?: string;
+  os_name?: string;
+  os_version?: string;
+  device_brand?: string;
+  device_manufacturer?: string;
+  device_model?: string;
+  carrier?: string;
+  country?: string;
+  region?: string;
+  city?: string;
+  dma?: string;
+  language?: string;
+  price?: number;
+  quantity?: number;
+  revenue?: number;
+  productId?: string;
+  revenueType?: string;
+  location_lat?: number;
+  location_lng?: number;
+  ip?: string;
+  idfa?: string;
+  idfv?: string;
+  adid?: string;
+  android_id?: string;
+  event_id?: number;
+  session_id?: number;
+  insert_id?: string;
+}
+
+export interface BatchEventResponse {
+  code: number;
+  events_ingested?: number;
+  payload_size_bytes?: number;
+  server_upload_time?: number;
+  error?: string;
+  missing_field?: string;
+  events_with_invalid_fields?: Record<string, unknown>;
+  events_with_missing_fields?: Record<string, unknown>;
+  events_with_invalid_id_lengths?: Record<string, unknown>;
+  throttled_devices?: Record<string, number>;
+  throttled_users?: Record<string, number>;
+  throttled_events?: string[];
+  silenced_devices?: string[];
+  silenced_events?: string[];
+}
+
+// ============================================
+// User Types
+// ============================================
+
+export interface UserProperties {
+  user_id?: string;
+  device_id?: string;
+  user_properties: Record<string, unknown>;
+}
+
+export interface UserSearch {
+  user_id?: string;
+  amplitude_id?: number;
+  matches: UserMatch[];
+}
+
+export interface UserMatch {
+  user_id?: string;
+  amplitude_id: number;
+  country?: string;
+  region?: string;
+  city?: string;
+  dma?: string;
+  language?: string;
+  platform?: string;
+  os?: string;
+  device?: string;
+  device_type?: string;
+  start_version?: string;
+  last_used?: string;
+  number_of_events?: number;
+  usage_time?: number;
+  device_ids?: string[];
+  last_location?: {
+    lat: number;
+    lng: number;
+  };
+}
+
+export interface UserActivity {
+  events: UserActivityEvent[];
+  userData?: {
+    num_sessions?: number;
+    purchases?: number;
+    revenue?: number;
+    merged_amplitude_ids?: number[];
+    num_events?: number;
+    canonical_amplitude_id?: number;
+    user_id?: string;
+    last_used?: string;
+    start_version?: string;
+    device_type?: string;
+    device?: string;
+    os?: string;
+    platform?: string;
+    language?: string;
+    dma?: string;
+    city?: string;
+    region?: string;
+    country?: string;
+    properties?: Record<string, unknown>;
+    usage_time?: number;
+    first_used?: string;
+    last_location?: {
+      lat: number;
+      lng: number;
+    };
+    device_ids?: string[];
+  };
+}
+
+export interface UserActivityEvent {
+  event_time?: string;
+  event_type?: string;
+  device_id?: string;
+  amplitude_id?: number;
+  session_id?: number;
+  event_id?: number;
+  event_properties?: Record<string, unknown>;
+  user_properties?: Record<string, unknown>;
+  country?: string;
+  region?: string;
+  city?: string;
+  dma?: string;
+  language?: string;
+  platform?: string;
+  os_name?: string;
+  os_version?: string;
+  device_family?: string;
+  device_type?: string;
+  ip_address?: string;
+  uuid?: string;
+  paying?: boolean;
+  start_version?: string;
+  version_name?: string;
+  amplitude_event_type?: string;
+  group_properties?: Record<string, unknown>;
+  groups?: Record<string, unknown>;
+  data?: Record<string, unknown>;
+  location_lat?: number;
+  location_lng?: number;
+  is_attribution_event?: boolean;
+  client_event_time?: string;
+  client_upload_time?: string;
+  server_received_time?: string;
+  server_upload_time?: string;
+  adid?: string;
+  idfa?: string;
+  library?: string;
+}
+
+// ============================================
+// Export Types
+// ============================================
+
+export interface ExportParams {
+  start: string; // YYYYMMDDTHH format
+  end: string;   // YYYYMMDDTHH format
+}
+
+// ============================================
+// Cohort Types
+// ============================================
+
+export interface Cohort {
+  id: string;
+  name: string;
+  description?: string;
+  app_id: number;
+  archived: boolean;
+  chart_id?: string;
+  created_at: string;
+  definition?: CohortDefinition;
+  edit_id?: string;
+  finished?: boolean;
+  hidden?: boolean;
+  is_official?: boolean;
+  is_predictive?: boolean;
+  last_computed?: string;
+  last_modified?: string;
+  location_id?: string;
+  metadata?: string[];
+  owners?: CohortOwner[];
+  pending?: boolean;
+  published?: boolean;
+  shortcut_ids?: string[];
+  size?: number;
+  type?: string;
+  view_count?: number;
+}
+
+export interface CohortDefinition {
+  version?: number;
+  type?: string;
+  filters?: unknown[];
+}
+
+export interface CohortOwner {
+  email?: string;
+  name?: string;
+}
+
+export interface ListCohortsResult {
+  cohorts: Cohort[];
+}
+
+export interface CohortMembership {
+  cohort_id: string;
+  user_ids?: string[];
+  amplitude_ids?: number[];
+  app_id: number;
+  request_id: string;
+}
+
+// ============================================
+// Chart Types
+// ============================================
+
+export interface Chart {
+  id: string;
+  title: string;
+  chart_type: string;
+}
+
+export interface ChartData {
+  data: ChartDataSeries[];
+  metadata?: Record<string, unknown>;
+}
+
+export interface ChartDataSeries {
+  seriesLabels?: string[];
+  seriesCollapsed?: boolean[][];
+  seriesValues?: number[][];
+  xValues?: string[];
+}
+
+// ============================================
+// Taxonomy Types
+// ============================================
+
+export interface EventType {
+  event_type: string;
+  category?: EventCategory;
+  description?: string;
+  display_name?: string;
+}
+
+export interface EventCategory {
+  id: number;
+  name: string;
+}
+
+export interface EventProperty {
+  event_property: string;
+  event_type: string;
+  description?: string;
+  type?: string;
+  regex?: string;
+  enum_values?: string[];
+  is_array_type?: boolean;
+  is_required?: boolean;
+}
+
+export interface UserProperty {
+  user_property: string;
+  description?: string;
+  type?: string;
+  regex?: string;
+  enum_values?: string[];
+  is_array_type?: boolean;
+}
+
+// ============================================
+// API Error Types
+// ============================================
+
+export interface AmplitudeErrorResponse {
+  error?: string;
+  code?: number;
+  message?: string;
+}
+
+export class AmplitudeApiError extends Error {
+  public readonly statusCode: number;
+  public readonly code?: number;
+
+  constructor(message: string, statusCode: number, code?: number) {
+    super(message);
+    this.name = 'AmplitudeApiError';
+    this.statusCode = statusCode;
+    this.code = code;
+  }
+}

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

@@ -0,0 +1,208 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+const CONNECTOR_NAME = 'connect-amplitude';
+const DEFAULT_PROFILE = 'default';
+
+export interface ProfileConfig {
+  apiKey?: string;
+  secretKey?: string;
+}
+
+// Store for --profile flag override (set by CLI before commands run)
+let profileOverride: string | undefined;
+
+// Config directory: ~/.connect/{connector-name}/
+const CONFIG_DIR = join(homedir(), '.connect', 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(profile: string): string {
+  return join(PROFILES_DIR, `${profile}.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'));
+  } 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));
+}
+
+// ============================================
+// API Key Management
+// ============================================
+
+export function getApiKey(): string | undefined {
+  return process.env.AMPLITUDE_API_KEY || loadProfile().apiKey;
+}
+
+export function setApiKey(apiKey: string): void {
+  const config = loadProfile();
+  config.apiKey = apiKey;
+  saveProfile(config);
+}
+
+export function getSecretKey(): string | undefined {
+  return process.env.AMPLITUDE_SECRET_KEY || loadProfile().secretKey;
+}
+
+export function setSecretKey(secretKey: string): void {
+  const config = loadProfile();
+  config.secretKey = secretKey;
+  saveProfile(config);
+}
+
+// ============================================
+// Utility Functions
+// ============================================
+
+export function clearConfig(): void {
+  saveProfile({});
+}
+
+export function getConfigDir(): string {
+  return CONFIG_DIR;
+}
+
+export function getActiveProfileName(): string {
+  return getCurrentProfile();
+}

package/connectors/connect-amplitude/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/connectors/connect-calendly/.env.example

@@ -0,0 +1,11 @@
+# API Credentials
+# TODO: Update variable names and instructions for your API
+# Example: PERPLEXITY_API_KEY, OPENAI_API_KEY, etc.
+
+CONNECTOR_API_KEY=your-api-key-here
+
+# Optional: API secret (if your API requires it)
+# CONNECTOR_API_SECRET=your-api-secret-here
+
+# Optional: Custom base URL (if needed)
+# CONNECTOR_BASE_URL=https://api.example.com