@bpmnkit/connector-gen 0.0.7 → 0.0.11

package/README.md

@@ -6,6 +6,8 @@
   [![npm](https://img.shields.io/npm/v/@bpmnkit/connector-gen?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/connector-gen)
   [![license](https://img.shields.io/npm/l/@bpmnkit/connector-gen?style=flat-square)](https://github.com/bpmnkit/monorepo/blob/main/LICENSE)
   [![typescript](https://img.shields.io/badge/TypeScript-strict-6244d7?style=flat-square&logo=typescript&logoColor=white)](https://github.com/bpmnkit/monorepo)
+  [![ai-assisted](https://img.shields.io/badge/AI--assisted-claude-8b5cf6?style=flat-square)](https://github.com/bpmnkit/monorepo)
+  [![experimental](https://img.shields.io/badge/status-experimental-f59e0b?style=flat-square)](https://github.com/bpmnkit/monorepo)
 
   [Website](https://bpmnkit.com) · [Documentation](https://docs.bpmnkit.com) · [GitHub](https://github.com/bpmnkit/monorepo) · [Changelog](https://github.com/bpmnkit/monorepo/blob/main/packages/connector-gen/CHANGELOG.md)
 </div>
@@ -86,6 +88,11 @@ interface GenerateOptions {
 | [`@bpmnkit/operate`](https://www.npmjs.com/package/@bpmnkit/operate) | Monitoring & operations frontend for Camunda clusters |
 | [`@bpmnkit/cli`](https://www.npmjs.com/package/@bpmnkit/cli) | Camunda 8 command-line interface (casen) |
 | [`@bpmnkit/proxy`](https://www.npmjs.com/package/@bpmnkit/proxy) | Local AI bridge and Camunda API proxy server |
+| [`@bpmnkit/cli-sdk`](https://www.npmjs.com/package/@bpmnkit/cli-sdk) | Plugin authoring SDK for the casen CLI |
+| [`@bpmnkit/create-casen-plugin`](https://www.npmjs.com/package/@bpmnkit/create-casen-plugin) | Scaffold a new casen CLI plugin in seconds |
+| [`@bpmnkit/casen-report`](https://www.npmjs.com/package/@bpmnkit/casen-report) | HTML reports from Camunda 8 incident and SLA data |
+| [`@bpmnkit/casen-worker-http`](https://www.npmjs.com/package/@bpmnkit/casen-worker-http) | Example HTTP worker plugin — completes jobs with live JSONPlaceholder API data |
+| [`@bpmnkit/casen-worker-ai`](https://www.npmjs.com/package/@bpmnkit/casen-worker-ai) | AI task worker — classify, summarize, extract, and decide using Claude |
 
 ## License
 

package/dist/browser.d.ts

@@ -9,7 +9,7 @@
  * @packageDocumentation
  */
 export { buildTemplate, buildTemplates } from "./build-template.js";
-export { CATALOG, getCatalogEntry } from "./catalog.js";
+export { CATALOG, getCatalogEntry, getCatalogIconUri } from "./catalog.js";
 export type { CatalogEntry } from "./catalog.js";
 export { detectDefaultAuth, getBaseUrl, getOperations, getServers, isRef, parseOpenApi, resolve, resolveRef, } from "./parse-openapi.js";
 export type { DetectedAuth } from "./parse-openapi.js";

package/dist/browser.js

@@ -9,11 +9,11 @@
  * @packageDocumentation
  */
 export { buildTemplate, buildTemplates } from "./build-template.js";
-export { CATALOG, getCatalogEntry } from "./catalog.js";
+export { CATALOG, getCatalogEntry, getCatalogIconUri } from "./catalog.js";
 export { detectDefaultAuth, getBaseUrl, getOperations, getServers, isRef, parseOpenApi, resolve, resolveRef, } from "./parse-openapi.js";
 export { CONNECTOR_SCHEMA } from "./types.js";
 import { buildTemplates } from "./build-template.js";
-import { CATALOG, getCatalogEntry } from "./catalog.js";
+import { CATALOG, getCatalogEntry, getCatalogIconUri } from "./catalog.js";
 import { detectDefaultAuth, getOperations, parseOpenApi } from "./parse-openapi.js";
 /**
  * Parse an OpenAPI spec (string or object) and generate connector templates.
@@ -47,6 +47,7 @@ export async function generateFromCatalog(id, overrides = {}) {
     const opts = {
         idPrefix: overrides.idPrefix ?? entry.idPrefix,
         defaultAuthType: overrides.defaultAuthType ?? entry.defaultAuth,
+        icon: overrides.icon ?? getCatalogIconUri(id),
         ...overrides,
     };
     const { templates } = await generateFromUrl(entry.url, opts);

package/dist/build-template.js

@@ -505,6 +505,7 @@ export function buildTemplate(op, opts) {
         elementType: { value: "bpmn:ServiceTask" },
         groups,
         properties,
+        ...(opts.icon ? { icon: { contents: opts.icon } } : {}),
     };
 }
 export function buildTemplates(ops, opts) {

package/dist/catalog.d.ts

@@ -10,4 +10,9 @@ export interface CatalogEntry {
 }
 export declare const CATALOG: CatalogEntry[];
 export declare function getCatalogEntry(id: string): CatalogEntry | undefined;
+/**
+ * Returns a base64 SVG data URI icon for a catalog entry — a rounded square
+ * in the brand's primary color with the first letter of the service name.
+ */
+export declare function getCatalogIconUri(id: string): string | undefined;
 //# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.js

@@ -239,8 +239,645 @@ export const CATALOG = [
         idPrefix: "com.brex",
         defaultAuth: "oauth-client-credentials-flow",
     },
+    {
+        id: "box",
+        name: "Box API",
+        description: "Upload, download, organize, and share files and folders via the Box cloud storage platform",
+        url: "https://raw.githubusercontent.com/box/box-openapi/main/openapi.json",
+        idPrefix: "com.box",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "spotify",
+        name: "Spotify Web API",
+        description: "Search tracks, manage playlists, control playback, and read user libraries on Spotify",
+        url: "https://api.apis.guru/v2/specs/spotify.com/sonallux/2023.2.27/openapi.json",
+        idPrefix: "com.spotify",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "gitlab",
+        name: "GitLab API",
+        description: "Manage GitLab repositories, CI/CD pipelines, merge requests, issues, and users",
+        url: "https://api.apis.guru/v2/specs/gitlab.com/v3/swagger.json",
+        idPrefix: "com.gitlab",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "netlify",
+        name: "Netlify API",
+        description: "Deploy sites, manage builds, configure domains, and handle forms on Netlify",
+        url: "https://api.apis.guru/v2/specs/netlify.com/2.15.0/swagger.json",
+        idPrefix: "com.netlify",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "launchdarkly",
+        name: "LaunchDarkly API",
+        description: "Create and manage feature flags, experiments, segments, and environments",
+        url: "https://api.apis.guru/v2/specs/launchdarkly.com/5.3.0/swagger.json",
+        idPrefix: "com.launchdarkly",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "postmark",
+        name: "Postmark API",
+        description: "Send and track transactional emails, manage templates and bounce handling via Postmark",
+        url: "https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/swagger.json",
+        idPrefix: "com.postmark",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "circleci",
+        name: "CircleCI API",
+        description: "Trigger pipelines, inspect workflows and jobs, and manage contexts and SSH keys",
+        url: "https://api.apis.guru/v2/specs/circleci.com/v1/openapi.json",
+        idPrefix: "com.circleci",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "grafana",
+        name: "Grafana API",
+        description: "Manage dashboards, alerts, datasources, users, and annotations in Grafana",
+        url: "https://raw.githubusercontent.com/grafana/grafana/main/public/openapi3.json",
+        idPrefix: "com.grafana",
+        defaultAuth: "basic",
+    },
+    {
+        id: "digitalocean",
+        name: "DigitalOcean API",
+        description: "Provision Droplets, Kubernetes clusters, databases, load balancers, and networking",
+        url: "https://api.apis.guru/v2/specs/digitalocean.com/2.0/openapi.json",
+        idPrefix: "com.digitalocean",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "linode",
+        name: "Linode (Akamai) API",
+        description: "Manage cloud compute instances, volumes, Kubernetes clusters, and DNS via Linode",
+        url: "https://api.apis.guru/v2/specs/linode.com/4.145.0/openapi.json",
+        idPrefix: "com.linode",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "square",
+        name: "Square API",
+        description: "Process payments, manage orders, catalog items, and bookings via Square",
+        url: "https://api.apis.guru/v2/specs/squareup.com/2.0/openapi.json",
+        idPrefix: "com.squareup",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "zendesk",
+        name: "Zendesk Support API",
+        description: "Manage support tickets, users, macros, triggers, and SLAs in Zendesk",
+        url: "https://developer.zendesk.com/zendesk/oas.yaml",
+        idPrefix: "com.zendesk",
+        defaultAuth: "basic",
+    },
+    {
+        id: "bitbucket",
+        name: "Bitbucket API",
+        description: "Manage Bitbucket repositories, pull requests, pipelines, and deployments",
+        url: "https://api.apis.guru/v2/specs/bitbucket.org/2.0/openapi.yaml",
+        idPrefix: "org.bitbucket",
+        defaultAuth: "basic",
+    },
+    {
+        id: "miro",
+        name: "Miro API",
+        description: "Create and manage Miro boards, frames, sticky notes, and collaborative widgets",
+        url: "https://raw.githubusercontent.com/miroapp/api-clients/main/packages/generator/spec.json",
+        idPrefix: "com.miro",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "okta",
+        name: "Okta Management API",
+        description: "Manage users, groups, applications, policies, and identity providers via Okta",
+        url: "https://raw.githubusercontent.com/okta/okta-management-openapi-spec/master/dist/current/management-oneOfInheritance.yaml",
+        idPrefix: "com.okta",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "meraki",
+        name: "Cisco Meraki API",
+        description: "Manage cloud-controlled Wi-Fi, switches, security cameras, and network policies",
+        url: "https://api.apis.guru/v2/specs/meraki.com/0.0.0-streaming/openapi.json",
+        idPrefix: "com.meraki",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "docker",
+        name: "Docker Hub API",
+        description: "Manage container image repositories, tags, webhooks, and access tokens on Docker Hub",
+        url: "https://api.apis.guru/v2/specs/docker.com/hub/beta/openapi.json",
+        idPrefix: "com.docker",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "kubernetes",
+        name: "Kubernetes API",
+        description: "Manage pods, deployments, services, config maps, and cluster resources via the Kubernetes API",
+        url: "https://api.apis.guru/v2/specs/kubernetes.io/unversioned/swagger.json",
+        idPrefix: "io.kubernetes",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "freshdesk",
+        name: "Freshdesk API",
+        description: "Manage support tickets, contacts, agents, and knowledge base articles in Freshdesk",
+        url: "https://raw.githubusercontent.com/ccl-consulting/freshdesk-openapi-definitions/main/swagger.yaml",
+        idPrefix: "com.freshdesk",
+        defaultAuth: "basic",
+    },
+    {
+        id: "dropbox",
+        name: "Dropbox API",
+        description: "Upload, download, share, and manage files and folders in Dropbox cloud storage",
+        url: "https://api.apis.guru/v2/specs/dropbox.com/2/openapi.yaml",
+        idPrefix: "com.dropbox",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "xero",
+        name: "Xero Accounting API",
+        description: "Manage invoices, contacts, bank accounts, and financial reporting in Xero",
+        url: "https://raw.githubusercontent.com/XeroAPI/Xero-OpenAPI/master/xero_accounting.yaml",
+        idPrefix: "com.xero",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "bigcommerce",
+        name: "BigCommerce Catalog API",
+        description: "Manage products, categories, brands, and variants in a BigCommerce store",
+        url: "https://raw.githubusercontent.com/bigcommerce/api-specs/main/reference/catalog/products_catalog.v3.yml",
+        idPrefix: "com.bigcommerce",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "recurly",
+        name: "Recurly Billing API",
+        description: "Manage subscriptions, accounts, invoices, and billing for recurring revenue",
+        url: "https://raw.githubusercontent.com/recurly/recurly-client-node/master/openapi/api.yaml",
+        idPrefix: "com.recurly",
+        defaultAuth: "basic",
+    },
+    {
+        id: "cohere",
+        name: "Cohere AI API",
+        description: "Access Cohere language AI models for chat, embeddings, and reranking",
+        url: "https://raw.githubusercontent.com/cohere-ai/cohere-developer-experience/main/cohere-openapi.yaml",
+        idPrefix: "com.cohere",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "algolia",
+        name: "Algolia Search API",
+        description: "Search, configure indices, and manage records in Algolia",
+        url: "https://raw.githubusercontent.com/algolia/api-clients-automation/main/docs/bundled/search.yml",
+        idPrefix: "com.algolia",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "replicate",
+        name: "Replicate API",
+        description: "Run open-source machine learning models in the cloud via API",
+        url: "https://api.replicate.com/openapi.json",
+        idPrefix: "com.replicate",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "mixpanel",
+        name: "Mixpanel Ingestion API",
+        description: "Track events and update user profiles in Mixpanel for product analytics",
+        url: "https://raw.githubusercontent.com/mixpanel/docs/main/openapi/src/ingestion.openapi.yaml",
+        idPrefix: "com.mixpanel",
+        defaultAuth: "basic",
+    },
+    {
+        id: "trello",
+        name: "Trello API",
+        description: "Create and manage Trello boards, lists, cards, and team collaboration",
+        url: "https://api.apis.guru/v2/specs/trello.com/1.0/openapi.json",
+        idPrefix: "com.trello",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "confluence",
+        name: "Confluence Cloud REST API",
+        description: "Create, read, update, and manage pages, spaces, and content in Atlassian Confluence",
+        url: "https://dac-static.atlassian.com/cloud/confluence/swagger.v3.json",
+        idPrefix: "io.atlassian.confluence",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "pipedrive",
+        name: "Pipedrive CRM API",
+        description: "Manage deals, contacts, pipelines, and sales activities in Pipedrive CRM",
+        url: "https://developers.pipedrive.com/docs/api/v1/openapi.yaml",
+        idPrefix: "com.pipedrive",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "adyen",
+        name: "Adyen Checkout API",
+        description: "Initiate and authorise online payments through the Adyen payment platform",
+        url: "https://raw.githubusercontent.com/Adyen/adyen-openapi/master/yaml/CheckoutService-v71.yaml",
+        idPrefix: "com.adyen",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "twilio-voice",
+        name: "Twilio Voice API",
+        description: "Make, receive, and control phone calls programmatically using Twilio Voice",
+        url: "https://raw.githubusercontent.com/twilio/twilio-oai/main/spec/json/twilio_voice_v1.json",
+        idPrefix: "io.twilio.voice",
+        defaultAuth: "basic",
+    },
+    {
+        id: "paddle",
+        name: "Paddle Billing API",
+        description: "Manage subscriptions, payments, customers, and transactions with Paddle",
+        url: "https://raw.githubusercontent.com/PaddleHQ/paddle-openapi/main/v1/openapi.yaml",
+        idPrefix: "com.paddle",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "lob",
+        name: "Lob API",
+        description: "Send physical mail — letters, postcards, and checks — programmatically via API",
+        url: "https://raw.githubusercontent.com/lob/lob-openapi/main/lob-api-public.yml",
+        idPrefix: "com.lob",
+        defaultAuth: "basic",
+    },
+    {
+        id: "deepl",
+        name: "DeepL Translation API",
+        description: "Translate text and documents into 30+ languages using DeepL neural machine translation",
+        url: "https://raw.githubusercontent.com/DeepLcom/openapi/main/openapi.yaml",
+        idPrefix: "com.deepl",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "docusign",
+        name: "DocuSign eSignature API",
+        description: "Send, sign, and manage electronic signature agreements and envelopes",
+        url: "https://raw.githubusercontent.com/docusign/OpenAPI-Specifications/master/esignature.rest.swagger-v2.1.json",
+        idPrefix: "com.docusign",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "chargebee",
+        name: "Chargebee Billing API",
+        description: "Manage subscriptions, invoices, customers, and revenue operations with Chargebee",
+        url: "https://raw.githubusercontent.com/chargebee/openapi/master/spec/chargebee_api_v2_pc_v1_spec.json",
+        idPrefix: "com.chargebee",
+        defaultAuth: "basic",
+    },
+    {
+        id: "twilio-video",
+        name: "Twilio Video API",
+        description: "Build real-time video and audio communication features using Twilio Video",
+        url: "https://raw.githubusercontent.com/twilio/twilio-oai/main/spec/json/twilio_video_v1.json",
+        idPrefix: "io.twilio.video",
+        defaultAuth: "basic",
+    },
+    {
+        id: "cloudinary",
+        name: "Cloudinary Media API",
+        description: "Upload, transform, optimize, and deliver images and videos via the Cloudinary platform",
+        url: "https://raw.githubusercontent.com/cloudinary/account-provisioning-java/master/api/openapi.yaml",
+        idPrefix: "com.cloudinary",
+        defaultAuth: "basic",
+    },
+    {
+        id: "amplitude",
+        name: "Amplitude Analytics API",
+        description: "Track events, query analytics data, and manage user cohorts in Amplitude",
+        url: "https://raw.githubusercontent.com/amplitude/amplitude-docs/main/content/collections/api/en/session-replay-openapi.yaml",
+        idPrefix: "com.amplitude",
+        defaultAuth: "basic",
+    },
+    {
+        id: "mollie",
+        name: "Mollie Payments API",
+        description: "European payment gateway for accepting online payments via cards, iDEAL, SEPA, and other methods",
+        url: "https://raw.githubusercontent.com/mollie/openapi/main/specs.yaml",
+        idPrefix: "com.mollie",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "quickbooks-online",
+        name: "QuickBooks Online API",
+        description: "Manage invoices, payments, expenses, and financial data in QuickBooks Online",
+        url: "https://raw.githubusercontent.com/ballerina-platform/openapi-connectors/main/openapi/quickbooks.online/openapi.yaml",
+        idPrefix: "com.intuit.quickbooks",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "servicenow",
+        name: "ServiceNow API",
+        description: "IT service management for incidents, changes, requests, and CMDB operations",
+        url: "https://raw.githubusercontent.com/ballerina-platform/openapi-connectors/main/openapi/servicenow/openapi.yaml",
+        idPrefix: "com.servicenow",
+        defaultAuth: "basic",
+    },
+    {
+        id: "telegram-bot",
+        name: "Telegram Bot API",
+        description: "Build Telegram bots — send messages, manage chats, handle updates and inline queries",
+        url: "https://raw.githubusercontent.com/APIs-guru/openapi-directory/main/APIs/telegram.org/5.0.0/openapi.yaml",
+        idPrefix: "org.telegram",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "clickup",
+        name: "ClickUp API",
+        description: "Project management platform for tasks, spaces, lists, docs, goals, and time tracking",
+        url: "https://raw.githubusercontent.com/APIs-guru/openapi-directory/main/APIs/clickup.com/1.0.0/openapi.yaml",
+        idPrefix: "com.clickup",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "webflow",
+        name: "Webflow API",
+        description: "Manage Webflow sites, CMS collections, pages, forms, and ecommerce orders",
+        url: "https://raw.githubusercontent.com/webflow/openapi-spec/main/openapi/v2.yml",
+        idPrefix: "com.webflow",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "activecampaign",
+        name: "ActiveCampaign API",
+        description: "Email marketing and CRM automation for contacts, campaigns, automations, and deals",
+        url: "https://raw.githubusercontent.com/ballerina-platform/openapi-connectors/main/openapi/activecampaign/openapi.yaml",
+        idPrefix: "com.activecampaign",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "zoho-crm",
+        name: "Zoho CRM API",
+        description: "Manage leads, contacts, accounts, deals, and sales pipelines in Zoho CRM",
+        url: "https://raw.githubusercontent.com/ballerina-platform/openapi-connectors/main/openapi/zoho.crm.rest/openapi.yaml",
+        idPrefix: "com.zoho.crm",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "influxdb",
+        name: "InfluxDB API",
+        description: "Write, query, and manage time-series metrics and monitoring data in InfluxDB",
+        url: "https://raw.githubusercontent.com/APIs-guru/openapi-directory/main/APIs/influxdata.com/2.0.0/openapi.yaml",
+        idPrefix: "com.influxdata",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "telnyx",
+        name: "Telnyx API",
+        description: "Cloud communications platform for programmable voice, SMS, fax, and number management",
+        url: "https://raw.githubusercontent.com/APIs-guru/openapi-directory/main/APIs/telnyx.com/2.0.0/openapi.yaml",
+        idPrefix: "com.telnyx",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "bamboohr",
+        name: "BambooHR API",
+        description: "HR software for employee records, time-off requests, onboarding, and performance management",
+        url: "https://raw.githubusercontent.com/konfig-sdks/openapi-examples/main/bamboohr/openapi.yaml",
+        idPrefix: "com.bamboohr",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "gusto",
+        name: "Gusto Payroll API",
+        description: "Payroll and HR platform for managing employees, payroll runs, benefits, and tax filings",
+        url: "https://raw.githubusercontent.com/konfig-sdks/openapi-examples/main/gusto/embedded-payroll/openapi.yaml",
+        idPrefix: "com.gusto",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "copper-crm",
+        name: "Copper CRM API",
+        description: "Google Workspace-native CRM for managing leads, people, companies, and opportunities",
+        url: "https://raw.githubusercontent.com/konfig-sdks/openapi-examples/main/copper/openapi.yaml",
+        idPrefix: "com.copper",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "vonage-sms",
+        name: "Vonage SMS API",
+        description: "Send and receive SMS messages globally via the Vonage (Nexmo) messaging platform",
+        url: "https://raw.githubusercontent.com/APIs-guru/openapi-directory/main/APIs/nexmo.com/sms/1.2.0/openapi.yaml",
+        idPrefix: "com.vonage",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "personio",
+        name: "Personio HR API",
+        description: "European HR platform for employee data, attendance, absences, and recruiting",
+        url: "https://raw.githubusercontent.com/APIs-guru/openapi-directory/main/APIs/personio.de/personnel/1.0/openapi.yaml",
+        idPrefix: "de.personio",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "weatherbit",
+        name: "Weatherbit API",
+        description: "Current weather, forecasts, historical data, and severe weather alerts worldwide",
+        url: "https://raw.githubusercontent.com/APIs-guru/openapi-directory/main/APIs/weatherbit.io/2.0.0/swagger.yaml",
+        idPrefix: "io.weatherbit",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "magento",
+        name: "Adobe Commerce (Magento) API",
+        description: "E-commerce platform for products, orders, customers, inventory, and checkout",
+        url: "https://raw.githubusercontent.com/APIs-guru/openapi-directory/main/APIs/magento.com/2.2.10/openapi.yaml",
+        idPrefix: "com.magento",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "zoho-books",
+        name: "Zoho Books API",
+        description: "Online accounting for invoices, expenses, bank reconciliation, and financial reports",
+        url: "https://raw.githubusercontent.com/ballerina-platform/openapi-connectors/main/openapi/zoho.books/openapi.yaml",
+        idPrefix: "com.zoho.books",
+        defaultAuth: "oauth-client-credentials-flow",
+    },
+    {
+        id: "appwrite",
+        name: "Appwrite API",
+        description: "Open-source BaaS for authentication, databases, file storage, and cloud functions",
+        url: "https://raw.githubusercontent.com/APIs-guru/openapi-directory/main/APIs/appwrite.io/server/0.9.3/openapi.yaml",
+        idPrefix: "io.appwrite",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "nasa",
+        name: "NASA APOD API",
+        description: "NASA Astronomy Picture of the Day — daily space imagery with metadata and explanations",
+        url: "https://raw.githubusercontent.com/APIs-guru/openapi-directory/main/APIs/nasa.gov/apod/1.0.0/openapi.yaml",
+        idPrefix: "gov.nasa",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "coda",
+        name: "Coda API",
+        description: "Build rich collaborative docs with tables, views, and automations in Coda",
+        url: "https://coda.io/apis/v1/openapi.json",
+        idPrefix: "io.coda",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "svix",
+        name: "Svix Webhooks API",
+        description: "Webhooks-as-a-service for reliably sending, receiving, and managing webhooks at scale",
+        url: "https://raw.githubusercontent.com/svix/svix-webhooks/main/server/openapi.json",
+        idPrefix: "com.svix",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "supabase-storage",
+        name: "Supabase Storage API",
+        description: "Open-source object storage for managing files and buckets with S3-compatible semantics",
+        url: "https://raw.githubusercontent.com/supabase/supabase/master/apps/docs/spec/storage_v0_openapi.json",
+        idPrefix: "com.supabase",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "novu",
+        name: "Novu Notifications API",
+        description: "Open-source notification infrastructure for orchestrating multi-channel alerts across email, SMS, and push",
+        url: "https://api.novu.co/openapi.json",
+        idPrefix: "co.novu",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "lago",
+        name: "Lago Billing API",
+        description: "Open-source metering and usage-based billing engine for building flexible event-driven pricing models",
+        url: "https://raw.githubusercontent.com/getlago/lago-openapi/main/openapi.yaml",
+        idPrefix: "com.lago",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "hookdeck",
+        name: "Hookdeck API",
+        description: "Webhook infrastructure for reliably receiving, filtering, transforming, and retrying inbound webhooks",
+        url: "https://raw.githubusercontent.com/hookdeck/hookdeck-api-schema/main/openapi.json",
+        idPrefix: "com.hookdeck",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "posthog",
+        name: "PostHog API",
+        description: "Open-source product analytics for user behavior tracking, feature flags, session recording, and A/B testing",
+        url: "https://app.posthog.com/api/schema/?format=json",
+        idPrefix: "com.posthog",
+        defaultAuth: "apiKey",
+    },
+    {
+        id: "airbyte",
+        name: "Airbyte API",
+        description: "Open-source data integration platform for syncing data between hundreds of sources and destinations",
+        url: "https://raw.githubusercontent.com/airbytehq/airbyte-api-python-sdk/main/airbyte-api.openapi.yaml",
+        idPrefix: "io.airbyte",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "ably",
+        name: "Ably Control API",
+        description: "Realtime messaging platform for pub/sub, presence, channel management, and data stream orchestration",
+        url: "https://raw.githubusercontent.com/ably/open-specs/main/definitions/control-v1.yaml",
+        idPrefix: "io.ably",
+        defaultAuth: "bearer",
+    },
+    {
+        id: "openfga",
+        name: "OpenFGA API",
+        description: "Fine-grained authorization system for building relationship-based access control based on the Google Zanzibar model",
+        url: "https://raw.githubusercontent.com/openfga/api/main/docs/openapiv2/apidocs.swagger.json",
+        idPrefix: "dev.openfga",
+        defaultAuth: "bearer",
+    },
 ];
 export function getCatalogEntry(id) {
     return CATALOG.find((e) => e.id === id);
 }
+// ── Icons ─────────────────────────────────────────────────────────────────────
+/** Brand colors sourced from Simple Icons (simpleicons.org). All chosen for legible white text. */
+const BRAND_COLORS = {
+    github: "#24292e",
+    cloudflare: "#F38020",
+    stripe: "#635BFF",
+    notion: "#191919",
+    resend: "#191919",
+    openai: "#10A37F",
+    figma: "#F24E1E",
+    twilio: "#F22F46",
+    slack: "#4A154B",
+    jira: "#0052CC",
+    hubspot: "#FF7A59",
+    discord: "#5865F2",
+    pagerduty: "#06AC38",
+    zoom: "#2D8CFF",
+    mailchimp: "#C21A01",
+    asana: "#F06A6A",
+    sendgrid: "#1A82E2",
+    paypal: "#003087",
+    plaid: "#00A67E",
+    vercel: "#191919",
+    anthropic: "#C97045",
+    shopify: "#7AB648",
+    datadog: "#632CA6",
+    sentry: "#362D59",
+    intercom: "#1F8DED",
+    contentful: "#2478CC",
+    airtable: "#1071C9",
+    twitch: "#9146FF",
+    klaviyo: "#1E1E2E",
+    brex: "#3B2FC9",
+    box: "#0061D5",
+    spotify: "#1DB954",
+    gitlab: "#FC6D26",
+    netlify: "#00C7B7",
+    launchdarkly: "#405BFF",
+    postmark: "#E77925",
+    circleci: "#343434",
+    grafana: "#F46800",
+    digitalocean: "#0080FF",
+    linode: "#00B050",
+    square: "#3E4348",
+    zendesk: "#03363D",
+    bitbucket: "#0052CC",
+    miro: "#050038",
+    okta: "#007DC1",
+    meraki: "#1BA0D7",
+    docker: "#2496ED",
+    kubernetes: "#326CE5",
+    freshdesk: "#27B2AA",
+    dropbox: "#0061FF",
+    xero: "#13B5EA",
+    bigcommerce: "#34313F",
+    recurly: "#FF5B59",
+    ably: "#FF5416",
+    openfga: "#3E4A61",
+};
+/**
+ * Returns a base64 SVG data URI icon for a catalog entry — a rounded square
+ * in the brand's primary color with the first letter of the service name.
+ */
+export function getCatalogIconUri(id) {
+    const color = BRAND_COLORS[id];
+    if (!color)
+        return undefined;
+    const entry = getCatalogEntry(id);
+    if (!entry)
+        return undefined;
+    const letter = entry.name
+        .replace(/^[^A-Za-z]*/, "")
+        .charAt(0)
+        .toUpperCase();
+    const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><rect width="24" height="24" rx="5" fill="${color}"/><text x="12" y="17" font-family="ui-sans-serif,system-ui,sans-serif" font-size="13" font-weight="700" fill="white" text-anchor="middle">${letter}</text></svg>`;
+    return `data:image/svg+xml;base64,${btoa(svg)}`;
+}
 //# sourceMappingURL=catalog.js.map

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { buildTemplate, buildTemplates } from "./build-template.js";
-export { CATALOG, getCatalogEntry } from "./catalog.js";
+export { CATALOG, getCatalogEntry, getCatalogIconUri } from "./catalog.js";
 export type { CatalogEntry } from "./catalog.js";
+export { CONNECTOR_STATS } from "./stats.js";
 export { detectDefaultAuth, getBaseUrl, getOperations, getServers, isRef, parseOpenApi, resolve, resolveRef, } from "./parse-openapi.js";
 export type { DetectedAuth } from "./parse-openapi.js";
 export type { ApiResponse, AuthHint, Binding, Components, ConnectorGroup, ConnectorTemplate, Constraints, GeneratorOptions, HttpMethod, MediaType, OpenApiDoc, OpenApiInfo, OpenApiServer, Operation, OperationWithMeta, OAuthFlows, Parameter, PathItem, PropertyDef, Ref, RequestBody, Schema, SecurityRequirement, SecurityScheme, WriteOptions, } from "./types.js";

package/dist/index.js

@@ -1,10 +1,11 @@
 export { buildTemplate, buildTemplates } from "./build-template.js";
-export { CATALOG, getCatalogEntry } from "./catalog.js";
+export { CATALOG, getCatalogEntry, getCatalogIconUri } from "./catalog.js";
+export { CONNECTOR_STATS } from "./stats.js";
 export { detectDefaultAuth, getBaseUrl, getOperations, getServers, isRef, parseOpenApi, resolve, resolveRef, } from "./parse-openapi.js";
 export { CONNECTOR_SCHEMA } from "./types.js";
 export { writeTemplates } from "./write-templates.js";
 import { buildTemplates } from "./build-template.js";
-import { CATALOG, getCatalogEntry } from "./catalog.js";
+import { CATALOG, getCatalogEntry, getCatalogIconUri } from "./catalog.js";
 import { detectDefaultAuth, getOperations, parseOpenApi } from "./parse-openapi.js";
 import { writeTemplates } from "./write-templates.js";
 /**
@@ -46,6 +47,7 @@ export async function generateFromCatalog(id, overrides = {}) {
     const opts = {
         idPrefix: overrides.idPrefix ?? entry.idPrefix,
         defaultAuthType: overrides.defaultAuthType ?? entry.defaultAuth,
+        icon: overrides.icon ?? getCatalogIconUri(id),
         ...overrides,
     };
     const { templates, files } = await generateFromUrl(entry.url, opts);

package/dist/stats.d.ts

@@ -0,0 +1,5 @@
+export declare const CONNECTOR_STATS: {
+    readonly services: 100;
+    readonly endpoints: 18145;
+};
+//# sourceMappingURL=stats.d.ts.map

package/dist/stats.js

@@ -0,0 +1,6 @@
+// Auto-generated by scripts/update-connector-stats.mjs — do not edit manually.
+export const CONNECTOR_STATS = {
+    services: 100,
+    endpoints: 18145,
+};
+//# sourceMappingURL=stats.js.map

package/dist/types.d.ts

@@ -236,6 +236,8 @@ export interface GeneratorOptions {
     filter?: string;
     /** Pre-select a specific auth type */
     defaultAuthType?: AuthHint;
+    /** Icon data URI (e.g. "data:image/svg+xml;base64,...") applied to all generated templates */
+    icon?: string;
 }
 export interface WriteOptions {
     outputDir: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmnkit/connector-gen",
-  "version": "0.0.7",
+  "version": "0.0.11",
   "private": false,
   "type": "module",
   "exports": {