@apteva/integrations 0.3.5 → 0.3.6

package/dist/index.d.ts

@@ -1,10 +1,12 @@
-export type { AppTemplate, AppAuthConfig, AuthType, OAuthConfig, CredentialField, AppToolTemplate, AppWebhookConfig, AppWebhookEvent, Connection, ConnectionCredentials, LocalTriggerConfig, GeneratedMcpServer, GeneratedMcpTool, IntegrationsStorage, } from "./types.js";
+export type { AppTemplate, AppAuthConfig, AuthType, OAuthConfig, CredentialField, AppToolTemplate, AppWebhookConfig, AppWebhookEvent, WebhookRegistrationConfig, Connection, ConnectionCredentials, LocalTriggerConfig, GeneratedMcpServer, GeneratedMcpTool, IntegrationsStorage, } from "./types.js";
 export { loadAppTemplates, getAppTemplate, listAppSlugs, listApps, resetAppCache, } from "./apps/index.js";
 export { executeTool } from "./http-executor.js";
 export type { ExecuteToolOptions, ExecuteToolResult } from "./http-executor.js";
 export { getAuthorizationUrl, exchangeCode, refreshAccessToken, tokensToCredentials, isTokenExpired, } from "./oauth.js";
 export type { OAuthStartOptions, OAuthCallbackOptions, OAuthRefreshOptions, OAuthTokenResult, } from "./oauth.js";
 export { generateMcpServer } from "./mcp-generator.js";
+export { registerWebhook, unregisterWebhook, listWebhooks, canAutoRegister, getManualSetupInstructions, } from "./webhook-registrar.js";
+export type { RegisterWebhookOptions, RegisterWebhookResult, UnregisterWebhookOptions, ListWebhooksOptions, ListWebhooksResult, } from "./webhook-registrar.js";
 export { LocalIntegrationProvider } from "./providers/local.js";
 export type { LocalProviderConfig } from "./providers/local.js";
 export { LocalTriggerProvider } from "./triggers/local.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,aAAa,EACb,QAAQ,EACR,WAAW,EACX,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGhF,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,aAAa,EACb,QAAQ,EACR,WAAW,EACX,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EACzB,UAAU,EACV,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGhF,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -6,6 +6,8 @@ export { executeTool } from "./http-executor.js";
 export { getAuthorizationUrl, exchangeCode, refreshAccessToken, tokensToCredentials, isTokenExpired, } from "./oauth.js";
 // ─── MCP Server Generator ───
 export { generateMcpServer } from "./mcp-generator.js";
+// ─── Webhook Registrar ───
+export { registerWebhook, unregisterWebhook, listWebhooks, canAutoRegister, getManualSetupInstructions, } from "./webhook-registrar.js";
 // ─── Local Integration Provider ───
 export { LocalIntegrationProvider } from "./providers/local.js";
 // ─── Local Trigger Provider ───

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,wBAAwB;AACxB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,6BAA6B;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,uBAAuB;AACvB,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC;AAQpB,+BAA+B;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,qCAAqC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,iCAAiC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,wBAAwB;AACxB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,6BAA6B;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,uBAAuB;AACvB,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC;AAQpB,+BAA+B;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,4BAA4B;AAC5B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAShC,qCAAqC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,iCAAiC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/types.d.ts

@@ -12,6 +12,34 @@ export interface AppTemplate {
 export interface AppWebhookConfig {
     signature_header: string;
     events: AppWebhookEvent[];
+    registration?: WebhookRegistrationConfig;
+}
+export interface WebhookRegistrationConfig {
+    /** HTTP method for registering webhook */
+    method: "POST" | "PUT" | "PATCH";
+    /** API path for registering webhook (relative to base_url) */
+    path: string;
+    /** Field name in request body for the callback URL */
+    url_field: string;
+    /** Field name for events list (if API supports filtering by event) */
+    events_field?: string;
+    /** Field name for the webhook secret */
+    secret_field?: string;
+    /** Static fields always included in registration request */
+    extra?: Record<string, unknown>;
+    /** Content-Type for registration request (default: "application/json") */
+    content_type?: string;
+    /** Where to find the webhook ID in the response (dot-notation, e.g. "id" or "result.id") */
+    id_field?: string;
+    /** HTTP method + path to delete a webhook. {id} placeholder for webhook ID */
+    delete_path?: string;
+    delete_method?: "DELETE" | "POST";
+    /** HTTP method + path to list existing webhooks */
+    list_path?: string;
+    /** Where to find webhook array in list response (dot-notation) */
+    list_field?: string;
+    /** Notes for services that can't auto-register (UI-only setup) */
+    manual_setup?: string;
 }
 export interface AppWebhookEvent {
     name: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/webhook-registrar.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Webhook Registrar — automatically registers/unregisters webhook endpoints
+ * with external services using their APIs.
+ *
+ * Uses the `webhooks.registration` config from app templates to know
+ * which API to call, what fields to send, and how to parse the response.
+ */
+import type { AppTemplate, ConnectionCredentials } from "./types.js";
+export interface RegisterWebhookOptions {
+    /** App template with webhook registration config */
+    app: AppTemplate;
+    /** Decrypted credentials for the connection */
+    credentials: ConnectionCredentials;
+    /** The callback URL to register (e.g. https://instance/api/webhooks/local) */
+    callbackUrl: string;
+    /** Event names to subscribe to (from app.webhooks.events[].name) */
+    events?: string[];
+    /** HMAC secret to send to the service for signing payloads */
+    secret?: string;
+    /** Request timeout in ms (default 15000) */
+    timeout?: number;
+}
+export interface RegisterWebhookResult {
+    success: boolean;
+    /** Webhook ID returned by the service (for future deletion) */
+    webhookId?: string;
+    /** Raw response data */
+    data?: unknown;
+    /** Error message if failed */
+    error?: string;
+    /** Whether this service requires manual setup instead */
+    manualSetup?: string;
+}
+export interface UnregisterWebhookOptions {
+    app: AppTemplate;
+    credentials: ConnectionCredentials;
+    webhookId: string;
+    timeout?: number;
+}
+export interface ListWebhooksOptions {
+    app: AppTemplate;
+    credentials: ConnectionCredentials;
+    timeout?: number;
+}
+export interface ListWebhooksResult {
+    success: boolean;
+    webhooks?: Array<{
+        id: string;
+        url?: string;
+        events?: string[];
+        active?: boolean;
+    }>;
+    error?: string;
+}
+/**
+ * Check if an app supports automatic webhook registration.
+ */
+export declare function canAutoRegister(app: AppTemplate): boolean;
+/**
+ * Get manual setup instructions if auto-registration isn't supported.
+ */
+export declare function getManualSetupInstructions(app: AppTemplate): string | null;
+/**
+ * Register a webhook with an external service.
+ */
+export declare function registerWebhook(opts: RegisterWebhookOptions): Promise<RegisterWebhookResult>;
+/**
+ * Unregister (delete) a webhook from an external service.
+ */
+export declare function unregisterWebhook(opts: UnregisterWebhookOptions): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * List existing webhooks registered with an external service.
+ */
+export declare function listWebhooks(opts: ListWebhooksOptions): Promise<ListWebhooksResult>;
+//# sourceMappingURL=webhook-registrar.d.ts.map

package/dist/webhook-registrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-registrar.d.ts","sourceRoot":"","sources":["../src/webhook-registrar.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,GAAG,EAAE,WAAW,CAAC;IACjB,+CAA+C;IAC/C,WAAW,EAAE,qBAAqB,CAAC;IACnC,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,EAAE,qBAAqB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,EAAE,qBAAqB,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,qBAAqB,CAAC,CAmFhC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+B/C;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAgD7B"}

package/dist/webhook-registrar.js

@@ -0,0 +1,280 @@
+/**
+ * Webhook Registrar — automatically registers/unregisters webhook endpoints
+ * with external services using their APIs.
+ *
+ * Uses the `webhooks.registration` config from app templates to know
+ * which API to call, what fields to send, and how to parse the response.
+ */
+/**
+ * Check if an app supports automatic webhook registration.
+ */
+export function canAutoRegister(app) {
+    return !!(app.webhooks?.registration && !app.webhooks.registration.manual_setup);
+}
+/**
+ * Get manual setup instructions if auto-registration isn't supported.
+ */
+export function getManualSetupInstructions(app) {
+    return app.webhooks?.registration?.manual_setup || null;
+}
+/**
+ * Register a webhook with an external service.
+ */
+export async function registerWebhook(opts) {
+    const { app, credentials, callbackUrl, events, secret, timeout = 15000 } = opts;
+    const reg = app.webhooks?.registration;
+    if (!reg) {
+        return { success: false, error: "No webhook registration config for this app" };
+    }
+    if (reg.manual_setup) {
+        return { success: false, manualSetup: reg.manual_setup };
+    }
+    // Build URL
+    const url = buildUrl(app.base_url, reg.path, credentials);
+    // Build headers
+    const headers = buildAuthHeaders(app, credentials);
+    const contentType = reg.content_type || "application/json";
+    headers["Content-Type"] = contentType;
+    // Build request body — supports nested dot-notation fields like "config.url" or "webhook.address"
+    const body = {};
+    // Static extra fields first (so specific fields override)
+    if (reg.extra) {
+        deepMerge(body, reg.extra);
+    }
+    // Callback URL
+    setNestedField(body, reg.url_field, callbackUrl);
+    // Events
+    if (reg.events_field && events && events.length > 0) {
+        setNestedField(body, reg.events_field, events);
+    }
+    // Secret
+    if (reg.secret_field && secret) {
+        setNestedField(body, reg.secret_field, secret);
+    }
+    try {
+        const response = await fetch(url, {
+            method: reg.method,
+            headers,
+            body: contentType.includes("x-www-form-urlencoded")
+                ? buildFormBody(flattenForForm(body))
+                : JSON.stringify(body),
+            signal: AbortSignal.timeout(timeout),
+        });
+        let data;
+        const ct = response.headers.get("content-type") || "";
+        if (ct.includes("application/json")) {
+            data = await response.json();
+        }
+        else {
+            data = await response.text();
+        }
+        if (!response.ok) {
+            return {
+                success: false,
+                error: `HTTP ${response.status}: ${typeof data === "string" ? data : JSON.stringify(data)}`,
+                data,
+            };
+        }
+        // Extract webhook ID from response
+        const webhookId = reg.id_field && data && typeof data === "object"
+            ? extractPath(data, reg.id_field)
+            : undefined;
+        return {
+            success: true,
+            webhookId: webhookId ? String(webhookId) : undefined,
+            data,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Unregister (delete) a webhook from an external service.
+ */
+export async function unregisterWebhook(opts) {
+    const { app, credentials, webhookId, timeout = 15000 } = opts;
+    const reg = app.webhooks?.registration;
+    if (!reg?.delete_path) {
+        return { success: false, error: "No webhook delete config for this app" };
+    }
+    const path = reg.delete_path.replace("{id}", encodeURIComponent(webhookId));
+    const url = buildUrl(app.base_url, path, credentials);
+    const headers = buildAuthHeaders(app, credentials);
+    try {
+        const response = await fetch(url, {
+            method: reg.delete_method || "DELETE",
+            headers,
+            signal: AbortSignal.timeout(timeout),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            return { success: false, error: `HTTP ${response.status}: ${text}` };
+        }
+        return { success: true };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * List existing webhooks registered with an external service.
+ */
+export async function listWebhooks(opts) {
+    const { app, credentials, timeout = 15000 } = opts;
+    const reg = app.webhooks?.registration;
+    if (!reg?.list_path) {
+        return { success: false, error: "No webhook list config for this app" };
+    }
+    const url = buildUrl(app.base_url, reg.list_path, credentials);
+    const headers = buildAuthHeaders(app, credentials);
+    try {
+        const response = await fetch(url, {
+            method: "GET",
+            headers,
+            signal: AbortSignal.timeout(timeout),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            return { success: false, error: `HTTP ${response.status}: ${text}` };
+        }
+        const data = await response.json();
+        // Extract webhooks array from response
+        let webhooksRaw = [];
+        if (reg.list_field) {
+            const extracted = extractPath(data, reg.list_field);
+            if (Array.isArray(extracted))
+                webhooksRaw = extracted;
+        }
+        else if (Array.isArray(data)) {
+            webhooksRaw = data;
+        }
+        const webhooks = webhooksRaw.map((w) => ({
+            id: String(w.id || w.webhook_id || ""),
+            url: w.url || w.address || w.endpoint || w.callback_url || undefined,
+            events: w.events || w.enabled_events || w.topics || undefined,
+            active: w.active !== undefined ? !!w.active : (w.status === "active" || true),
+        }));
+        return { success: true, webhooks };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+// ─── Helpers ───
+function buildUrl(baseUrl, path, credentials) {
+    // Replace {param} placeholders in base_url and path with credential fields
+    let resolved = `${baseUrl.replace(/\/$/, "")}${path}`;
+    resolved = resolved.replace(/\{(\w+)\}/g, (_match, key) => {
+        return credentials.fields?.[key] || "";
+    });
+    return resolved;
+}
+function buildAuthHeaders(app, credentials) {
+    const headers = {};
+    if (app.auth.headers) {
+        for (const [key, template] of Object.entries(app.auth.headers)) {
+            headers[key] = resolveTemplate(template, credentials);
+        }
+    }
+    return headers;
+}
+function resolveTemplate(template, credentials) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+        switch (key) {
+            case "token":
+                return credentials.access_token || credentials.bearer_token || credentials.api_key || "";
+            case "api_key":
+                return credentials.api_key || "";
+            case "username":
+                return credentials.username || "";
+            case "password":
+                return credentials.password || "";
+            default:
+                return credentials.fields?.[key] || "";
+        }
+    });
+}
+function extractPath(data, jsonPath) {
+    const parts = jsonPath.split(".");
+    let current = data;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return current;
+        if (typeof current === "object") {
+            current = current[part];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+/**
+ * Set a value at a dot-notation path in an object, creating intermediate objects as needed.
+ * e.g. setNestedField(body, "config.url", "https://...") → body.config.url = "https://..."
+ */
+function setNestedField(obj, path, value) {
+    const parts = path.split(".");
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (!(parts[i] in current) || typeof current[parts[i]] !== "object") {
+            current[parts[i]] = {};
+        }
+        current = current[parts[i]];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+/**
+ * Deep merge source into target (mutates target).
+ */
+function deepMerge(target, source) {
+    for (const [key, value] of Object.entries(source)) {
+        if (value && typeof value === "object" && !Array.isArray(value) && typeof target[key] === "object" && target[key]) {
+            deepMerge(target[key], value);
+        }
+        else {
+            target[key] = value;
+        }
+    }
+}
+/**
+ * Flatten nested objects for form-urlencoded encoding.
+ * e.g. { enabled_events: ["a", "b"] } → { "enabled_events[0]": "a", "enabled_events[1]": "b" }
+ * Stripe-style array encoding.
+ */
+function flattenForForm(obj, prefix = "") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}[${key}]` : key;
+        if (Array.isArray(value)) {
+            for (let i = 0; i < value.length; i++) {
+                result[`${fullKey}[${i}]`] = String(value[i]);
+            }
+        }
+        else if (value && typeof value === "object") {
+            Object.assign(result, flattenForForm(value, fullKey));
+        }
+        else if (value !== undefined && value !== null) {
+            result[fullKey] = String(value);
+        }
+    }
+    return result;
+}
+function buildFormBody(params) {
+    const parts = [];
+    for (const [key, value] of Object.entries(params)) {
+        parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
+    }
+    return parts.join("&");
+}
+//# sourceMappingURL=webhook-registrar.js.map

package/dist/webhook-registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-registrar.js","sourceRoot":"","sources":["../src/webhook-registrar.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apteva/integrations",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Local integrations, connections, and webhooks for Apteva. Self-contained app templates, OAuth engine, and trigger provider.",
   "author": "Apteva <hello@apteva.com>",
   "license": "Elastic-2.0",

package/src/apps/brevo.json

@@ -1487,6 +1487,20 @@
         "name": "contactDeleted",
         "description": "Contact was deleted from the account"
       }
-    ]
+    ],
+    "registration": {
+      "method": "POST",
+      "path": "/webhooks",
+      "url_field": "url",
+      "events_field": "events",
+      "extra": {
+        "type": "transactional"
+      },
+      "id_field": "id",
+      "delete_path": "/webhooks/{id}",
+      "delete_method": "DELETE",
+      "list_path": "/webhooks",
+      "list_field": "webhooks"
+    }
   }
 }

package/src/apps/chargebee.json

@@ -258,6 +258,9 @@
         "name": "customer_created",
         "description": "New customer created"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Go to Chargebee Settings > Configure Chargebee > Webhooks to register your webhook URL."
+    }
   }
 }

package/src/apps/convertkit.json

@@ -235,6 +235,9 @@
         "name": "purchase.purchase_create",
         "description": "New purchase recorded"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Configure webhooks in the ConvertKit dashboard settings."
+    }
   }
 }

package/src/apps/gigs-marketplace.json

@@ -1482,6 +1482,9 @@
         "name": "gig.instruction_completed",
         "description": "Gig instruction marked complete"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Configure webhooks in the Gigs Marketplace dashboard settings."
+    }
   }
 }

package/src/apps/github.json

@@ -306,7 +306,7 @@
     },
     {
       "name": "get_contents",
-      "description": "Get repository contents — a file (with content) or directory listing. For files up to 1MB, content is base64 encoded.",
+      "description": "Get repository contents \u2014 a file (with content) or directory listing. For files up to 1MB, content is base64 encoded.",
       "method": "GET",
       "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/contents/%7B%7Bpath%7D%7D",
       "input_schema": {
@@ -520,11 +520,11 @@
           },
           "since": {
             "type": "string",
-            "description": "ISO 8601 date — only commits after this date"
+            "description": "ISO 8601 date \u2014 only commits after this date"
           },
           "until": {
             "type": "string",
-            "description": "ISO 8601 date — only commits before this date"
+            "description": "ISO 8601 date \u2014 only commits before this date"
           },
           "per_page": {
             "type": "integer",
@@ -689,7 +689,7 @@
     },
     {
       "name": "update_issue",
-      "description": "Update an issue — change title, body, state, labels, or assignees",
+      "description": "Update an issue \u2014 change title, body, state, labels, or assignees",
       "method": "PATCH",
       "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/issues/%7B%7Bissue_number%7D%7D",
       "input_schema": {
@@ -1586,6 +1586,23 @@
         "name": "deployment_status",
         "description": "Deployment status updated"
       }
-    ]
+    ],
+    "registration": {
+      "method": "POST",
+      "path": "/repos/{owner}/{repo}/hooks",
+      "url_field": "config.url",
+      "events_field": "events",
+      "secret_field": "config.secret",
+      "extra": {
+        "config": {
+          "content_type": "json"
+        },
+        "active": true
+      },
+      "id_field": "id",
+      "delete_path": "/repos/{owner}/{repo}/hooks/{id}",
+      "delete_method": "DELETE",
+      "list_path": "/repos/{owner}/{repo}/hooks"
+    }
   }
 }

package/src/apps/gohighlevel.json

@@ -632,6 +632,9 @@
         "name": "note.created",
         "description": "New note added"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Configure webhooks in the GoHighLevel Settings > Webhooks section."
+    }
   }
 }

package/src/apps/helpscout.json

@@ -712,6 +712,9 @@
         "name": "satisfaction.ratings",
         "description": "A customer submitted a satisfaction rating"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Configure webhooks in Help Scout Settings > Webhooks."
+    }
   }
 }

package/src/apps/hubspot.json

@@ -726,6 +726,9 @@
         "name": "ticket.deletion",
         "description": "Ticket deleted"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Go to HubSpot Settings > Integrations > Private Apps > Your App > Webhooks to register. HubSpot webhooks require an app-level subscription, not a per-token API call."
+    }
   }
 }

package/src/apps/intercom.json

@@ -688,6 +688,9 @@
         "name": "contact.tag.created",
         "description": "Tag added to contact"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Go to Intercom Developer Hub > Your App > Webhooks to register your webhook URL."
+    }
   }
 }

package/src/apps/jira.json

@@ -266,6 +266,19 @@
         "name": "worklog_created",
         "description": "Work log entry added"
       }
-    ]
+    ],
+    "registration": {
+      "method": "POST",
+      "path": "/rest/webhooks/1.0/webhook",
+      "url_field": "url",
+      "events_field": "events",
+      "extra": {
+        "name": "Apteva Webhook"
+      },
+      "id_field": "self",
+      "delete_path": "/rest/webhooks/1.0/webhook/{id}",
+      "delete_method": "DELETE",
+      "list_path": "/rest/webhooks/1.0/webhook"
+    }
   }
 }

package/src/apps/late.json

@@ -1080,6 +1080,9 @@
         "name": "account.disconnected",
         "description": "A social media account was disconnected"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Configure webhooks in the Late dashboard settings."
+    }
   }
 }

package/src/apps/linear.json

@@ -262,6 +262,9 @@
         "name": "label.created",
         "description": "New label created"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Go to Linear Settings > API > Webhooks to register your webhook URL. Linear does not support webhook creation via REST API \u2014 it requires GraphQL mutations."
+    }
   }
 }

package/src/apps/mailchimp.json

@@ -258,6 +258,30 @@
         "name": "profile.updated",
         "description": "Subscriber profile changed"
       }
-    ]
+    ],
+    "registration": {
+      "method": "POST",
+      "path": "/lists/{list_id}/webhooks",
+      "url_field": "url",
+      "extra": {
+        "sources": {
+          "user": true,
+          "admin": true,
+          "api": true
+        },
+        "events": {
+          "subscribe": true,
+          "unsubscribe": true,
+          "profile": true,
+          "cleaned": true,
+          "campaign": true
+        }
+      },
+      "id_field": "id",
+      "delete_path": "/lists/{list_id}/webhooks/{id}",
+      "delete_method": "DELETE",
+      "list_path": "/lists/{list_id}/webhooks",
+      "list_field": "webhooks"
+    }
   }
 }

package/src/apps/notion.json

@@ -158,7 +158,7 @@
           },
           "icon": {
             "type": "object",
-            "description": "Database icon. Example: { \"type\": \"emoji\", \"emoji\": \"📋\" }"
+            "description": "Database icon. Example: { \"type\": \"emoji\", \"emoji\": \"\ud83d\udccb\" }"
           },
           "cover": {
             "type": "object",
@@ -243,7 +243,7 @@
           },
           "icon": {
             "type": "object",
-            "description": "Page icon. Example: { \"type\": \"emoji\", \"emoji\": \"📄\" }"
+            "description": "Page icon. Example: { \"type\": \"emoji\", \"emoji\": \"\ud83d\udcc4\" }"
           },
           "cover": {
             "type": "object",
@@ -640,6 +640,9 @@
         "name": "comment.deleted",
         "description": "A comment is removed"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Notion webhooks are in beta. Go to notion.so/my-integrations > Your Integration to configure webhook URL."
+    }
   }
 }

package/src/apps/omnikit-cms.json

@@ -923,6 +923,23 @@
         "name": "content.unpublished",
         "description": "Published content entry unpublished"
       }
-    ]
+    ],
+    "registration": {
+      "method": "POST",
+      "path": "/webhooks-register",
+      "url_field": "endpoint_url",
+      "events_field": "event_types",
+      "secret_field": "secret_key",
+      "extra": {
+        "name": "Apteva Webhook",
+        "auth_type": "hmac-sha256",
+        "direction": "outgoing"
+      },
+      "id_field": "id",
+      "delete_path": "/webhooks-delete/{id}",
+      "delete_method": "DELETE",
+      "list_path": "/webhooks-list",
+      "list_field": "webhooks"
+    }
   }
 }

package/src/apps/omnikit-messaging.json

@@ -1890,6 +1890,23 @@
         "name": "messaging.campaign_failed",
         "description": "Campaign failed to send"
       }
-    ]
+    ],
+    "registration": {
+      "method": "POST",
+      "path": "/webhooks-register",
+      "url_field": "endpoint_url",
+      "events_field": "event_types",
+      "secret_field": "secret_key",
+      "extra": {
+        "name": "Apteva Webhook",
+        "auth_type": "hmac-sha256",
+        "direction": "outgoing"
+      },
+      "id_field": "id",
+      "delete_path": "/webhooks-delete/{id}",
+      "delete_method": "DELETE",
+      "list_path": "/webhooks-list",
+      "list_field": "webhooks"
+    }
   }
 }

package/src/apps/sendgrid-email.json

@@ -269,6 +269,24 @@
         "name": "email.unsubscribe",
         "description": "Recipient unsubscribed"
       }
-    ]
+    ],
+    "registration": {
+      "method": "PATCH",
+      "path": "/user/webhooks/event/settings",
+      "url_field": "url",
+      "extra": {
+        "enabled": true,
+        "bounce": true,
+        "click": true,
+        "deferred": true,
+        "delivered": true,
+        "dropped": true,
+        "open": true,
+        "processed": true,
+        "spam_report": true,
+        "unsubscribe": true
+      },
+      "list_path": "/user/webhooks/event/settings"
+    }
   }
 }

package/src/apps/shopify.json

@@ -1281,6 +1281,21 @@
         "name": "app/uninstalled",
         "description": "App uninstalled from store"
       }
-    ]
+    ],
+    "registration": {
+      "method": "POST",
+      "path": "/webhooks.json",
+      "url_field": "webhook.address",
+      "extra": {
+        "webhook": {
+          "format": "json"
+        }
+      },
+      "id_field": "webhook.id",
+      "delete_path": "/webhooks/{id}.json",
+      "delete_method": "DELETE",
+      "list_path": "/webhooks.json",
+      "list_field": "webhooks"
+    }
   }
 }

package/src/apps/slack.json

@@ -314,6 +314,9 @@
         "name": "team.join",
         "description": "New user joined workspace"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Go to api.slack.com/apps > Your App > Event Subscriptions to register your webhook URL. Slack requires app-level configuration, not API calls."
+    }
   }
 }

package/src/apps/socialcast.json

@@ -1,7 +1,7 @@
 {
   "slug": "socialcast",
   "name": "SocialCast",
-  "description": "Unified social media posting platform — connect accounts across 9 platforms and publish everywhere at once",
+  "description": "Unified social media posting platform \u2014 connect accounts across 9 platforms and publish everywhere at once",
   "logo": "https://socialcast.dev/favicon-192.png",
   "categories": [
     "social-media",
@@ -35,7 +35,7 @@
   "tools": [
     {
       "name": "list_accounts",
-      "description": "List all connected social media accounts for the project. Optionally filter by platform or status. Accounts with status 'active' are fully configured and ready to post — do NOT suggest setup steps for active accounts. The platform_metadata field contains internal IDs used by the system (pageId, instagramAccountId, etc.) and should not be interpreted as incomplete setup.",
+      "description": "List all connected social media accounts for the project. Optionally filter by platform or status. Accounts with status 'active' are fully configured and ready to post \u2014 do NOT suggest setup steps for active accounts. The platform_metadata field contains internal IDs used by the system (pageId, instagramAccountId, etc.) and should not be interpreted as incomplete setup.",
       "method": "GET",
       "path": "/accounts",
       "input_schema": {
@@ -217,7 +217,7 @@
           },
           "media_urls": {
             "type": "array",
-            "description": "Media attachments — array of objects with url, type (image/video), and optional alt_text",
+            "description": "Media attachments \u2014 array of objects with url, type (image/video), and optional alt_text",
             "items": {
               "type": "object",
               "properties": {
@@ -266,7 +266,7 @@
           },
           "platform_overrides": {
             "type": "object",
-            "description": "Per-platform overrides keyed by platform name. Only include platforms you want to customize. Available fields per platform: youtube: {title, description, tags (array), privacyStatus (public/unlisted/private), categoryId (default 22=People & Blogs)}. reddit: {title, subreddit, text, nsfw}. pinterest: {title, description, board_id}. tiktok: {title, text, privacyLevel}. linkedin: {text, visibility}. facebook: {text, title (video only)}. twitter: {text}. instagram: {text}. telegram: {text, chatId, parseMode}. All fields are optional — omitted fields fall back to the main post text.",
+            "description": "Per-platform overrides keyed by platform name. Only include platforms you want to customize. Available fields per platform: youtube: {title, description, tags (array), privacyStatus (public/unlisted/private), categoryId (default 22=People & Blogs)}. reddit: {title, subreddit, text, nsfw}. pinterest: {title, description, board_id}. tiktok: {title, text, privacyLevel}. linkedin: {text, visibility}. facebook: {text, title (video only)}. twitter: {text}. instagram: {text}. telegram: {text, chatId, parseMode}. All fields are optional \u2014 omitted fields fall back to the main post text.",
             "properties": {
               "twitter": {
                 "type": "object"
@@ -481,7 +481,7 @@
     },
     {
       "name": "list_inbox",
-      "description": "List social inbox items — comments, replies, and DMs received on your connected accounts. Filter by platform, account, status, or type. Returns items sorted by most recent first with unread count.",
+      "description": "List social inbox items \u2014 comments, replies, and DMs received on your connected accounts. Filter by platform, account, status, or type. Returns items sorted by most recent first with unread count.",
       "method": "GET",
       "path": "/inbox",
       "input_schema": {
@@ -604,7 +604,7 @@
     },
     {
       "name": "update_inbox",
-      "description": "Update the status of inbox items — mark as read, replied, or archived. Supports single item, bulk IDs, or mark-all-read for an account.",
+      "description": "Update the status of inbox items \u2014 mark as read, replied, or archived. Supports single item, bulk IDs, or mark-all-read for an account.",
       "method": "PUT",
       "path": "/inbox",
       "input_schema": {
@@ -637,7 +637,7 @@
           },
           "social_account_id": {
             "type": "integer",
-            "description": "Filter for mark_all_read — only mark items from this account"
+            "description": "Filter for mark_all_read \u2014 only mark items from this account"
           }
         }
       }
@@ -693,6 +693,9 @@
         "name": "social.comment.deleted",
         "description": "A comment was removed from a post"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Configure webhooks in the SocialCast dashboard settings."
+    }
   }
 }

package/src/apps/stripe-payments.json

@@ -895,6 +895,18 @@
         "name": "charge.refunded",
         "description": "Occurs when a charge is refunded"
       }
-    ]
+    ],
+    "registration": {
+      "method": "POST",
+      "path": "/webhook_endpoints",
+      "url_field": "url",
+      "events_field": "enabled_events",
+      "content_type": "application/x-www-form-urlencoded",
+      "id_field": "id",
+      "delete_path": "/webhook_endpoints/{id}",
+      "delete_method": "DELETE",
+      "list_path": "/webhook_endpoints",
+      "list_field": "data"
+    }
   }
 }

package/src/apps/stripe.json

@@ -573,6 +573,18 @@
         "name": "charge.refunded",
         "description": "Occurs when a charge is refunded"
       }
-    ]
+    ],
+    "registration": {
+      "method": "POST",
+      "path": "/webhook_endpoints",
+      "url_field": "url",
+      "events_field": "enabled_events",
+      "content_type": "application/x-www-form-urlencoded",
+      "id_field": "id",
+      "delete_path": "/webhook_endpoints/{id}",
+      "delete_method": "DELETE",
+      "list_path": "/webhook_endpoints",
+      "list_field": "data"
+    }
   }
 }

package/src/apps/twilio.json

@@ -1,7 +1,7 @@
 {
   "slug": "twilio",
   "name": "Twilio",
-  "description": "Twilio communications platform — SMS, MMS, voice calls, WhatsApp, phone numbers, recordings, usage, and verification",
+  "description": "Twilio communications platform \u2014 SMS, MMS, voice calls, WhatsApp, phone numbers, recordings, usage, and verification",
   "logo": "https://www.google.com/s2/favicons?domain=twilio.com&sz=128",
   "categories": [
     "messaging",
@@ -133,7 +133,7 @@
               "whatsapp"
             ],
             "default": "whatsapp",
-            "description": "Channel type — must be 'whatsapp'"
+            "description": "Channel type \u2014 must be 'whatsapp'"
           }
         },
         "required": [
@@ -320,7 +320,7 @@
     },
     {
       "name": "update_call",
-      "description": "Modify an in-progress call — redirect to new TwiML, end the call, or pause/resume recording.",
+      "description": "Modify an in-progress call \u2014 redirect to new TwiML, end the call, or pause/resume recording.",
       "method": "POST",
       "path": "/Accounts/%7B%7Bcredential.account_sid%7D%7D/Calls/%7B%7BCallSid%7D%7D.json",
       "input_schema": {
@@ -408,7 +408,7 @@
     },
     {
       "name": "update_phone_number",
-      "description": "Update configuration for a phone number — webhooks, friendly name, voice/SMS settings.",
+      "description": "Update configuration for a phone number \u2014 webhooks, friendly name, voice/SMS settings.",
       "method": "POST",
       "path": "/Accounts/%7B%7Bcredential.account_sid%7D%7D/IncomingPhoneNumbers/%7B%7BPhoneNumberSid%7D%7D.json",
       "input_schema": {
@@ -624,7 +624,7 @@
     },
     {
       "name": "get_usage",
-      "description": "Retrieve usage records for your account — see costs per category (calls, SMS, numbers, etc.).",
+      "description": "Retrieve usage records for your account \u2014 see costs per category (calls, SMS, numbers, etc.).",
       "method": "GET",
       "path": "/Accounts/%7B%7Bcredential.account_sid%7D%7D/Usage/Records.json",
       "input_schema": {
@@ -668,7 +668,7 @@
     },
     {
       "name": "get_whatsapp_sender",
-      "description": "Get details of a specific WhatsApp Business sender by SID — status, phone number, profile info, and capabilities.",
+      "description": "Get details of a specific WhatsApp Business sender by SID \u2014 status, phone number, profile info, and capabilities.",
       "method": "GET",
       "path": "/v2/Channels/Senders/%7B%7BSenderSid%7D%7D",
       "input_schema": {
@@ -795,7 +795,7 @@
     },
     {
       "name": "get_content_template",
-      "description": "Retrieve details of a specific content template by SID — body, variables, type, and approval status.",
+      "description": "Retrieve details of a specific content template by SID \u2014 body, variables, type, and approval status.",
       "method": "GET",
       "path": "/v1/Content/%7B%7BContentSid%7D%7D",
       "input_schema": {
@@ -897,7 +897,7 @@
     },
     {
       "name": "lookup_phone_number",
-      "description": "Look up information about a phone number — carrier, caller name, line type (mobile/landline/voip).",
+      "description": "Look up information about a phone number \u2014 carrier, caller name, line type (mobile/landline/voip).",
       "method": "GET",
       "path": "/v2/PhoneNumbers/%7B%7BPhoneNumber%7D%7D",
       "input_schema": {
@@ -1052,6 +1052,9 @@
         "name": "recording.completed",
         "description": "Call recording ready"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Twilio webhooks are configured per-phone-number. Go to Twilio Console > Phone Numbers > Your Number to set the webhook URL for SMS/Voice."
+    }
   }
 }

package/src/apps/typeform.json

@@ -214,6 +214,9 @@
         "name": "form_response",
         "description": "New form response submitted"
       }
-    ]
+    ],
+    "registration": {
+      "manual_setup": "Go to your Typeform form > Connect > Webhooks to register your webhook URL."
+    }
   }
 }