@hasna/connectors 1.3.43 → 1.3.44

package/connectors/ups/src/utils/settings.ts

@@ -0,0 +1,114 @@
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { getConfigDir, ensureConfigDir } from './config';
+
+// ============================================
+// Settings Storage Utility
+// ============================================
+
+/**
+ * TODO: Define your connector-specific settings
+ * Add fields for user preferences, defaults, etc.
+ */
+export interface Settings {
+  // Display settings
+  defaultFormat: 'json' | 'table' | 'pretty';
+
+  // Behavior settings
+  confirmDestructive: boolean;  // Require confirmation for destructive operations
+  verboseOutput: boolean;       // Enable verbose output by default
+
+  // API settings
+  defaultMaxResults: number;    // Default page size for list operations
+  requestTimeout: number;       // Request timeout in ms
+
+  // Add more settings as needed for your connector
+}
+
+const DEFAULT_SETTINGS: Settings = {
+  defaultFormat: 'pretty',
+  confirmDestructive: true,
+  verboseOutput: false,
+  defaultMaxResults: 20,
+  requestTimeout: 30000,
+};
+
+function getSettingsPath(): string {
+  return join(getConfigDir(), 'settings.json');
+}
+
+/**
+ * Load settings from disk, merging with defaults
+ */
+export function loadSettings(): Settings {
+  ensureConfigDir();
+  const filepath = getSettingsPath();
+
+  if (!existsSync(filepath)) {
+    // Create default settings file
+    saveSettings(DEFAULT_SETTINGS);
+    return DEFAULT_SETTINGS;
+  }
+
+  try {
+    const content = readFileSync(filepath, 'utf-8');
+    const loaded = JSON.parse(content);
+    // Merge with defaults to ensure all fields exist
+    return { ...DEFAULT_SETTINGS, ...loaded };
+  } catch {
+    return DEFAULT_SETTINGS;
+  }
+}
+
+/**
+ * Save settings to disk
+ */
+export function saveSettings(settings: Settings): void {
+  ensureConfigDir();
+  const filepath = getSettingsPath();
+  writeFileSync(filepath, JSON.stringify(settings, null, 2));
+}
+
+/**
+ * Get a specific setting value
+ */
+export function getSetting<K extends keyof Settings>(key: K): Settings[K] {
+  return loadSettings()[key];
+}
+
+/**
+ * Set a specific setting value
+ */
+export function setSetting<K extends keyof Settings>(key: K, value: Settings[K]): void {
+  const settings = loadSettings();
+  settings[key] = value;
+  saveSettings(settings);
+}
+
+/**
+ * Reset settings to defaults
+ */
+export function resetSettings(): void {
+  saveSettings(DEFAULT_SETTINGS);
+}
+
+/**
+ * Get default settings (useful for CLI help text)
+ */
+export function getDefaultSettings(): Settings {
+  return { ...DEFAULT_SETTINGS };
+}
+
+/**
+ * Check if verbose output is enabled
+ */
+export function isVerbose(): boolean {
+  return loadSettings().verboseOutput;
+}
+
+/**
+ * Check if destructive operations need confirmation
+ */
+export function needsConfirmation(): boolean {
+  return loadSettings().confirmDestructive;
+}

package/connectors/ups/src/utils/storage.ts

@@ -0,0 +1,198 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { getConfigDir } from './config';
+
+// ============================================
+// Generic Data Storage Utility
+// ============================================
+
+/**
+ * Base interface for storable entities
+ * All stored entities should have an id field
+ */
+export interface Storable {
+  id: string;
+  createdAt?: string;
+  updatedAt?: string;
+}
+
+/**
+ * Get the storage directory for an entity type
+ */
+function getStorageDir(entityType: string): string {
+  const dir = join(getConfigDir(), 'data', entityType);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  return dir;
+}
+
+/**
+ * Convert an ID to a safe filename
+ */
+function idToFilename(id: string): string {
+  return id.toLowerCase().replace(/[^a-z0-9]/g, '_') + '.json';
+}
+
+/**
+ * Get the file path for an entity
+ */
+function getEntityPath(entityType: string, id: string): string {
+  return join(getStorageDir(entityType), idToFilename(id));
+}
+
+/**
+ * Save an entity to storage
+ */
+export function saveEntity<T extends Storable>(entityType: string, entity: T): void {
+  const filepath = getEntityPath(entityType, entity.id);
+  const now = new Date().toISOString();
+
+  const existing = getEntity<T>(entityType, entity.id);
+
+  const data: T = {
+    ...entity,
+    createdAt: existing?.createdAt || now,
+    updatedAt: now,
+  };
+
+  writeFileSync(filepath, JSON.stringify(data, null, 2));
+}
+
+/**
+ * Get an entity by ID
+ */
+export function getEntity<T extends Storable>(entityType: string, id: string): T | null {
+  const filepath = getEntityPath(entityType, id);
+
+  if (!existsSync(filepath)) {
+    return null;
+  }
+
+  try {
+    const content = readFileSync(filepath, 'utf-8');
+    return JSON.parse(content) as T;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Check if an entity exists
+ */
+export function entityExists(entityType: string, id: string): boolean {
+  return existsSync(getEntityPath(entityType, id));
+}
+
+/**
+ * Get all entities of a type
+ */
+export function getAllEntities<T extends Storable>(entityType: string): T[] {
+  const storageDir = getStorageDir(entityType);
+  const files = readdirSync(storageDir).filter(f => f.endsWith('.json'));
+
+  const entities: T[] = [];
+  for (const file of files) {
+    try {
+      const content = readFileSync(join(storageDir, file), 'utf-8');
+      entities.push(JSON.parse(content) as T);
+    } catch {
+      // Skip invalid files
+    }
+  }
+
+  return entities.sort((a, b) => a.id.localeCompare(b.id));
+}
+
+/**
+ * Delete an entity
+ */
+export function deleteEntity(entityType: string, id: string): boolean {
+  const filepath = getEntityPath(entityType, id);
+
+  if (existsSync(filepath)) {
+    unlinkSync(filepath);
+    return true;
+  }
+  return false;
+}
+
+/**
+ * Search entities by a predicate function
+ */
+export function searchEntities<T extends Storable>(
+  entityType: string,
+  predicate: (entity: T) => boolean
+): T[] {
+  const all = getAllEntities<T>(entityType);
+  return all.filter(predicate);
+}
+
+/**
+ * Search entities by text match across all string fields
+ */
+export function searchEntitiesByText<T extends Storable>(
+  entityType: string,
+  query: string,
+  fields?: (keyof T)[]
+): T[] {
+  const all = getAllEntities<T>(entityType);
+  const q = query.toLowerCase();
+
+  return all.filter(entity => {
+    const searchFields = fields || (Object.keys(entity) as (keyof T)[]);
+    return searchFields.some(field => {
+      const value = entity[field];
+      if (typeof value === 'string') {
+        return value.toLowerCase().includes(q);
+      }
+      return false;
+    });
+  });
+}
+
+/**
+ * Count entities of a type
+ */
+export function countEntities(entityType: string): number {
+  const storageDir = getStorageDir(entityType);
+  if (!existsSync(storageDir)) {
+    return 0;
+  }
+  return readdirSync(storageDir).filter(f => f.endsWith('.json')).length;
+}
+
+/**
+ * Clear all entities of a type
+ */
+export function clearEntities(entityType: string): number {
+  const storageDir = getStorageDir(entityType);
+  if (!existsSync(storageDir)) {
+    return 0;
+  }
+
+  const files = readdirSync(storageDir).filter(f => f.endsWith('.json'));
+  for (const file of files) {
+    unlinkSync(join(storageDir, file));
+  }
+
+  return files.length;
+}
+
+/**
+ * Create a typed storage helper for a specific entity type
+ * This provides a cleaner API for working with a single entity type
+ */
+export function createStorage<T extends Storable>(entityType: string) {
+  return {
+    save: (entity: T) => saveEntity<T>(entityType, entity),
+    get: (id: string) => getEntity<T>(entityType, id),
+    exists: (id: string) => entityExists(entityType, id),
+    getAll: () => getAllEntities<T>(entityType),
+    delete: (id: string) => deleteEntity(entityType, id),
+    search: (predicate: (entity: T) => boolean) => searchEntities<T>(entityType, predicate),
+    searchByText: (query: string, fields?: (keyof T)[]) => searchEntitiesByText<T>(entityType, query, fields),
+    count: () => countEntities(entityType),
+    clear: () => clearEntities(entityType),
+  };
+}

package/connectors/ups/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", "**/*.test.ts"]
+}

package/connectors/usebidflow/.env.example

@@ -0,0 +1,7 @@
+# Bidflow Platform API credentials
+# Obtain an API key from your Bidflow Platform account settings.
+
+USEBIDFLOW_API_KEY=your-api-key-here
+
+# Optional: override the API base URL (default https://api.usebidflow.com/v1)
+# USEBIDFLOW_BASE_URL=https://api.usebidflow.com/v1

package/connectors/usebidflow/AGENTS.md

@@ -0,0 +1,36 @@
+# AGENTS.md
+
+Bidflow Platform (`usebidflow`) API connector.
+
+## Commands
+
+```bash
+bun install
+bun run dev
+bun run build
+bun run typecheck
+bun test
+```
+
+## Authentication
+
+Bearer token via `USEBIDFLOW_API_KEY` or `connect-usebidflow config set-key`.
+
+## Structure
+
+```
+src/api/     # HTTP client + bids/events modules
+src/cli/     # Commander CLI
+src/types/   # TypeScript types
+src/utils/   # config + output
+```
+
+## Data Storage
+
+`~/.hasna/connectors/connect-usebidflow/profiles/`
+
+## Security
+
+- No hardcoded API keys
+- `.env.example` uses placeholders only
+- `@hasna` namespace

package/connectors/usebidflow/CLAUDE.md

@@ -0,0 +1,86 @@
+# CLAUDE.md
+
+Bidflow Platform API connector for bids, events, and marketplace search.
+
+## Build & Run Commands
+
+```bash
+bun install
+bun run dev
+bun run build
+bun run typecheck
+bun test
+```
+
+## Project Structure
+
+```
+src/
+├── api/
+│   ├── client.ts
+│   ├── bids.ts
+│   ├── events.ts
+│   └── index.ts
+├── cli/
+│   └── index.ts
+├── types/
+│   └── index.ts
+├── utils/
+│   ├── config.ts
+│   └── output.ts
+└── index.ts
+```
+
+## API
+
+Base URL: `https://api.usebidflow.com/v1`
+
+Endpoints:
+- `GET /bids` — list bids
+- `POST /bids` — create bid
+- `GET /bids/:id` — get bid
+- `GET /events` — list events
+- `POST /search` — marketplace search
+
+## Authentication
+
+Bearer Token authentication. Credentials can be set via:
+- Environment variable `USEBIDFLOW_API_KEY`
+- Profile configuration: `connect-usebidflow config set-key <key>`
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `USEBIDFLOW_API_KEY` | API key for Bidflow Platform |
+| `USEBIDFLOW_BASE_URL` | Optional API base URL override |
+
+## CLI Commands
+
+```bash
+connect-usebidflow profile list
+connect-usebidflow profile use <name>
+connect-usebidflow config set-key <key>
+connect-usebidflow config show
+connect-usebidflow bids list
+connect-usebidflow bids get <bidId>
+connect-usebidflow bids create --data '<json>'
+connect-usebidflow events list
+connect-usebidflow search --query <text>
+connect-usebidflow raw --path /bids [--method GET] [--data '<json>']
+```
+
+## Data Storage
+
+```
+~/.hasna/connectors/connect-usebidflow/
+├── current_profile
+└── profiles/
+    └── default/
+        └── config.json
+```
+
+## Dependencies
+
+- commander
+- chalk

package/connectors/usebidflow/README.md

@@ -0,0 +1,77 @@
+# connect-usebidflow
+
+TypeScript API connector for the [Bidflow Platform](https://usebidflow.com) REST API.
+
+## Features
+
+- Bearer token authentication
+- Multi-profile configuration
+- Bids: list, get, create
+- Events: list
+- Marketplace search
+- Raw request escape hatch
+
+## Install
+
+```bash
+bun install
+```
+
+## Configuration
+
+```bash
+export USEBIDFLOW_API_KEY=your-api-key-here
+# optional
+export USEBIDFLOW_BASE_URL=https://api.usebidflow.com/v1
+
+# or via profile
+connect-usebidflow config set-key your-api-key-here
+```
+
+Profiles are stored under `~/.hasna/connectors/connect-usebidflow/`.
+
+## CLI Usage
+
+```bash
+# Bids
+connect-usebidflow bids list
+connect-usebidflow bids get <bidId>
+connect-usebidflow bids create --data '{"title":"Example"}'
+
+# Events
+connect-usebidflow events list
+
+# Search
+connect-usebidflow search --query "widgets"
+connect-usebidflow search --data '{"query":"widgets","filters":{}}'
+
+# Raw API request
+connect-usebidflow raw --path /bids --method GET
+connect-usebidflow raw --path /search --method POST --data '{"query":"test"}'
+
+# Output as JSON
+connect-usebidflow --format json bids list
+```
+
+## Library Usage
+
+```typescript
+import { Usebidflow } from '@hasna/connect-usebidflow';
+
+const client = Usebidflow.fromEnv();
+const bids = await client.bids.list();
+const bid = await client.bids.get('bid-id');
+```
+
+## Development
+
+```bash
+bun run dev -- bids list
+bun test
+bun run typecheck
+bun run build
+```
+
+## License
+
+Apache-2.0

package/connectors/usebidflow/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@hasna/connect-usebidflow",
+  "version": "0.1.0",
+  "description": "Bidflow Platform API connector - bids, events, and marketplace search",
+  "type": "module",
+  "bin": {
+    "connect-usebidflow": "./bin/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun && bun build ./src/cli/index.ts --outdir ./bin --target bun",
+    "dev": "bun run ./src/cli/index.ts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "usebidflow",
+    "bidflow",
+    "bids",
+    "marketplace",
+    "commerce",
+    "api",
+    "connector",
+    "cli",
+    "typescript",
+    "bun",
+    "hasna"
+  ],
+  "author": "Hasna",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hasna/connectors.git"
+  }
+}

package/connectors/usebidflow/src/api/bids.ts

@@ -0,0 +1,19 @@
+import type { UsebidflowClient } from './client';
+import { encodePathSegment } from './client';
+import type { Bid, BidListResponse, CreateBidParams } from '../types';
+
+export class BidsApi {
+  constructor(private readonly client: UsebidflowClient) {}
+
+  list(params?: Record<string, string | number | boolean | undefined>): Promise<BidListResponse> {
+    return this.client.get<BidListResponse>('/bids', params);
+  }
+
+  get(bidId: string): Promise<Bid> {
+    return this.client.get<Bid>(`/bids/${encodePathSegment(bidId)}`);
+  }
+
+  create(body: CreateBidParams): Promise<Bid> {
+    return this.client.post<Bid>('/bids', body);
+  }
+}