@hasna/connectors 1.3.42 → 1.3.43

package/connectors/stripeidentity/src/types/index.ts

@@ -0,0 +1,229 @@
+// Stripe Identity Connector Types
+// https://stripe.com/docs/api/identity
+
+// ============================================
+// Configuration
+// ============================================
+
+export interface ConnectorConfig {
+  apiKey: string;
+  baseUrl?: string;     // Override default base URL
+  accountId?: string;   // Required for org API keys (Stripe-Context header)
+  apiVersion?: string;  // Stripe API version
+}
+
+// ============================================
+// Common Types
+// ============================================
+
+export type OutputFormat = 'json' | 'pretty' | 'table';
+
+/** Key-value metadata */
+export type Metadata = Record<string, string>;
+
+/** Stripe list response wrapper */
+export interface StripeList<T> {
+  object: 'list';
+  data: T[];
+  has_more: boolean;
+  url: string;
+}
+
+/** Range filter for created-style timestamp queries */
+export type TimestampRange = number | { gt?: number; gte?: number; lt?: number; lte?: number };
+
+/** Common list options for pagination */
+export interface ListOptions {
+  limit?: number;
+  starting_after?: string;
+  ending_before?: string;
+}
+
+// ============================================
+// Shared verification structures
+// ============================================
+
+/** Error surfaced when a verification check fails */
+export interface VerificationError {
+  code?: string;
+  reason?: string;
+}
+
+/** Document type allowed / detected during verification */
+export type DocumentType = 'driving_license' | 'id_card' | 'passport';
+
+/** Verified name/address/DOB outputs on a session or report */
+export interface VerifiedAddress {
+  city?: string;
+  country?: string;
+  line1?: string;
+  line2?: string;
+  postal_code?: string;
+  state?: string;
+}
+
+export interface VerifiedDateOfBirth {
+  day?: number;
+  month?: number;
+  year?: number;
+}
+
+export interface VerifiedOutputs {
+  address?: VerifiedAddress;
+  dob?: VerifiedDateOfBirth;
+  first_name?: string;
+  last_name?: string;
+  id_number?: string;
+  id_number_type?: 'br_cpf' | 'sg_nric' | 'us_ssn';
+  email?: string;
+  phone?: string;
+  unparsed_name?: string;
+}
+
+/** Details provided by the platform about the person being verified */
+export interface ProvidedDetails {
+  email?: string;
+  phone?: string;
+}
+
+// ============================================
+// Verification Session Options
+// ============================================
+
+export interface DocumentOptions {
+  allowed_types?: DocumentType[];
+  require_id_number?: boolean;
+  require_live_capture?: boolean;
+  require_matching_selfie?: boolean;
+}
+
+export interface VerificationSessionOptions {
+  document?: DocumentOptions;
+  // id_number verification takes no additional options today
+  id_number?: Record<string, never>;
+}
+
+// ============================================
+// Verification Session
+// ============================================
+
+export type VerificationSessionStatus =
+  | 'requires_input'
+  | 'processing'
+  | 'verified'
+  | 'canceled';
+
+export type VerificationType = 'document' | 'id_number';
+
+export interface VerificationSession {
+  id: string;
+  object: 'identity.verification_session';
+  client_secret?: string | null;
+  created: number;
+  last_error?: VerificationError | null;
+  last_verification_report?: string | null;
+  livemode: boolean;
+  metadata: Metadata;
+  options?: VerificationSessionOptions | null;
+  provided_details?: ProvidedDetails | null;
+  redaction?: { status: 'processing' | 'redacted' } | null;
+  related_customer?: string | null;
+  status: VerificationSessionStatus;
+  type?: VerificationType | null;
+  url?: string | null;
+  verification_flow?: string;
+  verified_outputs?: VerifiedOutputs | null;
+}
+
+export interface VerificationSessionCreateParams {
+  type?: VerificationType;
+  verification_flow?: string;
+  client_reference_id?: string;
+  metadata?: Metadata;
+  options?: VerificationSessionOptions;
+  provided_details?: ProvidedDetails;
+  related_customer?: string;
+  return_url?: string;
+}
+
+export interface VerificationSessionUpdateParams {
+  type?: VerificationType;
+  metadata?: Metadata;
+  options?: VerificationSessionOptions;
+  provided_details?: ProvidedDetails;
+}
+
+export interface VerificationSessionListOptions extends ListOptions {
+  client_reference_id?: string;
+  created?: TimestampRange;
+  related_customer?: string;
+  status?: VerificationSessionStatus;
+}
+
+// ============================================
+// Verification Report
+// ============================================
+
+export interface ReportDocument {
+  address?: VerifiedAddress;
+  dob?: VerifiedDateOfBirth;
+  error?: VerificationError | null;
+  expiration_date?: VerifiedDateOfBirth;
+  files?: string[];
+  first_name?: string;
+  issued_date?: VerifiedDateOfBirth;
+  issuing_country?: string;
+  last_name?: string;
+  number?: string;
+  status: 'unverified' | 'verified';
+  type?: DocumentType;
+}
+
+export interface ReportIdNumber {
+  dob?: VerifiedDateOfBirth;
+  error?: VerificationError | null;
+  first_name?: string;
+  id_number?: string;
+  id_number_type?: 'br_cpf' | 'sg_nric' | 'us_ssn';
+  last_name?: string;
+  status: 'unverified' | 'verified';
+}
+
+export interface ReportSelfie {
+  document?: string;
+  error?: VerificationError | null;
+  selfie?: string;
+  status: 'unverified' | 'verified';
+}
+
+export interface VerificationReport {
+  id: string;
+  object: 'identity.verification_report';
+  created: number;
+  document?: ReportDocument | null;
+  id_number?: ReportIdNumber | null;
+  livemode: boolean;
+  options?: VerificationSessionOptions | null;
+  selfie?: ReportSelfie | null;
+  type?: VerificationType | null;
+  verification_flow?: string;
+  verification_session?: string | null;
+}
+
+export interface VerificationReportListOptions extends ListOptions {
+  client_reference_id?: string;
+  created?: TimestampRange;
+  type?: VerificationType;
+  verification_session?: string;
+}
+
+// ============================================
+// Errors
+// ============================================
+
+export class ConnectorApiError extends Error {
+  constructor(message: string, public readonly statusCode: number) {
+    super(message);
+    this.name = 'ConnectorApiError';
+  }
+}

package/connectors/stripeidentity/src/utils/config.ts

@@ -0,0 +1,209 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+// Stripe Identity connector name
+const CONNECTOR_NAME = 'stripeidentity';
+const DEFAULT_PROFILE = 'default';
+
+export interface ProfileConfig {
+  apiKey?: string;
+  accountId?: string;  // Required for org API keys (Stripe-Context header)
+}
+
+// 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(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.STRIPE_IDENTITY_API_KEY || loadProfile().apiKey;
+}
+
+export function setApiKey(apiKey: string): void {
+  const config = loadProfile();
+  config.apiKey = apiKey;
+  saveProfile(config);
+}
+
+export function getAccountId(): string | undefined {
+  return process.env.STRIPE_IDENTITY_ACCOUNT_ID || loadProfile().accountId;
+}
+
+export function setAccountId(accountId: string): void {
+  const config = loadProfile();
+  config.accountId = accountId;
+  saveProfile(config);
+}
+
+// ============================================
+// Utility Functions
+// ============================================
+
+export function clearConfig(): void {
+  saveProfile({});
+}
+
+export function getConfigDir(): string {
+  return CONFIG_DIR;
+}
+
+export function getActiveProfileName(): string {
+  return getCurrentProfile();
+}

package/connectors/stripeidentity/src/utils/output.ts

@@ -0,0 +1,119 @@
+import chalk from 'chalk';
+
+export type OutputFormat = 'json' | 'table' | 'pretty';
+
+export function formatOutput(data: unknown, format: OutputFormat = 'pretty'): string {
+  switch (format) {
+    case 'json':
+      return JSON.stringify(data, null, 2);
+    case 'table':
+      return formatAsTable(data);
+    case 'pretty':
+    default:
+      return formatPretty(data);
+  }
+}
+
+function formatAsTable(data: unknown): string {
+  if (!Array.isArray(data)) {
+    data = [data];
+  }
+
+  const items = data as Record<string, unknown>[];
+  if (items.length === 0) {
+    return 'No data';
+  }
+
+  const firstItem = items[0];
+  if (!firstItem || typeof firstItem !== 'object') {
+    return 'No data';
+  }
+
+  const keys = Object.keys(firstItem);
+  const colWidths = keys.map(key => {
+    const maxValue = Math.max(
+      key.length,
+      ...items.map(item => String(item[key] ?? '').length)
+    );
+    return Math.min(maxValue, 40);
+  });
+
+  const header = keys.map((key, i) => key.padEnd(colWidths[i] ?? 10)).join(' | ');
+  const separator = colWidths.map(w => '-'.repeat(w)).join('-+-');
+
+  const rows = items.map(item =>
+    keys.map((key, i) => {
+      const value = String(item[key] ?? '');
+      const width = colWidths[i] ?? 10;
+      return value.length > width
+        ? value.substring(0, width - 3) + '...'
+        : value.padEnd(width);
+    }).join(' | ')
+  );
+
+  return [header, separator, ...rows].join('\n');
+}
+
+function formatPretty(data: unknown): string {
+  if (Array.isArray(data)) {
+    return data.map((item, i) => `${chalk.cyan(`[${i + 1}]`)} ${formatPrettyItem(item)}`).join('\n\n');
+  }
+  return formatPrettyItem(data);
+}
+
+function formatPrettyItem(item: unknown, indent = 0): string {
+  if (item === null || item === undefined) {
+    return chalk.gray('null');
+  }
+
+  if (typeof item !== 'object') {
+    return String(item);
+  }
+
+  const spaces = '  '.repeat(indent);
+  const entries = Object.entries(item as Record<string, unknown>);
+
+  return entries
+    .map(([key, value]) => {
+      if (Array.isArray(value)) {
+        if (value.length === 0) {
+          return `${spaces}${chalk.blue(key)}: ${chalk.gray('[]')}`;
+        }
+        if (typeof value[0] === 'object') {
+          return `${spaces}${chalk.blue(key)}:\n${value.map(v => formatPrettyItem(v, indent + 1)).join('\n')}`;
+        }
+        return `${spaces}${chalk.blue(key)}: ${value.join(', ')}`;
+      }
+
+      if (typeof value === 'object' && value !== null) {
+        return `${spaces}${chalk.blue(key)}:\n${formatPrettyItem(value, indent + 1)}`;
+      }
+
+      return `${spaces}${chalk.blue(key)}: ${chalk.white(String(value))}`;
+    })
+    .join('\n');
+}
+
+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.warn(chalk.yellow('⚠'), message);
+}
+
+export function info(message: string): void {
+  console.log(chalk.blue('ℹ'), message);
+}
+
+export function heading(message: string): void {
+  console.log(chalk.bold.cyan(`\n${message}\n`));
+}
+
+export function print(data: unknown, format: OutputFormat = 'pretty'): void {
+  console.log(formatOutput(data, format));
+}

package/connectors/stripeidentity/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/stripetreasury/.env.example

@@ -0,0 +1,12 @@
+# Stripe Treasury API Credentials
+# Get your API keys from https://dashboard.stripe.com/apikeys
+# Treasury requires a platform Stripe account with the Treasury capability enabled.
+
+STRIPE_API_KEY=your_stripe_api_key_here
+
+# Optional: connected account ID to act on behalf of (Stripe-Account header)
+# Treasury financial accounts belong to connected accounts on your platform.
+# STRIPE_ACCOUNT_ID=acct_your-connected-account-here
+
+# Optional: Custom base URL (if needed, defaults to https://api.stripe.com/v1)
+# STRIPE_BASE_URL=https://api.stripe.com/v1

package/connectors/stripetreasury/.npmrc.example

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