@hasna/connectors 0.0.1

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

@@ -0,0 +1,275 @@
+// Weather API Types
+
+// ============================================
+// Configuration
+// ============================================
+
+export interface WeatherConfig {
+  apiKey: string;
+  units?: Units;
+  lang?: string;
+}
+
+export type Units = 'metric' | 'imperial' | 'standard';
+export type OutputFormat = 'json' | 'table' | 'pretty';
+
+// ============================================
+// Coordinates
+// ============================================
+
+export interface Coordinates {
+  lat: number;
+  lon: number;
+}
+
+// ============================================
+// Current Weather
+// ============================================
+
+export interface CurrentWeather {
+  coord: Coordinates;
+  weather: WeatherCondition[];
+  base: string;
+  main: MainWeatherData;
+  visibility: number;
+  wind: WindData;
+  clouds: CloudData;
+  rain?: PrecipitationData;
+  snow?: PrecipitationData;
+  dt: number;
+  sys: SystemData;
+  timezone: number;
+  id: number;
+  name: string;
+  cod: number;
+}
+
+export interface WeatherCondition {
+  id: number;
+  main: string;
+  description: string;
+  icon: string;
+}
+
+export interface MainWeatherData {
+  temp: number;
+  feels_like: number;
+  temp_min: number;
+  temp_max: number;
+  pressure: number;
+  humidity: number;
+  sea_level?: number;
+  grnd_level?: number;
+}
+
+export interface WindData {
+  speed: number;
+  deg: number;
+  gust?: number;
+}
+
+export interface CloudData {
+  all: number;
+}
+
+export interface PrecipitationData {
+  '1h'?: number;
+  '3h'?: number;
+}
+
+export interface SystemData {
+  type?: number;
+  id?: number;
+  country: string;
+  sunrise: number;
+  sunset: number;
+}
+
+// ============================================
+// Forecast
+// ============================================
+
+export interface ForecastResponse {
+  cod: string;
+  message: number;
+  cnt: number;
+  list: ForecastItem[];
+  city: CityData;
+}
+
+export interface ForecastItem {
+  dt: number;
+  main: MainWeatherData;
+  weather: WeatherCondition[];
+  clouds: CloudData;
+  wind: WindData;
+  visibility: number;
+  pop: number; // Probability of precipitation
+  rain?: PrecipitationData;
+  snow?: PrecipitationData;
+  sys: { pod: string }; // Part of day (d/n)
+  dt_txt: string;
+}
+
+export interface CityData {
+  id: number;
+  name: string;
+  coord: Coordinates;
+  country: string;
+  population: number;
+  timezone: number;
+  sunrise: number;
+  sunset: number;
+}
+
+// ============================================
+// Air Pollution
+// ============================================
+
+export interface AirPollutionResponse {
+  coord: Coordinates;
+  list: AirPollutionData[];
+}
+
+export interface AirPollutionData {
+  main: {
+    aqi: number; // Air Quality Index 1-5
+  };
+  components: AirComponents;
+  dt: number;
+}
+
+export interface AirComponents {
+  co: number;      // Carbon monoxide
+  no: number;      // Nitrogen monoxide
+  no2: number;     // Nitrogen dioxide
+  o3: number;      // Ozone
+  so2: number;     // Sulphur dioxide
+  pm2_5: number;   // Fine particles
+  pm10: number;    // Coarse particles
+  nh3: number;     // Ammonia
+}
+
+// ============================================
+// Geocoding
+// ============================================
+
+export interface GeoLocation {
+  name: string;
+  local_names?: Record<string, string>;
+  lat: number;
+  lon: number;
+  country: string;
+  state?: string;
+}
+
+// ============================================
+// One Call API (if subscribed)
+// ============================================
+
+export interface OneCallResponse {
+  lat: number;
+  lon: number;
+  timezone: string;
+  timezone_offset: number;
+  current?: CurrentOneCall;
+  minutely?: MinutelyForecast[];
+  hourly?: HourlyForecast[];
+  daily?: DailyForecast[];
+  alerts?: WeatherAlert[];
+}
+
+export interface CurrentOneCall {
+  dt: number;
+  sunrise: number;
+  sunset: number;
+  temp: number;
+  feels_like: number;
+  pressure: number;
+  humidity: number;
+  dew_point: number;
+  uvi: number;
+  clouds: number;
+  visibility: number;
+  wind_speed: number;
+  wind_deg: number;
+  wind_gust?: number;
+  weather: WeatherCondition[];
+  rain?: PrecipitationData;
+  snow?: PrecipitationData;
+}
+
+export interface MinutelyForecast {
+  dt: number;
+  precipitation: number;
+}
+
+export interface HourlyForecast extends CurrentOneCall {
+  pop: number;
+}
+
+export interface DailyForecast {
+  dt: number;
+  sunrise: number;
+  sunset: number;
+  moonrise: number;
+  moonset: number;
+  moon_phase: number;
+  summary?: string;
+  temp: {
+    day: number;
+    min: number;
+    max: number;
+    night: number;
+    eve: number;
+    morn: number;
+  };
+  feels_like: {
+    day: number;
+    night: number;
+    eve: number;
+    morn: number;
+  };
+  pressure: number;
+  humidity: number;
+  dew_point: number;
+  wind_speed: number;
+  wind_deg: number;
+  wind_gust?: number;
+  weather: WeatherCondition[];
+  clouds: number;
+  pop: number;
+  rain?: number;
+  snow?: number;
+  uvi: number;
+}
+
+export interface WeatherAlert {
+  sender_name: string;
+  event: string;
+  start: number;
+  end: number;
+  description: string;
+  tags: string[];
+}
+
+// ============================================
+// API Error Types
+// ============================================
+
+export interface WeatherError {
+  cod: string | number;
+  message: string;
+}
+
+export class WeatherApiError extends Error {
+  public readonly statusCode: number;
+  public readonly code?: string;
+
+  constructor(message: string, statusCode: number, code?: string) {
+    super(message);
+    this.name = 'WeatherApiError';
+    this.statusCode = statusCode;
+    this.code = code;
+  }
+}

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

@@ -0,0 +1,82 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import type { Units } from '../types';
+
+const CONFIG_DIR = join(homedir(), '.connect', 'connect-openweathermap');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+export interface CliConfig {
+  apiKey?: string;
+  units?: Units;
+  lang?: string;
+  defaultCity?: string;
+}
+
+function ensureConfigDir(): void {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+
+export function loadConfig(): CliConfig {
+  ensureConfigDir();
+  if (!existsSync(CONFIG_FILE)) {
+    return {};
+  }
+  try {
+    const content = readFileSync(CONFIG_FILE, 'utf-8');
+    return JSON.parse(content);
+  } catch {
+    return {};
+  }
+}
+
+export function saveConfig(config: CliConfig): void {
+  ensureConfigDir();
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+export function getApiKey(): string | undefined {
+  return process.env.OPENWEATHERMAP_API_KEY || process.env.OPENWEATHER_API_KEY || loadConfig().apiKey;
+}
+
+export function setApiKey(apiKey: string): void {
+  const config = loadConfig();
+  config.apiKey = apiKey;
+  saveConfig(config);
+}
+
+export function getUnits(): Units {
+  return (process.env.OPENWEATHERMAP_UNITS as Units) || loadConfig().units || 'metric';
+}
+
+export function setUnits(units: Units): void {
+  const config = loadConfig();
+  config.units = units;
+  saveConfig(config);
+}
+
+export function getLang(): string {
+  return process.env.OPENWEATHERMAP_LANG || loadConfig().lang || 'en';
+}
+
+export function setLang(lang: string): void {
+  const config = loadConfig();
+  config.lang = lang;
+  saveConfig(config);
+}
+
+export function getDefaultCity(): string | undefined {
+  return process.env.OPENWEATHERMAP_CITY || loadConfig().defaultCity;
+}
+
+export function setDefaultCity(city: string): void {
+  const config = loadConfig();
+  config.defaultCity = city;
+  saveConfig(config);
+}
+
+export function clearConfig(): void {
+  saveConfig({});
+}

package/connectors/connect-openweathermap/src/utils/output.ts

@@ -0,0 +1,106 @@
+import chalk from 'chalk';
+import type { OutputFormat } from '../types';
+
+export function success(message: string): void {
+  console.log(chalk.green('✓'), message);
+}
+
+export function error(message: string): void {
+  console.error(chalk.red('✗'), message);
+}
+
+export function warn(message: string): void {
+  console.log(chalk.yellow('⚠'), message);
+}
+
+export function info(message: string): void {
+  console.log(chalk.blue('ℹ'), message);
+}
+
+export function print(data: unknown, format: OutputFormat = 'pretty'): void {
+  if (format === 'json') {
+    console.log(JSON.stringify(data, null, 2));
+  } else if (format === 'table' && Array.isArray(data)) {
+    console.table(data);
+  } else {
+    console.log(JSON.stringify(data, null, 2));
+  }
+}
+
+// Weather-specific formatting helpers
+export function formatTemp(temp: number, unit: string): string {
+  return `${Math.round(temp)}${unit}`;
+}
+
+export function formatWind(speed: number, unit: string, deg?: number): string {
+  const direction = deg !== undefined ? ` ${getWindDirection(deg)}` : '';
+  return `${speed.toFixed(1)} ${unit}${direction}`;
+}
+
+export function getWindDirection(deg: number): string {
+  const directions = ['N', 'NNE', 'NE', 'ENE', 'E', 'ESE', 'SE', 'SSE', 'S', 'SSW', 'SW', 'WSW', 'W', 'WNW', 'NW', 'NNW'];
+  const index = Math.round(deg / 22.5) % 16;
+  return directions[index];
+}
+
+export function formatTimestamp(timestamp: number, timezone?: number): string {
+  const date = new Date((timestamp + (timezone || 0)) * 1000);
+  return date.toLocaleString('en-US', {
+    weekday: 'short',
+    month: 'short',
+    day: 'numeric',
+    hour: '2-digit',
+    minute: '2-digit',
+    timeZone: 'UTC',
+  });
+}
+
+export function formatTime(timestamp: number, timezone?: number): string {
+  const date = new Date((timestamp + (timezone || 0)) * 1000);
+  return date.toLocaleTimeString('en-US', {
+    hour: '2-digit',
+    minute: '2-digit',
+    timeZone: 'UTC',
+  });
+}
+
+export function getWeatherEmoji(iconCode: string): string {
+  const emojiMap: Record<string, string> = {
+    '01d': '☀️',  // clear sky day
+    '01n': '🌙',  // clear sky night
+    '02d': '⛅',  // few clouds day
+    '02n': '☁️',  // few clouds night
+    '03d': '☁️',  // scattered clouds
+    '03n': '☁️',
+    '04d': '☁️',  // broken clouds
+    '04n': '☁️',
+    '09d': '🌧️',  // shower rain
+    '09n': '🌧️',
+    '10d': '🌦️',  // rain day
+    '10n': '🌧️',  // rain night
+    '11d': '⛈️',  // thunderstorm
+    '11n': '⛈️',
+    '13d': '❄️',  // snow
+    '13n': '❄️',
+    '50d': '🌫️',  // mist
+    '50n': '🌫️',
+  };
+  return emojiMap[iconCode] || '🌡️';
+}
+
+export function getAqiLabel(aqi: number): { label: string; color: typeof chalk } {
+  switch (aqi) {
+    case 1:
+      return { label: 'Good', color: chalk.green };
+    case 2:
+      return { label: 'Fair', color: chalk.yellow };
+    case 3:
+      return { label: 'Moderate', color: chalk.hex('#FFA500') };
+    case 4:
+      return { label: 'Poor', color: chalk.red };
+    case 5:
+      return { label: 'Very Poor', color: chalk.bgRed.white };
+    default:
+      return { label: 'Unknown', color: chalk.gray };
+  }
+}

package/connectors/connect-openweathermap/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": ["@types/bun"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "bin"]
+}

package/connectors/connect-pandadoc/.env.example

@@ -0,0 +1,13 @@
+# PandaDoc API Credentials
+# Get your API key from: https://app.pandadoc.com/a/#/settings/integrations/api
+
+# API Key authentication
+PANDADOC_API_KEY=your-api-key-here
+
+# Or OAuth Bearer token (alternative to API Key)
+# PANDADOC_ACCESS_TOKEN=your-oauth-access-token
+
+# Optional: Custom base URL (defaults to https://api.pandadoc.com/public/v1)
+# PANDADOC_BASE_URL=https://api.pandadoc.com/public/v1
+
+# Note: Sandbox API keys have watermarks and 10 requests/minute limit

package/connectors/connect-pandadoc/.npmrc.example

@@ -0,0 +1,2 @@
+@hasna:registry=https://registry.npmjs.org/
+//registry.npmjs.org/:_authToken=${NPM_TOKEN}

package/connectors/connect-pandadoc/AGENTS.md

@@ -0,0 +1,76 @@
+# AGENTS.md
+
+This file provides guidance to AI coding agents when working with this repository.
+
+## Project Overview
+
+PandaDoc API connector - A TypeScript CLI for the PandaDoc API with multi-profile support
+
+## Build & Run Commands
+
+```bash
+# Install dependencies
+bun install
+
+# Run CLI in development
+bun run dev
+
+# Build for distribution
+bun run build
+
+# Type check
+bun run typecheck
+```
+
+## Code Style
+
+- TypeScript with strict mode
+- ESM modules (`type: module`)
+- Async/await for all async operations
+- Minimal dependencies: commander, chalk
+- Type annotations required everywhere
+
+## Project Structure
+
+```
+src/
+├── api/           # API client modules
+│   ├── client.ts  # HTTP client with authentication
+│   └── index.ts   # Main connector class
+├── cli/
+│   └── index.ts   # CLI commands
+├── types/
+│   └── index.ts   # TypeScript types
+├── utils/
+│   ├── config.ts  # Multi-profile configuration
+│   └── output.ts  # CLI output formatting
+└── index.ts       # Library exports
+```
+
+## Authentication
+
+API Key authentication. Credentials can be set via:
+- Environment variable (see below)
+- Profile configuration: `connect-pandadoc config set-key <key>`
+
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `PANDADOC_API_KEY` | API key |
+
+## Data Storage
+
+```
+~/.connect/connect-pandadoc/
+├── current_profile   # Active profile name
+└── profiles/
+    ├── default.json  # Default profile
+    └── {name}.json   # Named profiles
+```
+
+## Dependencies
+
+- commander: CLI framework
+- chalk: Terminal styling

package/connectors/connect-pandadoc/CLAUDE.md

@@ -0,0 +1,76 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code when working with this repository.
+
+## Project Overview
+
+PandaDoc API connector - A TypeScript CLI for the PandaDoc API with multi-profile support
+
+## Build & Run Commands
+
+```bash
+# Install dependencies
+bun install
+
+# Run CLI in development
+bun run dev
+
+# Build for distribution
+bun run build
+
+# Type check
+bun run typecheck
+```
+
+## Code Style
+
+- TypeScript with strict mode
+- ESM modules (`type: module`)
+- Async/await for all async operations
+- Minimal dependencies: commander, chalk
+- Type annotations required everywhere
+
+## Project Structure
+
+```
+src/
+├── api/           # API client modules
+│   ├── client.ts  # HTTP client with authentication
+│   └── index.ts   # Main connector class
+├── cli/
+│   └── index.ts   # CLI commands
+├── types/
+│   └── index.ts   # TypeScript types
+├── utils/
+│   ├── config.ts  # Multi-profile configuration
+│   └── output.ts  # CLI output formatting
+└── index.ts       # Library exports
+```
+
+## Authentication
+
+API Key authentication. Credentials can be set via:
+- Environment variable (see below)
+- Profile configuration: `connect-pandadoc config set-key <key>`
+
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `PANDADOC_API_KEY` | API key |
+
+## Data Storage
+
+```
+~/.connect/connect-pandadoc/
+├── current_profile   # Active profile name
+└── profiles/
+    ├── default.json  # Default profile
+    └── {name}.json   # Named profiles
+```
+
+## Dependencies
+
+- commander: CLI framework
+- chalk: Terminal styling