@wolpertingerlabs/drawlatch 1.0.0-alpha.2 → 1.0.0-alpha.29

package/dist/connections/productivity/stripe.json

@@ -0,0 +1,74 @@
+{
+  "name": "Stripe API",
+  "stability": "beta",
+  "category": "productivity",
+  "description": "Stripe payments API — customers, charges, payment intents, subscriptions, invoices, and more. Auth is handled automatically via the STRIPE_SECRET_KEY environment variable. Includes a webhook ingestor for real-time events (payment_intent.succeeded, invoice.paid, etc.) — set STRIPE_WEBHOOK_SECRET and use poll_events to retrieve them. Note: Stripe uses application/x-www-form-urlencoded for request bodies, not JSON.",
+  "docsUrl": "https://docs.stripe.com/api",
+  "openApiUrl": "https://raw.githubusercontent.com/stripe/openapi/master/openapi/spec3.json",
+  "headers": {
+    "Authorization": "Bearer ${STRIPE_SECRET_KEY}"
+  },
+  "secrets": {
+    "STRIPE_SECRET_KEY": "${STRIPE_SECRET_KEY}",
+    "STRIPE_WEBHOOK_SECRET": "${STRIPE_WEBHOOK_SECRET}"
+  },
+  "allowedEndpoints": [
+    "https://api.stripe.com/**"
+  ],
+  "ingestor": {
+    "type": "webhook",
+    "webhook": {
+      "path": "stripe",
+      "protocol": "stripe",
+      "signatureHeader": "Stripe-Signature",
+      "signatureSecret": "STRIPE_WEBHOOK_SECRET"
+    }
+  },
+  "testIngestor": {
+    "description": "Verifies that the Stripe webhook secret is configured",
+    "strategy": "webhook_verify",
+    "requireSecrets": ["STRIPE_WEBHOOK_SECRET"]
+  },
+  "listenerConfig": {
+    "name": "Stripe Webhook Listener",
+    "description": "Receives real-time events from Stripe via webhooks.",
+    "fields": [
+      {
+        "key": "eventFilter",
+        "label": "Event Types",
+        "description": "Which Stripe event types to capture. Leave empty for all.",
+        "type": "multiselect",
+        "default": [],
+        "options": [
+          {"value": "payment_intent.succeeded", "label": "Payment Succeeded"},
+          {"value": "payment_intent.payment_failed", "label": "Payment Failed"},
+          {"value": "charge.succeeded", "label": "Charge Succeeded"},
+          {"value": "charge.refunded", "label": "Charge Refunded"},
+          {"value": "invoice.paid", "label": "Invoice Paid"},
+          {"value": "invoice.payment_failed", "label": "Invoice Payment Failed"},
+          {"value": "customer.created", "label": "Customer Created"},
+          {"value": "customer.updated", "label": "Customer Updated"},
+          {"value": "subscription.created", "label": "Subscription Created"},
+          {"value": "subscription.updated", "label": "Subscription Updated"},
+          {"value": "subscription.deleted", "label": "Subscription Deleted"},
+          {"value": "checkout.session.completed", "label": "Checkout Completed"}
+        ],
+        "group": "Filtering"
+      },
+      {
+        "key": "bufferSize",
+        "label": "Buffer Size",
+        "description": "Maximum number of events to keep in memory.",
+        "type": "number",
+        "default": 200,
+        "min": 10,
+        "max": 1000,
+        "group": "Advanced"
+      }
+    ]
+  },
+  "testConnection": {
+    "url": "https://api.stripe.com/v1/balance",
+    "description": "Fetches the account balance (read-only)"
+  }
+}

package/dist/connections/productivity/trello.json

@@ -0,0 +1,113 @@
+{
+  "name": "Trello API",
+  "stability": "stable",
+  "category": "productivity",
+  "description": "Trello boards, lists, and cards API. Authentication uses query parameters — include ?key=${TRELLO_API_KEY}&token=${TRELLO_TOKEN} in your request URLs. The placeholders are resolved automatically from the route's secrets. Includes a webhook ingestor for real-time events (card updates, list changes, board activity, etc.) — set TRELLO_API_SECRET and TRELLO_CALLBACK_URL, then use poll_events to retrieve them.",
+  "docsUrl": "https://developer.atlassian.com/cloud/trello/rest/",
+  "headers": {},
+  "secrets": {
+    "TRELLO_API_KEY": "${TRELLO_API_KEY}",
+    "TRELLO_TOKEN": "${TRELLO_TOKEN}",
+    "TRELLO_API_SECRET": "${TRELLO_API_SECRET}",
+    "TRELLO_CALLBACK_URL": "${TRELLO_CALLBACK_URL}"
+  },
+  "allowedEndpoints": [
+    "https://api.trello.com/**"
+  ],
+  "ingestor": {
+    "type": "webhook",
+    "webhook": {
+      "path": "trello",
+      "protocol": "trello",
+      "signatureHeader": "X-Trello-Webhook",
+      "signatureSecret": "TRELLO_API_SECRET",
+      "callbackUrl": "${TRELLO_CALLBACK_URL}",
+      "lifecycle": {
+        "list": {
+          "method": "GET",
+          "url": "https://api.trello.com/1/tokens/${TRELLO_TOKEN}/webhooks?key=${TRELLO_API_KEY}",
+          "callbackUrlField": "callbackURL",
+          "idField": "id",
+          "modelIdField": "idModel"
+        },
+        "register": {
+          "method": "POST",
+          "url": "https://api.trello.com/1/tokens/${TRELLO_TOKEN}/webhooks?key=${TRELLO_API_KEY}",
+          "headers": { "Content-Type": "application/json" },
+          "body": {
+            "callbackURL": "${TRELLO_CALLBACK_URL}",
+            "idModel": "${boardId}",
+            "description": "Drawlatch webhook"
+          },
+          "idField": "id"
+        },
+        "unregister": {
+          "method": "DELETE",
+          "url": "https://api.trello.com/1/tokens/${TRELLO_TOKEN}/webhooks/${_webhookId}?key=${TRELLO_API_KEY}"
+        }
+      }
+    }
+  },
+  "testIngestor": {
+    "description": "Lists existing Trello webhooks to verify credentials",
+    "strategy": "http_request",
+    "request": {
+      "url": "https://api.trello.com/1/tokens/${TRELLO_TOKEN}/webhooks?key=${TRELLO_API_KEY}",
+      "expectedStatus": [200]
+    }
+  },
+  "listenerConfig": {
+    "name": "Trello Webhook Listener",
+    "description": "Receives real-time events from Trello boards via webhooks. Supports multiple concurrent instances to watch different boards simultaneously.",
+    "supportsMultiInstance": true,
+    "fields": [
+      {
+        "key": "boardId",
+        "label": "Board ID",
+        "description": "The Trello board to watch. Required for webhook registration.",
+        "type": "text",
+        "required": true,
+        "instanceKey": true,
+        "placeholder": "e.g., 5a1b2c3d4e5f6g7h8i9j0k",
+        "dynamicOptions": {
+          "url": "https://api.trello.com/1/members/me/boards?fields=name,id&key=${TRELLO_API_KEY}&token=${TRELLO_TOKEN}",
+          "labelField": "name",
+          "valueField": "id"
+        },
+        "group": "Connection"
+      },
+      {
+        "key": "eventFilter",
+        "label": "Event Types",
+        "description": "Which Trello action types to capture. Leave empty for all.",
+        "type": "multiselect",
+        "default": [],
+        "options": [
+          {"value": "createCard", "label": "Card Created"},
+          {"value": "updateCard", "label": "Card Updated"},
+          {"value": "deleteCard", "label": "Card Deleted"},
+          {"value": "addMemberToCard", "label": "Member Added to Card"},
+          {"value": "commentCard", "label": "Comment on Card"},
+          {"value": "createList", "label": "List Created"},
+          {"value": "updateList", "label": "List Updated"},
+          {"value": "moveCardToBoard", "label": "Card Moved to Board"}
+        ],
+        "group": "Filtering"
+      },
+      {
+        "key": "bufferSize",
+        "label": "Buffer Size",
+        "description": "Maximum number of events to keep in memory.",
+        "type": "number",
+        "default": 200,
+        "min": 10,
+        "max": 1000,
+        "group": "Advanced"
+      }
+    ]
+  },
+  "testConnection": {
+    "url": "https://api.trello.com/1/members/me?key=${TRELLO_API_KEY}&token=${TRELLO_TOKEN}",
+    "description": "Fetches the authenticated Trello member"
+  }
+}

package/dist/connections/{bluesky.json → social-media/bluesky.json}

@@ -1,5 +1,7 @@
 {
   "name": "Bluesky API (AT Protocol)",
+  "stability": "beta",
+  "category": "social-media",
   "description": "Bluesky API via the AT Protocol — posts, feeds, profiles, notifications, social graph, and more. Auth is handled automatically via the BLUESKY_ACCESS_TOKEN environment variable (JWT Bearer token). Obtain a token by POSTing to com.atproto.server.createSession with your handle and an App Password. Tokens expire after ~2 hours — rotate externally using the refresh token. Both bsky.social (authenticated PDS) and public.api.bsky.app (public read-only API) are allowlisted. For self-hosted PDS instances, override with a custom connector. Includes a poll ingestor that fetches notifications — use poll_events to retrieve them.",
   "docsUrl": "https://docs.bsky.app/",
   "headers": {
@@ -22,5 +24,44 @@
       "deduplicateBy": "uri",
       "eventType": "notification"
     }
+  },
+  "testIngestor": {
+    "description": "Fetches notifications to verify Bluesky access token",
+    "strategy": "poll_once",
+    "request": {
+      "url": "https://bsky.social/xrpc/app.bsky.notification.listNotifications?limit=1",
+      "expectedStatus": [200]
+    }
+  },
+  "listenerConfig": {
+    "name": "Bluesky Poll Listener",
+    "description": "Polls Bluesky notifications at a configurable interval.",
+    "fields": [
+      {
+        "key": "intervalMs",
+        "label": "Poll Interval (ms)",
+        "description": "How often to check for new notifications, in milliseconds.",
+        "type": "number",
+        "default": 60000,
+        "min": 10000,
+        "max": 3600000,
+        "group": "Connection"
+      },
+      {
+        "key": "bufferSize",
+        "label": "Buffer Size",
+        "description": "Maximum number of events to keep in memory.",
+        "type": "number",
+        "default": 200,
+        "min": 10,
+        "max": 1000,
+        "group": "Advanced"
+      }
+    ]
+  },
+  "testConnection": {
+    "url": "https://bsky.social/xrpc/app.bsky.actor.getProfile?actor=did:self",
+    "description": "Fetches the authenticated user's profile",
+    "expectedStatus": [200, 400]
   }
 }

package/dist/connections/social-media/mastodon.json

@@ -0,0 +1,65 @@
+{
+  "name": "Mastodon API",
+  "stability": "beta",
+  "category": "social-media",
+  "description": "Mastodon API — statuses (toots), timelines, notifications, accounts, search, and more. Auth is handled automatically via the MASTODON_ACCESS_TOKEN environment variable (OAuth2 Bearer token from your instance's Development settings). This template targets mastodon.social — for other instances, override with a custom connector using the same auth pattern but different allowedEndpoints. Includes a poll ingestor that fetches the home timeline — use poll_events to retrieve them.",
+  "docsUrl": "https://docs.joinmastodon.org/api/",
+  "headers": {
+    "Authorization": "Bearer ${MASTODON_ACCESS_TOKEN}"
+  },
+  "secrets": {
+    "MASTODON_ACCESS_TOKEN": "${MASTODON_ACCESS_TOKEN}"
+  },
+  "allowedEndpoints": [
+    "https://mastodon.social/api/v1/**",
+    "https://mastodon.social/api/v2/**"
+  ],
+  "ingestor": {
+    "type": "poll",
+    "poll": {
+      "url": "https://mastodon.social/api/v1/timelines/home?limit=20",
+      "intervalMs": 60000,
+      "method": "GET",
+      "deduplicateBy": "id",
+      "eventType": "status"
+    }
+  },
+  "testIngestor": {
+    "description": "Verifies Mastodon credentials by checking account",
+    "strategy": "poll_once",
+    "request": {
+      "url": "https://mastodon.social/api/v1/accounts/verify_credentials",
+      "expectedStatus": [200]
+    }
+  },
+  "listenerConfig": {
+    "name": "Mastodon Poll Listener",
+    "description": "Polls the Mastodon home timeline at a configurable interval.",
+    "fields": [
+      {
+        "key": "intervalMs",
+        "label": "Poll Interval (ms)",
+        "description": "How often to check for new statuses, in milliseconds.",
+        "type": "number",
+        "default": 60000,
+        "min": 10000,
+        "max": 3600000,
+        "group": "Connection"
+      },
+      {
+        "key": "bufferSize",
+        "label": "Buffer Size",
+        "description": "Maximum number of events to keep in memory.",
+        "type": "number",
+        "default": 200,
+        "min": 10,
+        "max": 1000,
+        "group": "Advanced"
+      }
+    ]
+  },
+  "testConnection": {
+    "url": "https://mastodon.social/api/v1/accounts/verify_credentials",
+    "description": "Verifies Mastodon account credentials"
+  }
+}

package/dist/connections/social-media/reddit.json

@@ -0,0 +1,80 @@
+{
+  "name": "Reddit API",
+  "stability": "beta",
+  "category": "social-media",
+  "description": "Reddit API — subreddits, posts, comments, users, search, and more. Auth is handled automatically via the REDDIT_ACCESS_TOKEN environment variable (OAuth2 Bearer token). A User-Agent header is required by Reddit and set via REDDIT_USER_AGENT. Obtain an OAuth2 token by registering a 'script' app at https://www.reddit.com/prefs/apps and using the client credentials grant. Tokens expire after 1 hour — rotate externally. Includes a poll ingestor that fetches new posts from a configurable subreddit — set REDDIT_SUBREDDIT and use poll_events to retrieve them.",
+  "docsUrl": "https://www.reddit.com/dev/api/",
+  "headers": {
+    "Authorization": "Bearer ${REDDIT_ACCESS_TOKEN}",
+    "User-Agent": "${REDDIT_USER_AGENT}"
+  },
+  "secrets": {
+    "REDDIT_ACCESS_TOKEN": "${REDDIT_ACCESS_TOKEN}",
+    "REDDIT_USER_AGENT": "${REDDIT_USER_AGENT}",
+    "REDDIT_SUBREDDIT": "${REDDIT_SUBREDDIT}"
+  },
+  "allowedEndpoints": [
+    "https://oauth.reddit.com/**"
+  ],
+  "ingestor": {
+    "type": "poll",
+    "poll": {
+      "url": "https://oauth.reddit.com/r/${REDDIT_SUBREDDIT}/new?limit=25",
+      "intervalMs": 60000,
+      "method": "GET",
+      "responsePath": "data.children",
+      "deduplicateBy": "data.name",
+      "eventType": "new_post"
+    }
+  },
+  "testIngestor": {
+    "description": "Fetches the authenticated user to verify Reddit API access",
+    "strategy": "poll_once",
+    "request": {
+      "url": "https://oauth.reddit.com/api/v1/me",
+      "expectedStatus": [200]
+    }
+  },
+  "listenerConfig": {
+    "name": "Reddit Poll Listener",
+    "description": "Polls a subreddit for new posts at a configurable interval. Supports multiple concurrent instances to watch different subreddits simultaneously.",
+    "supportsMultiInstance": true,
+    "fields": [
+      {
+        "key": "subreddit",
+        "label": "Subreddit",
+        "description": "The subreddit to watch for new posts (without the r/ prefix).",
+        "type": "text",
+        "required": true,
+        "instanceKey": true,
+        "overrideKey": "REDDIT_SUBREDDIT",
+        "placeholder": "e.g., rust",
+        "group": "Connection"
+      },
+      {
+        "key": "intervalMs",
+        "label": "Poll Interval (ms)",
+        "description": "How often to check for new posts, in milliseconds.",
+        "type": "number",
+        "default": 60000,
+        "min": 10000,
+        "max": 3600000,
+        "group": "Connection"
+      },
+      {
+        "key": "bufferSize",
+        "label": "Buffer Size",
+        "description": "Maximum number of events to keep in memory.",
+        "type": "number",
+        "default": 200,
+        "min": 10,
+        "max": 1000,
+        "group": "Advanced"
+      }
+    ]
+  },
+  "testConnection": {
+    "url": "https://oauth.reddit.com/api/v1/me",
+    "description": "Fetches the authenticated Reddit user"
+  }
+}

package/dist/connections/{twitch.json → social-media/twitch.json}

@@ -1,5 +1,7 @@
 {
   "name": "Twitch API",
+  "stability": "beta",
+  "category": "social-media",
   "description": "Twitch Helix API — streams, users, channels, clips, videos, chat, and more. Auth requires both a Bearer token and Client-Id header, handled automatically via TWITCH_ACCESS_TOKEN and TWITCH_CLIENT_ID environment variables. Register an application at https://dev.twitch.tv/console/apps to obtain credentials. Includes a poll ingestor that fetches followed live streams — set TWITCH_USER_ID and use poll_events to retrieve them.",
   "docsUrl": "https://dev.twitch.tv/docs/api/reference/",
   "headers": {
@@ -24,5 +26,43 @@
       "deduplicateBy": "id",
       "eventType": "stream_online"
     }
+  },
+  "testIngestor": {
+    "description": "Fetches the authenticated Twitch user to verify API access",
+    "strategy": "poll_once",
+    "request": {
+      "url": "https://api.twitch.tv/helix/users",
+      "expectedStatus": [200]
+    }
+  },
+  "listenerConfig": {
+    "name": "Twitch Poll Listener",
+    "description": "Polls Twitch for followed live streams at a configurable interval.",
+    "fields": [
+      {
+        "key": "intervalMs",
+        "label": "Poll Interval (ms)",
+        "description": "How often to check for live streams, in milliseconds.",
+        "type": "number",
+        "default": 60000,
+        "min": 10000,
+        "max": 3600000,
+        "group": "Connection"
+      },
+      {
+        "key": "bufferSize",
+        "label": "Buffer Size",
+        "description": "Maximum number of events to keep in memory.",
+        "type": "number",
+        "default": 200,
+        "min": 10,
+        "max": 1000,
+        "group": "Advanced"
+      }
+    ]
+  },
+  "testConnection": {
+    "url": "https://api.twitch.tv/helix/users",
+    "description": "Fetches the authenticated Twitch user"
   }
 }

package/dist/connections/social-media/x.json

@@ -0,0 +1,67 @@
+{
+  "name": "X (Twitter) API",
+  "stability": "beta",
+  "category": "social-media",
+  "description": "X (formerly Twitter) API v2 — tweets, users, spaces, lists, and more. Auth is handled automatically via the X_BEARER_TOKEN environment variable (App-only Bearer token from the X Developer Portal). Both api.x.com and api.twitter.com domains are allowlisted. Includes a poll ingestor that searches recent tweets matching a configurable query — set X_SEARCH_QUERY and use poll_events to retrieve them.",
+  "docsUrl": "https://developer.x.com/en/docs/x-api",
+  "headers": {
+    "Authorization": "Bearer ${X_BEARER_TOKEN}"
+  },
+  "secrets": {
+    "X_BEARER_TOKEN": "${X_BEARER_TOKEN}",
+    "X_SEARCH_QUERY": "${X_SEARCH_QUERY}"
+  },
+  "allowedEndpoints": [
+    "https://api.x.com/**",
+    "https://api.twitter.com/**"
+  ],
+  "ingestor": {
+    "type": "poll",
+    "poll": {
+      "url": "https://api.x.com/2/tweets/search/recent?query=${X_SEARCH_QUERY}&max_results=25&tweet.fields=created_at,author_id,public_metrics",
+      "intervalMs": 60000,
+      "method": "GET",
+      "responsePath": "data",
+      "deduplicateBy": "id",
+      "eventType": "tweet"
+    }
+  },
+  "testIngestor": {
+    "description": "Fetches the authenticated user to verify X API access",
+    "strategy": "poll_once",
+    "request": {
+      "url": "https://api.x.com/2/users/me",
+      "expectedStatus": [200]
+    }
+  },
+  "listenerConfig": {
+    "name": "X (Twitter) Poll Listener",
+    "description": "Polls X for recent tweets matching a search query at a configurable interval.",
+    "fields": [
+      {
+        "key": "intervalMs",
+        "label": "Poll Interval (ms)",
+        "description": "How often to check for new tweets, in milliseconds.",
+        "type": "number",
+        "default": 60000,
+        "min": 10000,
+        "max": 3600000,
+        "group": "Connection"
+      },
+      {
+        "key": "bufferSize",
+        "label": "Buffer Size",
+        "description": "Maximum number of events to keep in memory.",
+        "type": "number",
+        "default": 200,
+        "min": 10,
+        "max": 1000,
+        "group": "Advanced"
+      }
+    ]
+  },
+  "testConnection": {
+    "url": "https://api.x.com/2/users/me",
+    "description": "Fetches the authenticated X/Twitter user"
+  }
+}