@hasna/connectors 1.1.0 → 1.1.1

package/connectors/connect-zulip/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-zulip/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

@@ -5484,6 +5484,440 @@ var CONNECTORS = [
     description: "Multi-channel customer communication platform for managing conversations at scale",
     category: "Communication",
     tags: ["customer communication", "multi-channel", "inbox", "support", "messaging"]
+  },
+  {
+    name: "trevorio",
+    displayName: "Trevorio",
+    description: "Project management and team collaboration platform",
+    category: "Business Tools",
+    tags: ["project-management", "tasks", "collaboration"]
+  },
+  {
+    name: "turbohire",
+    displayName: "TurboHire",
+    description: "AI-powered recruitment and applicant tracking system",
+    category: "Business Tools",
+    tags: ["hr", "recruiting", "ats", "ai"]
+  },
+  {
+    name: "tuskr",
+    displayName: "Tuskr",
+    description: "Test case management and QA platform",
+    category: "Developer Tools",
+    tags: ["testing", "qa", "test-management"]
+  },
+  {
+    name: "tuulio",
+    displayName: "Tuulio",
+    description: "AI chatbot and customer engagement platform",
+    category: "Communication",
+    tags: ["chatbot", "ai", "engagement"]
+  },
+  {
+    name: "twake",
+    displayName: "Twake",
+    description: "Open-source collaborative workspace with chat and file sharing",
+    category: "Communication",
+    tags: ["collaboration", "chat", "open-source"]
+  },
+  {
+    name: "twist",
+    displayName: "Twist",
+    description: "Async team communication with threads and channels",
+    category: "Communication",
+    tags: ["async", "messaging", "threads"]
+  },
+  {
+    name: "udio",
+    displayName: "Udio",
+    description: "AI music generation platform",
+    category: "AI & ML",
+    tags: ["ai", "music", "generation"]
+  },
+  {
+    name: "unbounce",
+    displayName: "Unbounce",
+    description: "Landing page builder and conversion optimization",
+    category: "Marketing & Sales",
+    tags: ["landing-pages", "conversion", "marketing"]
+  },
+  {
+    name: "unisender",
+    displayName: "UniSender",
+    description: "Email and SMS marketing platform",
+    category: "Communication",
+    tags: ["email", "sms", "marketing"]
+  },
+  {
+    name: "unleashedsoftware",
+    displayName: "Unleashed Software",
+    description: "Inventory management and manufacturing software",
+    category: "Business Tools",
+    tags: ["inventory", "manufacturing", "erp"]
+  },
+  {
+    name: "upkeep",
+    displayName: "UpKeep",
+    description: "Asset and maintenance management (CMMS)",
+    category: "Business Tools",
+    tags: ["maintenance", "assets", "cmms"]
+  },
+  {
+    name: "uplead",
+    displayName: "UpLead",
+    description: "B2B lead generation and contact data platform",
+    category: "Marketing & Sales",
+    tags: ["leads", "b2b", "prospecting"]
+  },
+  {
+    name: "uproc",
+    displayName: "uProc",
+    description: "Data processing and enrichment tools",
+    category: "Data & Analytics",
+    tags: ["data", "enrichment", "processing"]
+  },
+  {
+    name: "uptimetoolbox",
+    displayName: "Uptime Toolbox",
+    description: "Website uptime and performance monitoring",
+    category: "Developer Tools",
+    tags: ["monitoring", "uptime", "performance"]
+  },
+  {
+    name: "urlscanio",
+    displayName: "urlscan.io",
+    description: "Website scanning and threat analysis",
+    category: "Security & Compliance",
+    tags: ["security", "scanning", "threat-intelligence"]
+  },
+  {
+    name: "uservoice",
+    displayName: "UserVoice",
+    description: "Product feedback and customer insight platform",
+    category: "Business Tools",
+    tags: ["feedback", "product", "customer-insights"]
+  },
+  {
+    name: "verifalia",
+    displayName: "Verifalia",
+    description: "Email address validation and verification service",
+    category: "Marketing & Sales",
+    tags: ["email", "validation", "verification"]
+  },
+  {
+    name: "vero",
+    displayName: "Vero",
+    description: "Behavioral email marketing and automation",
+    category: "Communication",
+    tags: ["email", "marketing", "automation"]
+  },
+  {
+    name: "vimeo",
+    displayName: "Vimeo",
+    description: "Video hosting, management, and streaming",
+    category: "Design & Content",
+    tags: ["video", "hosting", "streaming"]
+  },
+  {
+    name: "virustotal",
+    displayName: "VirusTotal",
+    description: "File and URL malware scanning and threat intelligence",
+    category: "Security & Compliance",
+    tags: ["security", "malware", "threat-intelligence"]
+  },
+  {
+    name: "vivifyscrum",
+    displayName: "VivifyScrum",
+    description: "Agile project management with Scrum and Kanban boards",
+    category: "Business Tools",
+    tags: ["agile", "scrum", "kanban"]
+  },
+  {
+    name: "voicit",
+    displayName: "Voicit",
+    description: "AI meeting transcription and note-taking",
+    category: "AI & ML",
+    tags: ["transcription", "meetings", "ai"]
+  },
+  {
+    name: "vowel",
+    displayName: "Vowel",
+    description: "Video meetings with built-in transcription and summaries",
+    category: "Communication",
+    tags: ["meetings", "video", "transcription"]
+  },
+  {
+    name: "watchsignals",
+    displayName: "WatchSignals",
+    description: "Luxury watch market data and price tracking",
+    category: "Data & Analytics",
+    tags: ["watches", "market-data", "prices"]
+  },
+  {
+    name: "wavelineextract",
+    displayName: "Waveline Extract",
+    description: "Document data extraction and parsing",
+    category: "AI & ML",
+    tags: ["extraction", "documents", "parsing"]
+  },
+  {
+    name: "webexbycisco",
+    displayName: "Webex by Cisco",
+    description: "Video conferencing, messaging, and team collaboration",
+    category: "Communication",
+    tags: ["video", "conferencing", "collaboration"]
+  },
+  {
+    name: "webinarjam",
+    displayName: "WebinarJam",
+    description: "Live webinar hosting and streaming platform",
+    category: "Communication",
+    tags: ["webinar", "streaming", "events"]
+  },
+  {
+    name: "webscraperio",
+    displayName: "WebScraper.io",
+    description: "Web scraping and data extraction cloud service",
+    category: "Data & Analytics",
+    tags: ["scraping", "data", "extraction"]
+  },
+  {
+    name: "wekan",
+    displayName: "Wekan",
+    description: "Open-source Kanban board for task management",
+    category: "Business Tools",
+    tags: ["kanban", "open-source", "tasks"]
+  },
+  {
+    name: "whal3s",
+    displayName: "Whal3s",
+    description: "NFT utility and Web3 engagement platform",
+    category: "Commerce & Finance",
+    tags: ["nft", "web3", "blockchain"]
+  },
+  {
+    name: "whatconverts",
+    displayName: "WhatConverts",
+    description: "Lead tracking and marketing attribution platform",
+    category: "Marketing & Sales",
+    tags: ["leads", "tracking", "attribution"]
+  },
+  {
+    name: "wikipedia",
+    displayName: "Wikipedia",
+    description: "Free encyclopedia with article search and content retrieval",
+    category: "Data & Analytics",
+    tags: ["encyclopedia", "knowledge", "search"]
+  },
+  {
+    name: "wipo",
+    displayName: "WIPO",
+    description: "World Intellectual Property Organization - patents, trademarks, and IP data",
+    category: "Patents & IP",
+    tags: ["patents", "trademarks", "ip", "wipo"]
+  },
+  {
+    name: "wizychat",
+    displayName: "WizyChat",
+    description: "AI chatbot builder for customer support",
+    category: "Communication",
+    tags: ["chatbot", "ai", "support"]
+  },
+  {
+    name: "wolframoralpha",
+    displayName: "Wolfram Alpha",
+    description: "Computational knowledge engine and math solver",
+    category: "Data & Analytics",
+    tags: ["knowledge", "math", "computation"]
+  },
+  {
+    name: "wonderchat",
+    displayName: "Wonderchat",
+    description: "AI chatbot builder from website content",
+    category: "AI & ML",
+    tags: ["chatbot", "ai", "knowledge-base"]
+  },
+  {
+    name: "wondercraft",
+    displayName: "Wondercraft",
+    description: "AI-powered podcast and audio content creation",
+    category: "AI & ML",
+    tags: ["ai", "podcast", "audio"]
+  },
+  {
+    name: "woocommerce",
+    displayName: "WooCommerce",
+    description: "WordPress e-commerce plugin for orders, products, and customers",
+    category: "Commerce & Finance",
+    tags: ["ecommerce", "wordpress", "orders"]
+  },
+  {
+    name: "woodpeckerco",
+    displayName: "Woodpecker.co",
+    description: "Cold email outreach and follow-up automation",
+    category: "Marketing & Sales",
+    tags: ["email", "outreach", "sales"]
+  },
+  {
+    name: "wordpress",
+    displayName: "WordPress",
+    description: "CMS posts, pages, media, and site management",
+    category: "Design & Content",
+    tags: ["cms", "blogging", "website"]
+  },
+  {
+    name: "workast",
+    displayName: "Workast",
+    description: "Task management integrated with Slack",
+    category: "Business Tools",
+    tags: ["tasks", "slack", "productivity"]
+  },
+  {
+    name: "workboard",
+    displayName: "Workboard",
+    description: "OKR and strategy execution platform",
+    category: "Business Tools",
+    tags: ["okr", "strategy", "goals"]
+  },
+  {
+    name: "woxo",
+    displayName: "WOXO",
+    description: "AI video creation from text and templates",
+    category: "AI & ML",
+    tags: ["ai", "video", "generation"]
+  },
+  {
+    name: "writesonic",
+    displayName: "Writesonic",
+    description: "AI writing and content generation platform",
+    category: "AI & ML",
+    tags: ["ai", "writing", "content"]
+  },
+  {
+    name: "wubookratechecker",
+    displayName: "Wu Bookrate Checker",
+    description: "Book rating and review data lookup",
+    category: "Data & Analytics",
+    tags: ["books", "ratings", "data"]
+  },
+  {
+    name: "xata",
+    displayName: "Xata",
+    description: "Serverless database with search and analytics",
+    category: "Developer Tools",
+    tags: ["database", "search", "serverless"]
+  },
+  {
+    name: "xero",
+    displayName: "Xero",
+    description: "Accounting, invoicing, and financial management",
+    category: "Commerce & Finance",
+    tags: ["accounting", "invoicing", "finance"]
+  },
+  {
+    name: "xtractly",
+    displayName: "Xtractly",
+    description: "AI document data extraction and automation",
+    category: "AI & ML",
+    tags: ["ai", "extraction", "documents"]
+  },
+  {
+    name: "ybug",
+    displayName: "Ybug",
+    description: "Visual bug reporting and user feedback tool",
+    category: "Developer Tools",
+    tags: ["bug-reporting", "feedback", "testing"]
+  },
+  {
+    name: "ycode",
+    displayName: "Ycode",
+    description: "No-code website builder with CMS",
+    category: "Developer Tools",
+    tags: ["no-code", "website", "cms"]
+  },
+  {
+    name: "yodiz",
+    displayName: "Yodiz",
+    description: "Agile project management and issue tracking",
+    category: "Business Tools",
+    tags: ["agile", "issues", "project-management"]
+  },
+  {
+    name: "yourls",
+    displayName: "YOURLS",
+    description: "Self-hosted URL shortener and link management",
+    category: "Developer Tools",
+    tags: ["url-shortener", "links", "self-hosted"]
+  },
+  {
+    name: "zabbix",
+    displayName: "Zabbix",
+    description: "Enterprise network and infrastructure monitoring",
+    category: "Developer Tools",
+    tags: ["monitoring", "infrastructure", "network"]
+  },
+  {
+    name: "zammad",
+    displayName: "Zammad",
+    description: "Open-source helpdesk and customer support ticketing",
+    category: "Business Tools",
+    tags: ["helpdesk", "tickets", "support", "open-source"]
+  },
+  {
+    name: "zenrows",
+    displayName: "ZenRows",
+    description: "Web scraping API with anti-bot bypass",
+    category: "Data & Analytics",
+    tags: ["scraping", "data", "api"]
+  },
+  {
+    name: "zohobooks",
+    displayName: "Zoho Books",
+    description: "Online accounting and financial management",
+    category: "Commerce & Finance",
+    tags: ["accounting", "invoicing", "zoho"]
+  },
+  {
+    name: "zohocrm",
+    displayName: "Zoho CRM",
+    description: "CRM for sales, marketing, and customer support",
+    category: "Business Tools",
+    tags: ["crm", "sales", "zoho"]
+  },
+  {
+    name: "zohodesk",
+    displayName: "Zoho Desk",
+    description: "Customer support and helpdesk platform",
+    category: "Business Tools",
+    tags: ["helpdesk", "support", "zoho"]
+  },
+  {
+    name: "zohoworkdrive",
+    displayName: "Zoho WorkDrive",
+    description: "Team file storage and collaboration",
+    category: "Business Tools",
+    tags: ["storage", "files", "zoho"]
+  },
+  {
+    name: "zonkafeedback",
+    displayName: "Zonka Feedback",
+    description: "Customer feedback and survey platform",
+    category: "Business Tools",
+    tags: ["feedback", "surveys", "cx"]
+  },
+  {
+    name: "zscalerzia",
+    displayName: "Zscaler ZIA",
+    description: "Cloud-native internet access and security gateway",
+    category: "Security & Compliance",
+    tags: ["security", "cloud", "gateway", "zscaler"]
+  },
+  {
+    name: "zulip",
+    displayName: "Zulip",
+    description: "Open-source team chat with threaded conversations",
+    category: "Communication",
+    tags: ["chat", "messaging", "open-source", "threads"]
   }
 ];
 function getConnectorsByCategory(category) {

package/package.json

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