@hasna/connectors 0.8.1 → 0.9.0

package/connectors/connect-cleverreach/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/connect-cleverreach/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-clickbank/.env.example

@@ -0,0 +1,2 @@
+# ClickBank API Configuration
+CLICKBANK_API_KEY=your-api-key-here

package/connectors/connect-clickbank/CLAUDE.md

@@ -0,0 +1,111 @@
+---
+description: Use Bun instead of Node.js, npm, pnpm, or vite.
+globs: "*.ts, *.tsx, *.html, *.css, *.js, *.jsx, package.json"
+alwaysApply: false
+---
+
+Default to using Bun instead of Node.js.
+
+- Use `bun <file>` instead of `node <file>` or `ts-node <file>`
+- Use `bun test` instead of `jest` or `vitest`
+- Use `bun build <file.html|file.ts|file.css>` instead of `webpack` or `esbuild`
+- Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`
+- Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`
+- Use `bunx <package> <command>` instead of `npx <package> <command>`
+- Bun automatically loads .env, so don't use dotenv.
+
+## APIs
+
+- `Bun.serve()` supports WebSockets, HTTPS, and routes. Don't use `express`.
+- `bun:sqlite` for SQLite. Don't use `better-sqlite3`.
+- `Bun.redis` for Redis. Don't use `ioredis`.
+- `Bun.sql` for Postgres. Don't use `pg` or `postgres.js`.
+- `WebSocket` is built-in. Don't use `ws`.
+- Prefer `Bun.file` over `node:fs`'s readFile/writeFile
+- Bun.$`ls` instead of execa.
+
+## Testing
+
+Use `bun test` to run tests.
+
+```ts#index.test.ts
+import { test, expect } from "bun:test";
+
+test("hello world", () => {
+  expect(1).toBe(1);
+});
+```
+
+## Frontend
+
+Use HTML imports with `Bun.serve()`. Don't use `vite`. HTML imports fully support React, CSS, Tailwind.
+
+Server:
+
+```ts#index.ts
+import index from "./index.html"
+
+Bun.serve({
+  routes: {
+    "/": index,
+    "/api/users/:id": {
+      GET: (req) => {
+        return new Response(JSON.stringify({ id: req.params.id }));
+      },
+    },
+  },
+  // optional websocket support
+  websocket: {
+    open: (ws) => {
+      ws.send("Hello, world!");
+    },
+    message: (ws, message) => {
+      ws.send(message);
+    },
+    close: (ws) => {
+      // handle close
+    }
+  },
+  development: {
+    hmr: true,
+    console: true,
+  }
+})
+```
+
+HTML files can import .tsx, .jsx or .js files directly and Bun's bundler will transpile & bundle automatically. `<link>` tags can point to stylesheets and Bun's CSS bundler will bundle.
+
+```html#index.html
+<html>
+  <body>
+    <h1>Hello, world!</h1>
+    <script type="module" src="./frontend.tsx"></script>
+  </body>
+</html>
+```
+
+With the following `frontend.tsx`:
+
+```tsx#frontend.tsx
+import React from "react";
+import { createRoot } from "react-dom/client";
+
+// import .css files directly and it works
+import './index.css';
+
+const root = createRoot(document.body);
+
+export default function Frontend() {
+  return <h1>Hello, world!</h1>;
+}
+
+root.render(<Frontend />);
+```
+
+Then, run index.ts
+
+```sh
+bun --hot ./index.ts
+```
+
+For more information, read the Bun API docs in `node_modules/bun-types/docs/**.mdx`.

package/connectors/connect-clickbank/README.md

@@ -0,0 +1,291 @@
+# connect-clickbank
+
+A TypeScript CLI and SDK for the ClickBank API. Built with Bun.
+
+## Installation
+
+### Global Installation (CLI)
+
+```bash
+# Install globally
+bun install -g .
+
+# Or link for development
+bun link
+```
+
+### As a Dependency
+
+```bash
+bun add connect-clickbank
+```
+
+## Quick Start
+
+### CLI Usage
+
+```bash
+# Configure your API key
+connect-clickbank config set-key YOUR_API_KEY
+
+# Or use environment variable
+export CLICKBANK_API_KEY=YOUR_API_KEY
+
+# View today's stats
+connect-clickbank stats today
+
+# List orders
+connect-clickbank orders list --start-date 2024-01-01 --end-date 2024-01-31
+
+# Get order details
+connect-clickbank orders get RECEIPT_NUMBER
+
+# List products
+connect-clickbank products list --account YOUR_ACCOUNT
+```
+
+### SDK Usage
+
+```typescript
+import { ClickBank } from 'connect-clickbank';
+
+// Initialize with API key
+const cb = new ClickBank({ apiKey: 'YOUR_API_KEY' });
+
+// Or use environment variable
+const cb = ClickBank.fromEnv();
+
+// Get orders
+const { orders, hasMore } = await cb.orders.list({
+  startDate: '2024-01-01',
+  endDate: '2024-01-31',
+});
+
+// Get quick stats
+const stats = await cb.quickstats.getToday();
+console.log(`Today's sales: ${stats.totalSales}`);
+
+// Create a refund ticket
+const ticket = await cb.tickets.createRefund(
+  'RECEIPT_NUMBER',
+  'FULL',
+  'Customer requested refund'
+);
+```
+
+## CLI Commands
+
+### Configuration
+
+```bash
+connect-clickbank config set-key <apiKey>     # Set API key
+connect-clickbank config set-account <name>   # Set default account
+connect-clickbank config show                 # Show configuration
+connect-clickbank config clear                # Clear configuration
+```
+
+### Orders
+
+```bash
+connect-clickbank orders get <receipt>        # Get order by receipt
+connect-clickbank orders list                 # List orders
+connect-clickbank orders count                # Count orders
+connect-clickbank orders upsells <receipt>    # Get upsells
+connect-clickbank orders is-active <receipt>  # Check subscription status
+connect-clickbank orders pause <receipt>      # Pause subscription
+connect-clickbank orders reinstate <receipt>  # Reinstate subscription
+connect-clickbank orders extend <receipt>     # Extend subscription
+```
+
+### Products
+
+```bash
+connect-clickbank products get <sku> -a <account>     # Get product
+connect-clickbank products list -a <account>          # List products
+connect-clickbank products delete <sku> -a <account>  # Delete product
+```
+
+### Tickets
+
+```bash
+connect-clickbank tickets get <id>            # Get ticket
+connect-clickbank tickets list                # List tickets
+connect-clickbank tickets count               # Count tickets
+connect-clickbank tickets refund <receipt>    # Create refund ticket
+connect-clickbank tickets cancel <receipt>    # Create cancellation ticket
+connect-clickbank tickets close <id>          # Close ticket
+connect-clickbank tickets reopen <id>         # Reopen ticket
+```
+
+### Shipping
+
+```bash
+connect-clickbank shipping list               # List shipping orders
+connect-clickbank shipping count              # Count shipping orders
+connect-clickbank shipping unshipped          # List unshipped orders
+connect-clickbank shipping mark-shipped <receipt>  # Mark as shipped
+```
+
+### Quickstats
+
+```bash
+connect-clickbank stats accounts              # List accounts
+connect-clickbank stats summary               # Get summary stats
+connect-clickbank stats today                 # Get today's stats
+connect-clickbank stats daily                 # Get daily breakdown
+```
+
+### Analytics
+
+```bash
+connect-clickbank analytics status            # Get API status
+connect-clickbank analytics subscriptions     # Get subscription trends
+connect-clickbank analytics products          # Get product stats
+connect-clickbank analytics countries         # Get country stats
+```
+
+### Images
+
+```bash
+connect-clickbank images list -a <account>    # List images
+```
+
+## Output Formats
+
+Use the `-f` or `--format` flag to change output format:
+
+```bash
+connect-clickbank orders list -f json         # JSON output
+connect-clickbank orders list -f table        # Table output
+connect-clickbank orders list -f pretty       # Pretty output (default)
+```
+
+## API Reference
+
+### ClickBank Class
+
+```typescript
+import { ClickBank } from 'connect-clickbank';
+
+const cb = new ClickBank({ apiKey: 'YOUR_API_KEY' });
+
+// Available APIs
+cb.orders      // Orders API
+cb.products    // Products API
+cb.tickets     // Tickets API
+cb.shipping    // Shipping API
+cb.quickstats  // Quickstats API
+cb.analytics   // Analytics API
+cb.images      // Images API
+```
+
+### Orders API
+
+```typescript
+// Get order by receipt
+const order = await cb.orders.getOrder('RECEIPT');
+
+// List orders with filters
+const { orders, hasMore } = await cb.orders.list({
+  startDate: '2024-01-01',
+  endDate: '2024-01-31',
+  type: 'SALE',
+  role: 'VENDOR',
+});
+
+// Count orders
+const count = await cb.orders.count({ type: 'SALE' });
+
+// Check if subscription is active
+const isActive = await cb.orders.isActive('RECEIPT');
+
+// Manage subscriptions
+await cb.orders.pause('RECEIPT', { restartDate: '2024-03-01' });
+await cb.orders.reinstate('RECEIPT');
+await cb.orders.extend('RECEIPT', { numPeriods: 3 });
+```
+
+### Tickets API
+
+```typescript
+// Create refund ticket
+const ticket = await cb.tickets.createRefund('RECEIPT', 'FULL', 'reason');
+
+// Create partial refund
+const ticket = await cb.tickets.createRefund('RECEIPT', 'PARTIAL_AMOUNT', 'reason', {
+  refundAmount: 25.00,
+});
+
+// Create cancellation
+const ticket = await cb.tickets.createCancellation('RECEIPT', 'reason');
+
+// Manage tickets
+await cb.tickets.close('TICKET_ID', 'closing comment');
+await cb.tickets.reopen('TICKET_ID', 'reopening reason');
+```
+
+### Shipping API
+
+```typescript
+// List unshipped orders
+const { orders } = await cb.shipping.getUnshipped();
+
+// Mark as shipped
+await cb.shipping.markShipped('RECEIPT', 'ITEM_NO', 'TRACKING_ID', 'USPS');
+```
+
+### Quickstats API
+
+```typescript
+// Get today's stats
+const today = await cb.quickstats.getToday();
+
+// Get daily stats for date range
+const daily = await cb.quickstats.getDailyStats('2024-01-01', '2024-01-31');
+```
+
+### Analytics API
+
+```typescript
+// Get subscription trends
+const trends = await cb.analytics.getSubscriptionTrends({
+  role: 'VENDOR',
+  startDate: '2024-01-01',
+  endDate: '2024-01-31',
+});
+
+// Get product stats
+const stats = await cb.analytics.getVendorProductStats();
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `CLICKBANK_API_KEY` | Your ClickBank API key |
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run CLI in development mode
+bun run dev
+
+# Build for production
+bun run build
+
+# Type check
+bun run typecheck
+```
+
+## License
+
+MIT
+
+## Resources
+
+- [ClickBank API Documentation](https://support.clickbank.com/hc/en-us/articles/220376527-ClickBank-APIs)
+- [ClickBank API Specifications](https://support.clickbank.com/en/articles/10535397-clickbank-api-specifications)
+- [How to Create ClickBank API Keys](https://support.clickbank.com/hc/en-us/articles/360040581831-How-to-Create-ClickBank-API-Keys)

package/connectors/connect-clickbank/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@hasna/connect-clickbank",
+  "version": "0.0.2",
+  "description": "ClickBank API connector CLI - A TypeScript wrapper for the ClickBank API",
+  "type": "module",
+  "bin": {
+    "connect-clickbank": "./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",
+    "build:server": "bun build ./src/server/index.ts --outdir ./server --target bun",
+    "build:all": "bun run build && bun run build:server",
+    "dev": "bun run ./src/cli/index.ts",
+    "dev:server": "bun run ./src/server/index.ts",
+    "start": "bun run ./server/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build:all",
+    "release": "bun run ./scripts/publish.ts",
+    "release:patch": "bun run ./scripts/publish.ts patch",
+    "release:minor": "bun run ./scripts/publish.ts minor",
+    "release:major": "bun run ./scripts/publish.ts major",
+    "release:dry": "bun run ./scripts/publish.ts --dry-run"
+  },
+  "keywords": [
+    "clickbank",
+    "api",
+    "connector",
+    "cli",
+    "typescript",
+    "bun"
+  ],
+  "author": "",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.5",
+    "hono": "^4.11.0"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  }
+}