@automate.ax/catalog 0.81.0 → 0.83.0

package/dist/catalog.d.ts

@@ -175,6 +175,42 @@ export declare const cohereService: {
     }];
     readonly description: string;
 };
+export declare const convexService: {
+    readonly connectionMethods: readonly [{
+        readonly id: "oauth";
+        readonly name: "Project OAuth";
+        readonly type: "redirect";
+    }, {
+        readonly fields: readonly [{
+            readonly description: "Use the deployment's https://<name>.convex.cloud URL.";
+            readonly input: "url";
+            readonly label: "Deployment URL";
+            readonly name: "deploymentUrl";
+            readonly placeholder: "https://example.convex.cloud";
+            readonly required: true;
+        }, {
+            readonly input: "password";
+            readonly label: "Deploy key";
+            readonly name: "deployKey";
+            readonly placeholder: "Paste a Convex deploy key";
+            readonly required: true;
+        }, {
+            readonly description: "Set the same value as AUTOMATE_AX_WEBHOOK_SECRET in Convex to emit signed semantic events.";
+            readonly input: "password";
+            readonly label: "Webhook signing secret";
+            readonly name: "webhookSecret";
+            readonly placeholder: "At least 32 characters";
+            readonly required: true;
+        }];
+        readonly id: "deployment-key";
+        readonly name: "Deployment key";
+        readonly type: "form";
+    }];
+    readonly description: "Connect a Convex project for function calls and durable event triggers.";
+    readonly id: "convex";
+    readonly name: "Convex";
+    readonly preferredConnectionMethodId: "oauth";
+};
 export declare const deepinfraService: {
     readonly id: "deepinfra";
     readonly name: string;
@@ -452,11 +488,11 @@ export declare const perplexityService: {
 export declare const postgresService: {
     readonly connectionMethods: readonly [{
         readonly fields: readonly [{
-            readonly description: "A postgresql:// connection string.";
+            readonly description: "For Supabase, use its provided URL and append ?uselibpqcompat=true&sslmode=require only when you intend libpq's encrypted, non-verifying require behavior.";
             readonly input: "password";
             readonly label: "Connection string";
             readonly name: "connectionString";
-            readonly placeholder: "postgresql://user:password@host:5432/database?sslmode=require";
+            readonly placeholder: "postgresql://postgres.project-ref:password@aws-0-region.pooler.supabase.com:5432/postgres?uselibpqcompat=true&sslmode=require";
             readonly required: true;
         }];
         readonly id: "credentials";
@@ -793,6 +829,41 @@ export declare const integrationCatalog: readonly [{
         readonly credentialUrl?: string | undefined;
     }];
     readonly description: string;
+}, {
+    readonly connectionMethods: readonly [{
+        readonly id: "oauth";
+        readonly name: "Project OAuth";
+        readonly type: "redirect";
+    }, {
+        readonly fields: readonly [{
+            readonly description: "Use the deployment's https://<name>.convex.cloud URL.";
+            readonly input: "url";
+            readonly label: "Deployment URL";
+            readonly name: "deploymentUrl";
+            readonly placeholder: "https://example.convex.cloud";
+            readonly required: true;
+        }, {
+            readonly input: "password";
+            readonly label: "Deploy key";
+            readonly name: "deployKey";
+            readonly placeholder: "Paste a Convex deploy key";
+            readonly required: true;
+        }, {
+            readonly description: "Set the same value as AUTOMATE_AX_WEBHOOK_SECRET in Convex to emit signed semantic events.";
+            readonly input: "password";
+            readonly label: "Webhook signing secret";
+            readonly name: "webhookSecret";
+            readonly placeholder: "At least 32 characters";
+            readonly required: true;
+        }];
+        readonly id: "deployment-key";
+        readonly name: "Deployment key";
+        readonly type: "form";
+    }];
+    readonly description: "Connect a Convex project for function calls and durable event triggers.";
+    readonly id: "convex";
+    readonly name: "Convex";
+    readonly preferredConnectionMethodId: "oauth";
 }, {
     readonly id: "deepinfra";
     readonly name: string;
@@ -1054,11 +1125,11 @@ export declare const integrationCatalog: readonly [{
 }, {
     readonly connectionMethods: readonly [{
         readonly fields: readonly [{
-            readonly description: "A postgresql:// connection string.";
+            readonly description: "For Supabase, use its provided URL and append ?uselibpqcompat=true&sslmode=require only when you intend libpq's encrypted, non-verifying require behavior.";
             readonly input: "password";
             readonly label: "Connection string";
             readonly name: "connectionString";
-            readonly placeholder: "postgresql://user:password@host:5432/database?sslmode=require";
+            readonly placeholder: "postgresql://postgres.project-ref:password@aws-0-region.pooler.supabase.com:5432/postgres?uselibpqcompat=true&sslmode=require";
             readonly required: true;
         }];
         readonly id: "credentials";

package/dist/catalog.js

@@ -121,6 +121,45 @@ export const cohereService = defineApiKeyService({
     id: "cohere",
     name: "Cohere",
 });
+export const convexService = defineIntegrationService({
+    connectionMethods: [
+        { id: "oauth", name: "Project OAuth", type: "redirect" },
+        {
+            fields: [
+                {
+                    description: "Use the deployment's https://<name>.convex.cloud URL.",
+                    input: "url",
+                    label: "Deployment URL",
+                    name: "deploymentUrl",
+                    placeholder: "https://example.convex.cloud",
+                    required: true,
+                },
+                {
+                    input: "password",
+                    label: "Deploy key",
+                    name: "deployKey",
+                    placeholder: "Paste a Convex deploy key",
+                    required: true,
+                },
+                {
+                    description: "Set the same value as AUTOMATE_AX_WEBHOOK_SECRET in Convex to emit signed semantic events.",
+                    input: "password",
+                    label: "Webhook signing secret",
+                    name: "webhookSecret",
+                    placeholder: "At least 32 characters",
+                    required: true,
+                },
+            ],
+            id: "deployment-key",
+            name: "Deployment key",
+            type: "form",
+        },
+    ],
+    description: "Connect a Convex project for function calls and durable event triggers.",
+    id: "convex",
+    name: "Convex",
+    preferredConnectionMethodId: "oauth",
+});
 export const deepinfraService = defineApiKeyService({
     description: "Connect a DeepInfra API key.",
     id: "deepinfra",
@@ -240,11 +279,11 @@ export const postgresService = defineIntegrationService({
         {
             fields: [
                 {
-                    description: "A postgresql:// connection string.",
+                    description: "For Supabase, use its provided URL and append ?uselibpqcompat=true&sslmode=require only when you intend libpq's encrypted, non-verifying require behavior.",
                     input: "password",
                     label: "Connection string",
                     name: "connectionString",
-                    placeholder: "postgresql://user:password@host:5432/database?sslmode=require",
+                    placeholder: "postgresql://postgres.project-ref:password@aws-0-region.pooler.supabase.com:5432/postgres?uselibpqcompat=true&sslmode=require",
                     required: true,
                 },
             ],
@@ -355,6 +394,7 @@ export const integrationCatalog = defineIntegrationCatalog([
     cloudflareService,
     codexService,
     cohereService,
+    convexService,
     deepinfraService,
     deepseekService,
     firecrawlService,

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { airtableService, anthropicService, apolloService, asanaService, brevoService, cerebrasService, chatgptService, cloudflareService, codexService, cohereService, deepinfraService, deepseekService, firecrawlService, fireworksService, getIntegrationService, githubService, googleGenaiService, googleService, groqService, huggingfaceService, integrationCatalog, linearService, microsoftService, millionverifierService, mistralService, openaiService, openrouterService, perplexityService, postgresService, resendService, scrapflyService, slackService, tidycalService, togetheraiService, trelloService, vercelAiGatewayService, vercelService, whatsappService, xaiService, type IntegrationServiceId, } from "./catalog.js";
+export { airtableService, anthropicService, apolloService, asanaService, brevoService, cerebrasService, chatgptService, cloudflareService, codexService, cohereService, convexService, deepinfraService, deepseekService, firecrawlService, fireworksService, getIntegrationService, githubService, googleGenaiService, googleService, groqService, huggingfaceService, integrationCatalog, linearService, microsoftService, millionverifierService, mistralService, openaiService, openrouterService, perplexityService, postgresService, resendService, scrapflyService, slackService, tidycalService, togetheraiService, trelloService, vercelAiGatewayService, vercelService, whatsappService, xaiService, type IntegrationServiceId, } from "./catalog.js";
 export { defineIntegrationCatalog, defineIntegrationService, integrationScope, type IntegrationAccountConnectionOption, type IntegrationAccountRequirement, type IntegrationConnectionDefinition, type IntegrationConnectionNotice, type IntegrationFormField, type IntegrationScopeRequirement, type IntegrationServiceDefinition, type ScopeRequirementGroup, type TriggerDefinition, type TriggerPresentation, type TriggerPresentationContext, type TriggerPresentationDetail, type TriggerScopePresentation, type TriggerPresentationValue, } from "./types.js";
 export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getMailhookAddress, getMailhookAddressKey, DASHBOARD_RUN_CONFIG_SCHEMA, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, PLATFORM_EMAIL_DOMAIN, triggerCatalog, triggerDefinitions, type DashboardRunConfig, type DashboardRunEndpointOptions, type DashboardRunField, type HttpTriggerEndpointOptions, type HttpTriggerScope, type MailhookAddressOptions, type MailhookScope, type TriggerType, } from "./triggers/index.js";

package/dist/index.js

@@ -1,3 +1,3 @@
-export { airtableService, anthropicService, apolloService, asanaService, brevoService, cerebrasService, chatgptService, cloudflareService, codexService, cohereService, deepinfraService, deepseekService, firecrawlService, fireworksService, getIntegrationService, githubService, googleGenaiService, googleService, groqService, huggingfaceService, integrationCatalog, linearService, microsoftService, millionverifierService, mistralService, openaiService, openrouterService, perplexityService, postgresService, resendService, scrapflyService, slackService, tidycalService, togetheraiService, trelloService, vercelAiGatewayService, vercelService, whatsappService, xaiService, } from "./catalog.js";
+export { airtableService, anthropicService, apolloService, asanaService, brevoService, cerebrasService, chatgptService, cloudflareService, codexService, cohereService, convexService, deepinfraService, deepseekService, firecrawlService, fireworksService, getIntegrationService, githubService, googleGenaiService, googleService, groqService, huggingfaceService, integrationCatalog, linearService, microsoftService, millionverifierService, mistralService, openaiService, openrouterService, perplexityService, postgresService, resendService, scrapflyService, slackService, tidycalService, togetheraiService, trelloService, vercelAiGatewayService, vercelService, whatsappService, xaiService, } from "./catalog.js";
 export { defineIntegrationCatalog, defineIntegrationService, integrationScope, } from "./types.js";
 export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getMailhookAddress, getMailhookAddressKey, DASHBOARD_RUN_CONFIG_SCHEMA, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, PLATFORM_EMAIL_DOMAIN, triggerCatalog, triggerDefinitions, } from "./triggers/index.js";

package/dist/triggers/convex.d.ts

@@ -0,0 +1,87 @@
+export interface ConvexEventEndpointOptions {
+    appOrigin: string;
+    automationId: string;
+    hookSlot: number;
+    scopePath?: readonly number[];
+}
+/**
+ * Returns the public endpoint for one signed Convex semantic-event trigger.
+ *
+ * @param options - Public origin and trigger identity.
+ */
+export declare function getConvexEventEndpoint(options: ConvexEventEndpointOptions): string;
+/**
+ * Returns the stable source key for one Convex semantic-event trigger.
+ *
+ * @param options - Trigger identity without the public origin.
+ */
+export declare function getConvexEventEndpointKey(options: Omit<ConvexEventEndpointOptions, "appOrigin">): string;
+export declare const convexTriggerDefinitions: {
+    readonly convexDocumentCreated: {
+        readonly account: {
+            readonly connectionOptions: readonly [{
+                readonly connectionMethodId: "oauth";
+                readonly requiredScopes: readonly [];
+            }, {
+                readonly connectionMethodId: "deployment-key";
+                readonly requiredScopes: readonly [];
+            }];
+            readonly serviceId: "convex";
+        };
+        readonly type: "convex.document.created";
+    };
+    readonly convexDocumentDeleted: {
+        readonly account: {
+            readonly connectionOptions: readonly [{
+                readonly connectionMethodId: "oauth";
+                readonly requiredScopes: readonly [];
+            }, {
+                readonly connectionMethodId: "deployment-key";
+                readonly requiredScopes: readonly [];
+            }];
+            readonly serviceId: "convex";
+        };
+        readonly type: "convex.document.deleted";
+    };
+    readonly convexDocumentEvent: {
+        readonly account: {
+            readonly connectionOptions: readonly [{
+                readonly connectionMethodId: "oauth";
+                readonly requiredScopes: readonly [];
+            }, {
+                readonly connectionMethodId: "deployment-key";
+                readonly requiredScopes: readonly [];
+            }];
+            readonly serviceId: "convex";
+        };
+        readonly type: "convex.document.event";
+    };
+    readonly convexDocumentUpdated: {
+        readonly account: {
+            readonly connectionOptions: readonly [{
+                readonly connectionMethodId: "oauth";
+                readonly requiredScopes: readonly [];
+            }, {
+                readonly connectionMethodId: "deployment-key";
+                readonly requiredScopes: readonly [];
+            }];
+            readonly serviceId: "convex";
+        };
+        readonly type: "convex.document.updated";
+    };
+    readonly convexEvent: {
+        readonly account: {
+            readonly connectionOptions: readonly [{
+                readonly connectionMethodId: "deployment-key";
+                readonly requiredScopes: readonly [];
+            }];
+            readonly serviceId: "convex";
+        };
+        readonly getPrimary: ({ appOrigin, automationId, hookSlot, scopePath }: import("..").TriggerPresentationContext) => {
+            copyable: true;
+            value: string;
+        };
+        readonly name: "Convex event";
+        readonly type: "convex.event.received";
+    };
+};

package/dist/triggers/convex.js

@@ -0,0 +1,64 @@
+/**
+ * Returns the public endpoint for one signed Convex semantic-event trigger.
+ *
+ * @param options - Public origin and trigger identity.
+ */
+export function getConvexEventEndpoint(options) {
+    return new URL(`/api/v1/events/convex/${encodeURIComponent(getConvexEventEndpointKey(options))}`, options.appOrigin).toString();
+}
+/**
+ * Returns the stable source key for one Convex semantic-event trigger.
+ *
+ * @param options - Trigger identity without the public origin.
+ */
+export function getConvexEventEndpointKey(options) {
+    return `${options.automationId}:${[
+        ...(options.scopePath ?? []),
+        options.hookSlot,
+    ].join(".")}`;
+}
+const CONVEX_ACCOUNT = {
+    connectionOptions: [
+        { connectionMethodId: "oauth", requiredScopes: [] },
+        { connectionMethodId: "deployment-key", requiredScopes: [] },
+    ],
+    serviceId: "convex",
+};
+const CONVEX_DEPLOYMENT_KEY_ACCOUNT = {
+    connectionOptions: [
+        { connectionMethodId: "deployment-key", requiredScopes: [] },
+    ],
+    serviceId: "convex",
+};
+export const convexTriggerDefinitions = {
+    convexDocumentCreated: {
+        account: CONVEX_ACCOUNT,
+        type: "convex.document.created",
+    },
+    convexDocumentDeleted: {
+        account: CONVEX_ACCOUNT,
+        type: "convex.document.deleted",
+    },
+    convexDocumentEvent: {
+        account: CONVEX_ACCOUNT,
+        type: "convex.document.event",
+    },
+    convexDocumentUpdated: {
+        account: CONVEX_ACCOUNT,
+        type: "convex.document.updated",
+    },
+    convexEvent: {
+        account: CONVEX_DEPLOYMENT_KEY_ACCOUNT,
+        getPrimary: ({ appOrigin, automationId, hookSlot, scopePath }) => ({
+            copyable: true,
+            value: getConvexEventEndpoint({
+                appOrigin,
+                automationId,
+                hookSlot,
+                scopePath,
+            }),
+        }),
+        name: "Convex event",
+        type: "convex.event.received",
+    },
+};

package/dist/triggers/index.d.ts

@@ -1236,6 +1236,73 @@ export declare const triggerDefinitions: {
         readonly name: "Mailhook";
         readonly type: "mailhook.email.received";
     };
+    readonly convexDocumentCreated: {
+        readonly account: {
+            readonly connectionOptions: readonly [{
+                readonly connectionMethodId: "oauth";
+                readonly requiredScopes: readonly [];
+            }, {
+                readonly connectionMethodId: "deployment-key";
+                readonly requiredScopes: readonly [];
+            }];
+            readonly serviceId: "convex";
+        };
+        readonly type: "convex.document.created";
+    };
+    readonly convexDocumentDeleted: {
+        readonly account: {
+            readonly connectionOptions: readonly [{
+                readonly connectionMethodId: "oauth";
+                readonly requiredScopes: readonly [];
+            }, {
+                readonly connectionMethodId: "deployment-key";
+                readonly requiredScopes: readonly [];
+            }];
+            readonly serviceId: "convex";
+        };
+        readonly type: "convex.document.deleted";
+    };
+    readonly convexDocumentEvent: {
+        readonly account: {
+            readonly connectionOptions: readonly [{
+                readonly connectionMethodId: "oauth";
+                readonly requiredScopes: readonly [];
+            }, {
+                readonly connectionMethodId: "deployment-key";
+                readonly requiredScopes: readonly [];
+            }];
+            readonly serviceId: "convex";
+        };
+        readonly type: "convex.document.event";
+    };
+    readonly convexDocumentUpdated: {
+        readonly account: {
+            readonly connectionOptions: readonly [{
+                readonly connectionMethodId: "oauth";
+                readonly requiredScopes: readonly [];
+            }, {
+                readonly connectionMethodId: "deployment-key";
+                readonly requiredScopes: readonly [];
+            }];
+            readonly serviceId: "convex";
+        };
+        readonly type: "convex.document.updated";
+    };
+    readonly convexEvent: {
+        readonly account: {
+            readonly connectionOptions: readonly [{
+                readonly connectionMethodId: "deployment-key";
+                readonly requiredScopes: readonly [];
+            }];
+            readonly serviceId: "convex";
+        };
+        readonly getPrimary: ({ appOrigin, automationId, hookSlot, scopePath }: TriggerPresentationContext) => {
+            copyable: true;
+            value: string;
+        };
+        readonly name: "Convex event";
+        readonly type: "convex.event.received";
+    };
     readonly brevoTransactionalBlocked: {
         readonly account: {
             readonly connectionOptions: readonly [{
@@ -1692,6 +1759,72 @@ export declare const triggerCatalog: ({
         readonly serviceId: "brevo";
     };
     type: "brevo.transactional.unsubscribed";
+} | {
+    name: string;
+    account: {
+        readonly connectionOptions: readonly [{
+            readonly connectionMethodId: "oauth";
+            readonly requiredScopes: readonly [];
+        }, {
+            readonly connectionMethodId: "deployment-key";
+            readonly requiredScopes: readonly [];
+        }];
+        readonly serviceId: "convex";
+    };
+    type: "convex.document.created";
+} | {
+    name: string;
+    account: {
+        readonly connectionOptions: readonly [{
+            readonly connectionMethodId: "oauth";
+            readonly requiredScopes: readonly [];
+        }, {
+            readonly connectionMethodId: "deployment-key";
+            readonly requiredScopes: readonly [];
+        }];
+        readonly serviceId: "convex";
+    };
+    type: "convex.document.deleted";
+} | {
+    name: string;
+    account: {
+        readonly connectionOptions: readonly [{
+            readonly connectionMethodId: "oauth";
+            readonly requiredScopes: readonly [];
+        }, {
+            readonly connectionMethodId: "deployment-key";
+            readonly requiredScopes: readonly [];
+        }];
+        readonly serviceId: "convex";
+    };
+    type: "convex.document.event";
+} | {
+    name: string;
+    account: {
+        readonly connectionOptions: readonly [{
+            readonly connectionMethodId: "oauth";
+            readonly requiredScopes: readonly [];
+        }, {
+            readonly connectionMethodId: "deployment-key";
+            readonly requiredScopes: readonly [];
+        }];
+        readonly serviceId: "convex";
+    };
+    type: "convex.document.updated";
+} | {
+    name: string;
+    account: {
+        readonly connectionOptions: readonly [{
+            readonly connectionMethodId: "deployment-key";
+            readonly requiredScopes: readonly [];
+        }];
+        readonly serviceId: "convex";
+    };
+    getPrimary: ({ appOrigin, automationId, hookSlot, scopePath }: TriggerPresentationContext) => {
+        copyable: true;
+        value: string;
+    };
+    type: "convex.event.received";
 } | {
     name: string;
     getDetails: ({ config }: TriggerPresentationContext) => {

package/dist/triggers/index.js

@@ -1,6 +1,7 @@
 import { airtableTriggerDefinitions } from "./airtable.js";
 import { asanaTriggerDefinitions } from "./asana.js";
 import { brevoTriggerDefinitions } from "./brevo.js";
+import { convexTriggerDefinitions } from "./convex.js";
 import { coreTriggerDefinitions } from "./core.js";
 import { githubTriggerDefinitions } from "./github.js";
 import { googleTriggerDefinitions } from "./google.js";
@@ -19,6 +20,7 @@ export const triggerDefinitions = {
     ...airtableTriggerDefinitions,
     ...asanaTriggerDefinitions,
     ...brevoTriggerDefinitions,
+    ...convexTriggerDefinitions,
     ...coreTriggerDefinitions,
     ...githubTriggerDefinitions,
     ...googleTriggerDefinitions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/catalog",
-  "version": "0.81.0",
+  "version": "0.83.0",
   "description": "Shared integration service and trigger definitions for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -23,6 +23,7 @@
       "./triggers/airtable": "./src/triggers/airtable.ts",
       "./triggers/asana": "./src/triggers/asana.ts",
       "./triggers/brevo": "./src/triggers/brevo.ts",
+      "./triggers/convex": "./src/triggers/convex.ts",
       "./triggers/core-dashboard": "./src/triggers/core-dashboard.ts",
       "./triggers/core-http": "./src/triggers/core-http.ts",
       "./triggers/core-invocation": "./src/triggers/core-invocation.ts",
@@ -45,7 +46,7 @@
     }
   },
   "devDependencies": {
-    "@internal/config": "0.0.0",
+    "@internal/config": "0.1.0",
     "@types/bun": "latest",
     "@typescript/native": "npm:typescript@^7.0.2",
     "@zachsents/oxlint-config": "^0.4.1",
@@ -101,6 +102,11 @@
       "types": "./dist/triggers/brevo.d.ts",
       "default": "./dist/triggers/brevo.js"
     },
+    "./triggers/convex": {
+      "bun": "./src/triggers/convex.ts",
+      "types": "./dist/triggers/convex.d.ts",
+      "default": "./dist/triggers/convex.js"
+    },
     "./triggers/core-dashboard": {
       "bun": "./src/triggers/core-dashboard.ts",
       "types": "./dist/triggers/core-dashboard.d.ts",

package/src/catalog.ts

@@ -134,6 +134,48 @@ export const cohereService = defineApiKeyService({
   name: "Cohere",
 })
 
+export const convexService = defineIntegrationService({
+  connectionMethods: [
+    { id: "oauth", name: "Project OAuth", type: "redirect" },
+    {
+      fields: [
+        {
+          description: "Use the deployment's https://<name>.convex.cloud URL.",
+          input: "url",
+          label: "Deployment URL",
+          name: "deploymentUrl",
+          placeholder: "https://example.convex.cloud",
+          required: true,
+        },
+        {
+          input: "password",
+          label: "Deploy key",
+          name: "deployKey",
+          placeholder: "Paste a Convex deploy key",
+          required: true,
+        },
+        {
+          description:
+            "Set the same value as AUTOMATE_AX_WEBHOOK_SECRET in Convex to emit signed semantic events.",
+          input: "password",
+          label: "Webhook signing secret",
+          name: "webhookSecret",
+          placeholder: "At least 32 characters",
+          required: true,
+        },
+      ],
+      id: "deployment-key",
+      name: "Deployment key",
+      type: "form",
+    },
+  ],
+  description:
+    "Connect a Convex project for function calls and durable event triggers.",
+  id: "convex",
+  name: "Convex",
+  preferredConnectionMethodId: "oauth",
+})
+
 export const deepinfraService = defineApiKeyService({
   description: "Connect a DeepInfra API key.",
   id: "deepinfra",
@@ -270,12 +312,13 @@ export const postgresService = defineIntegrationService({
     {
       fields: [
         {
-          description: "A postgresql:// connection string.",
+          description:
+            "For Supabase, use its provided URL and append ?uselibpqcompat=true&sslmode=require only when you intend libpq's encrypted, non-verifying require behavior.",
           input: "password",
           label: "Connection string",
           name: "connectionString",
           placeholder:
-            "postgresql://user:password@host:5432/database?sslmode=require",
+            "postgresql://postgres.project-ref:password@aws-0-region.pooler.supabase.com:5432/postgres?uselibpqcompat=true&sslmode=require",
           required: true,
         },
       ],
@@ -397,6 +440,7 @@ export const integrationCatalog = defineIntegrationCatalog([
   cloudflareService,
   codexService,
   cohereService,
+  convexService,
   deepinfraService,
   deepseekService,
   firecrawlService,

package/src/index.ts

@@ -9,6 +9,7 @@ export {
   cloudflareService,
   codexService,
   cohereService,
+  convexService,
   deepinfraService,
   deepseekService,
   firecrawlService,

package/src/triggers/convex.ts

@@ -0,0 +1,82 @@
+import type { IntegrationAccountRequirement, TriggerDefinition } from "../types"
+
+export interface ConvexEventEndpointOptions {
+  appOrigin: string
+  automationId: string
+  hookSlot: number
+  scopePath?: readonly number[]
+}
+
+/**
+ * Returns the public endpoint for one signed Convex semantic-event trigger.
+ *
+ * @param options - Public origin and trigger identity.
+ */
+export function getConvexEventEndpoint(options: ConvexEventEndpointOptions) {
+  return new URL(
+    `/api/v1/events/convex/${encodeURIComponent(getConvexEventEndpointKey(options))}`,
+    options.appOrigin,
+  ).toString()
+}
+
+/**
+ * Returns the stable source key for one Convex semantic-event trigger.
+ *
+ * @param options - Trigger identity without the public origin.
+ */
+export function getConvexEventEndpointKey(
+  options: Omit<ConvexEventEndpointOptions, "appOrigin">,
+) {
+  return `${options.automationId}:${[
+    ...(options.scopePath ?? []),
+    options.hookSlot,
+  ].join(".")}`
+}
+
+const CONVEX_ACCOUNT = {
+  connectionOptions: [
+    { connectionMethodId: "oauth", requiredScopes: [] },
+    { connectionMethodId: "deployment-key", requiredScopes: [] },
+  ],
+  serviceId: "convex",
+} as const satisfies IntegrationAccountRequirement
+
+const CONVEX_DEPLOYMENT_KEY_ACCOUNT = {
+  connectionOptions: [
+    { connectionMethodId: "deployment-key", requiredScopes: [] },
+  ],
+  serviceId: "convex",
+} as const satisfies IntegrationAccountRequirement
+
+export const convexTriggerDefinitions = {
+  convexDocumentCreated: {
+    account: CONVEX_ACCOUNT,
+    type: "convex.document.created",
+  },
+  convexDocumentDeleted: {
+    account: CONVEX_ACCOUNT,
+    type: "convex.document.deleted",
+  },
+  convexDocumentEvent: {
+    account: CONVEX_ACCOUNT,
+    type: "convex.document.event",
+  },
+  convexDocumentUpdated: {
+    account: CONVEX_ACCOUNT,
+    type: "convex.document.updated",
+  },
+  convexEvent: {
+    account: CONVEX_DEPLOYMENT_KEY_ACCOUNT,
+    getPrimary: ({ appOrigin, automationId, hookSlot, scopePath }) => ({
+      copyable: true,
+      value: getConvexEventEndpoint({
+        appOrigin,
+        automationId,
+        hookSlot,
+        scopePath,
+      }),
+    }),
+    name: "Convex event",
+    type: "convex.event.received",
+  },
+} as const satisfies Record<string, TriggerDefinition>

package/src/triggers/index.ts

@@ -1,6 +1,7 @@
 import { airtableTriggerDefinitions } from "./airtable"
 import { asanaTriggerDefinitions } from "./asana"
 import { brevoTriggerDefinitions } from "./brevo"
+import { convexTriggerDefinitions } from "./convex"
 import { coreTriggerDefinitions } from "./core"
 import { githubTriggerDefinitions } from "./github"
 import { googleTriggerDefinitions } from "./google"
@@ -43,6 +44,7 @@ export const triggerDefinitions = {
   ...airtableTriggerDefinitions,
   ...asanaTriggerDefinitions,
   ...brevoTriggerDefinitions,
+  ...convexTriggerDefinitions,
   ...coreTriggerDefinitions,
   ...githubTriggerDefinitions,
   ...googleTriggerDefinitions,