@hasna/connectors 1.0.4 → 1.0.5

package/connectors/connect-paperform/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-paperform/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/dist/index.js

@@ -3902,6 +3902,244 @@ var CONNECTORS = [
     description: "AI-powered OCR and intelligent document processing",
     category: "AI & ML",
     tags: ["ocr", "ai", "document", "extraction"]
+  },
+  {
+    name: "nasa",
+    displayName: "NASA",
+    description: "NASA open APIs for space data, imagery, and astronomy",
+    category: "Data & Analytics",
+    tags: ["space", "astronomy", "science", "imagery", "api"]
+  },
+  {
+    name: "ncscale",
+    displayName: "ncScale",
+    description: "Database observability and scaling platform for developers",
+    category: "Developer Tools",
+    tags: ["database", "observability", "scaling", "monitoring"]
+  },
+  {
+    name: "nextcloud",
+    displayName: "Nextcloud",
+    description: "Self-hosted file sync, share, and collaboration platform",
+    category: "Business Tools",
+    tags: ["files", "storage", "collaboration", "self-hosted", "cloud"]
+  },
+  {
+    name: "nightfallai",
+    displayName: "Nightfall AI",
+    description: "AI-powered data loss prevention and sensitive data detection",
+    category: "Security & Compliance",
+    tags: ["dlp", "ai", "security", "data-loss-prevention", "compliance"]
+  },
+  {
+    name: "ninox",
+    displayName: "Ninox",
+    description: "No-code database and business application builder",
+    category: "Business Tools",
+    tags: ["no-code", "database", "app-builder", "workflow"]
+  },
+  {
+    name: "nmkr",
+    displayName: "NMKR",
+    description: "NFT minting and Cardano blockchain development tools",
+    category: "Developer Tools",
+    tags: ["nft", "blockchain", "cardano", "crypto", "minting"]
+  },
+  {
+    name: "nocodb",
+    displayName: "NocoDB",
+    description: "Open-source Airtable alternative and spreadsheet-database platform",
+    category: "Database",
+    tags: ["database", "spreadsheet", "no-code", "open-source", "airtable"]
+  },
+  {
+    name: "npm",
+    displayName: "npm",
+    description: "npm registry API for package search, metadata, and downloads",
+    category: "Developer Tools",
+    tags: ["npm", "packages", "registry", "javascript", "nodejs"]
+  },
+  {
+    name: "nuclia",
+    displayName: "Nuclia",
+    description: "AI-powered search and knowledge base API",
+    category: "AI & ML",
+    tags: ["search", "ai", "knowledge-base", "rag", "nlp"]
+  },
+  {
+    name: "nusiiproposals",
+    displayName: "Nusii Proposals",
+    description: "Online proposal software for agencies and freelancers",
+    category: "Business Tools",
+    tags: ["proposals", "freelance", "agency", "sales", "documents"]
+  },
+  {
+    name: "nyckel",
+    displayName: "Nyckel",
+    description: "Machine learning API for image and text classification",
+    category: "AI & ML",
+    tags: ["ml", "classification", "image", "text", "ai"]
+  },
+  {
+    name: "nyota",
+    displayName: "Nyota",
+    description: "AI meeting notes and action item tracking platform",
+    category: "AI & ML",
+    tags: ["meetings", "ai", "notes", "productivity", "transcription"]
+  },
+  {
+    name: "occasion",
+    displayName: "Occasion",
+    description: "Online booking and reservation management for experiences",
+    category: "Business Tools",
+    tags: ["booking", "reservations", "experiences", "scheduling", "events"]
+  },
+  {
+    name: "ocrspace",
+    displayName: "OCR.space",
+    description: "Free and paid OCR API for extracting text from images and PDFs",
+    category: "Developer Tools",
+    tags: ["ocr", "text-extraction", "images", "pdf", "api"]
+  },
+  {
+    name: "octoai",
+    displayName: "OctoAI",
+    description: "Fast AI inference platform for generative AI models",
+    category: "AI & ML",
+    tags: ["ai", "inference", "llm", "generative", "gpu"]
+  },
+  {
+    name: "odoo",
+    displayName: "Odoo",
+    description: "Open-source ERP and business management suite",
+    category: "Business Tools",
+    tags: ["erp", "crm", "accounting", "open-source", "business"]
+  },
+  {
+    name: "offalerts",
+    displayName: "Off Alerts",
+    description: "Price drop and deal alerts for online shopping",
+    category: "Commerce & Finance",
+    tags: ["alerts", "deals", "price-tracking", "shopping", "ecommerce"]
+  },
+  {
+    name: "ollama",
+    displayName: "Ollama",
+    description: "Run large language models locally on your machine",
+    category: "AI & ML",
+    tags: ["llm", "local", "ai", "open-source", "inference"]
+  },
+  {
+    name: "omeda",
+    displayName: "Omeda",
+    description: "Audience management and marketing automation for media companies",
+    category: "Marketing & Sales",
+    tags: ["audience", "marketing", "automation", "media", "crm"]
+  },
+  {
+    name: "omniconvert",
+    displayName: "Omniconvert",
+    description: "Conversion rate optimization and A/B testing platform",
+    category: "Marketing & Sales",
+    tags: ["cro", "ab-testing", "optimization", "conversion", "analytics"]
+  },
+  {
+    name: "omnimind",
+    displayName: "OmniMind",
+    description: "No-code AI assistant builder with custom knowledge bases",
+    category: "AI & ML",
+    tags: ["ai", "chatbot", "no-code", "knowledge-base", "assistant"]
+  },
+  {
+    name: "on2air",
+    displayName: "On2Air",
+    description: "Airtable backup, forms, and automation tools",
+    category: "Business Tools",
+    tags: ["airtable", "backup", "automation", "forms", "database"]
+  },
+  {
+    name: "oneai",
+    displayName: "One AI",
+    description: "Language AI API for text analysis, summarization, and extraction",
+    category: "AI & ML",
+    tags: ["nlp", "ai", "text-analysis", "summarization", "extraction"]
+  },
+  {
+    name: "onesimpleapi",
+    displayName: "One Simple API",
+    description: "Collection of utility APIs for screenshots, PDFs, and web scraping",
+    category: "Developer Tools",
+    tags: ["screenshot", "pdf", "scraping", "utilities", "api"]
+  },
+  {
+    name: "onfleet",
+    displayName: "Onfleet",
+    description: "Last-mile delivery management and route optimization platform",
+    category: "Business Tools",
+    tags: ["delivery", "logistics", "routing", "tracking", "fleet"]
+  },
+  {
+    name: "opencti",
+    displayName: "OpenCTI",
+    description: "Open-source cyber threat intelligence platform",
+    category: "Security & Compliance",
+    tags: ["threat-intelligence", "security", "cti", "open-source", "cyber"]
+  },
+  {
+    name: "openthesaurus",
+    displayName: "OpenThesaurus",
+    description: "German-language thesaurus and synonym lookup API",
+    category: "Developer Tools",
+    tags: ["thesaurus", "synonyms", "german", "language", "nlp"]
+  },
+  {
+    name: "opnformerlyomise",
+    displayName: "Opn (formerly Omise)",
+    description: "Payment gateway and financial services for Southeast Asia",
+    category: "Commerce & Finance",
+    tags: ["payments", "gateway", "fintech", "southeast-asia", "ecommerce"]
+  },
+  {
+    name: "oracledatabase",
+    displayName: "Oracle Database",
+    description: "Oracle Database connectivity and SQL query execution",
+    category: "Database",
+    tags: ["oracle", "database", "sql", "enterprise", "relational"]
+  },
+  {
+    name: "orbit",
+    displayName: "Orbit",
+    description: "Community growth and developer relations management platform",
+    category: "Marketing & Sales",
+    tags: ["community", "devrel", "developer-relations", "growth", "analytics"]
+  },
+  {
+    name: "orderdesk",
+    displayName: "Order Desk",
+    description: "Order management and fulfillment automation for ecommerce",
+    category: "Commerce & Finance",
+    tags: ["orders", "fulfillment", "ecommerce", "automation", "inventory"]
+  },
+  {
+    name: "ortto",
+    displayName: "Ortto",
+    description: "Customer data platform and marketing automation tool",
+    category: "Marketing & Sales",
+    tags: ["cdp", "marketing", "automation", "analytics", "email"]
+  },
+  {
+    name: "oura",
+    displayName: "Oura",
+    description: "Oura Ring health and sleep tracking data API",
+    category: "Healthcare & Hospitality",
+    tags: ["health", "sleep", "wearable", "fitness", "biometrics"]
+  },
+  {
+    name: "paperform",
+    displayName: "Paperform",
+    description: "Online form builder and payment collection platform",
+    category: "Business Tools",
+    tags: ["forms", "payments", "surveys", "builder", "no-code"]
   }
 ];
 function getConnectorsByCategory(category) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {