@friggframework/core 2.0.0--canary.690.08cd07e.0 → 2.0.0--canary.693.d8859c2.0

package/integrations/data-defined/capabilities/webflow.capabilities.json

@@ -0,0 +1,196 @@
+{
+  "$schema": "https://friggframework.org/schemas/capability-manifest/v0.1.json",
+  "module": "webflow",
+  "label": "Webflow",
+  "package": "@friggframework/api-module-webflow",
+  "version": "2.0.0",
+  "auth": "oauth2",
+  "objects": {
+    "formSubmission": {
+      "label": "Form submission",
+      "fields": [
+        {
+          "name": "id",
+          "type": "id",
+          "readOnly": true
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "tag": "form.name"
+        },
+        {
+          "name": "formId",
+          "type": "string"
+        },
+        {
+          "name": "siteId",
+          "type": "string"
+        },
+        {
+          "name": "publishedPath",
+          "type": "string",
+          "tag": "web.pagePath"
+        },
+        {
+          "name": "submittedAt",
+          "type": "datetime",
+          "tag": "record.createdAt"
+        },
+        {
+          "name": "data.Name",
+          "type": "string",
+          "tag": "person.fullName"
+        },
+        {
+          "name": "data.Email",
+          "type": "email",
+          "tag": "contact.email"
+        },
+        {
+          "name": "data.Phone",
+          "type": "phone",
+          "tag": "contact.phone"
+        },
+        {
+          "name": "data.Company",
+          "type": "string",
+          "tag": "organization.name"
+        },
+        {
+          "name": "data.Interest",
+          "type": "enum",
+          "values": [
+            "Sales",
+            "Support",
+            "Partnerships"
+          ]
+        },
+        {
+          "name": "data.Message",
+          "type": "text"
+        },
+        {
+          "name": "data.Website",
+          "type": "string",
+          "help": "Hidden honeypot field; humans leave it empty."
+        }
+      ]
+    }
+  },
+  "events": {
+    "form.submitted": {
+      "delivery": "webhook",
+      "object": "formSubmission",
+      "subscribe": "webhook.create",
+      "description": "triggerType form_submission, registered per site.",
+      "payload": {
+        "triggerType": "form_submission",
+        "payload": {
+          "name": "Contact Us",
+          "siteId": "65427cf400e02b306eaa049c",
+          "formId": "65429eadebe8a9f3a30f62d0",
+          "formElementId": "4e038d2c-6a1e-4953-7be9-a59a2b453177",
+          "pageId": "65427cf400e02b306eaa04a0",
+          "publishedPath": "/contact",
+          "id": "6321ca84df3949bfc6752327",
+          "submittedAt": "2026-10-20T17:12:00.000Z",
+          "data": {
+            "Name": "Priya Natarajan",
+            "Email": "priya@acme.example",
+            "Phone": "512 555 0177",
+            "Company": "Acme Corp",
+            "Interest": "Sales",
+            "Message": "We need a Salesforce \u2194 NetSuite integration by Q1.",
+            "Website": ""
+          }
+        }
+      },
+      "record": "payload",
+      "idPath": "payload.id",
+      "match": "form_submission"
+    }
+  },
+  "webhook": {
+    "scope": "installation",
+    "topic": "{{body.triggerType}}",
+    "eventId": "{{body.payload.id}}",
+    "verify": "verifyWebhookSignature"
+  },
+  "capabilities": {
+    "site.list": {
+      "kind": "read",
+      "method": "listSites",
+      "input": {},
+      "output": "site[]"
+    },
+    "form.list": {
+      "kind": "read",
+      "method": "listForms",
+      "input": {
+        "siteId": {
+          "type": "string",
+          "required": true
+        }
+      },
+      "output": "form[]"
+    },
+    "form.submissions": {
+      "kind": "read",
+      "method": "listFormSubmissions",
+      "input": {
+        "formId": {
+          "type": "string",
+          "required": true
+        },
+        "offset": {
+          "type": "number"
+        },
+        "limit": {
+          "type": "number"
+        }
+      },
+      "output": "formSubmission[]"
+    },
+    "webhook.create": {
+      "kind": "subscribe",
+      "method": "createWebhook",
+      "input": {
+        "siteId": {
+          "type": "string",
+          "required": true
+        },
+        "triggerType": {
+          "type": "string",
+          "required": true
+        },
+        "url": {
+          "type": "string",
+          "required": true
+        },
+        "filter": {
+          "type": "object"
+        }
+      },
+      "output": "webhook"
+    },
+    "webhook.delete": {
+      "kind": "delete",
+      "method": "deleteWebhook",
+      "input": {
+        "webhookId": {
+          "type": "string",
+          "required": true
+        }
+      },
+      "output": "void"
+    }
+  },
+  "options": {
+    "site": {
+      "capability": "site.list",
+      "label": "{{item.displayName}}",
+      "value": "$.item.id"
+    }
+  }
+}

package/integrations/data-defined/capabilities/zendesk.capabilities.json

@@ -0,0 +1,409 @@
+{
+  "$schema": "https://friggframework.org/schemas/capability-manifest/v0.1.json",
+  "module": "zendesk",
+  "label": "Zendesk Support",
+  "package": "@friggframework/api-module-zendesk",
+  "version": "1.6.0",
+  "auth": "oauth2",
+  "account": {
+    "description": "Values about the connected account, persisted by the module (apiPropertiesToPersist). Definitions read them as $.install.accounts.<module key>.<name>.",
+    "fields": [
+      {
+        "name": "subdomain",
+        "type": "string",
+        "description": "Zendesk subdomain (acme in acme.zendesk.com)"
+      }
+    ]
+  },
+  "objects": {
+    "ticket": {
+      "label": "Ticket",
+      "fields": [
+        {
+          "name": "id",
+          "type": "id",
+          "tag": "record.displayId",
+          "readOnly": true
+        },
+        {
+          "name": "subject",
+          "type": "string",
+          "tag": "ticket.subject"
+        },
+        {
+          "name": "description",
+          "type": "text",
+          "tag": "ticket.description",
+          "readOnly": true
+        },
+        {
+          "name": "status",
+          "type": "enum",
+          "tag": "ticket.status",
+          "values": [
+            "new",
+            "open",
+            "pending",
+            "hold",
+            "solved",
+            "closed"
+          ]
+        },
+        {
+          "name": "priority",
+          "type": "enum",
+          "tag": "ticket.priority",
+          "values": [
+            "low",
+            "normal",
+            "high",
+            "urgent"
+          ]
+        },
+        {
+          "name": "type",
+          "type": "enum",
+          "values": [
+            "problem",
+            "incident",
+            "question",
+            "task"
+          ]
+        },
+        {
+          "name": "requester_id",
+          "type": "string"
+        },
+        {
+          "name": "assignee_id",
+          "type": "string",
+          "tag": "record.owner"
+        },
+        {
+          "name": "group_id",
+          "type": "string"
+        },
+        {
+          "name": "organization_id",
+          "type": "string"
+        },
+        {
+          "name": "tags",
+          "type": "string[]",
+          "tag": "record.tags"
+        },
+        {
+          "name": "external_id",
+          "type": "string",
+          "tag": "record.externalId"
+        },
+        {
+          "name": "url",
+          "type": "string",
+          "readOnly": true
+        },
+        {
+          "name": "created_at",
+          "type": "datetime",
+          "tag": "record.createdAt",
+          "readOnly": true
+        },
+        {
+          "name": "updated_at",
+          "type": "datetime",
+          "tag": "record.updatedAt",
+          "readOnly": true
+        }
+      ]
+    },
+    "user": {
+      "label": "User",
+      "fields": [
+        {
+          "name": "id",
+          "type": "id",
+          "readOnly": true
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "tag": "person.fullName"
+        },
+        {
+          "name": "email",
+          "type": "email",
+          "tag": "contact.email"
+        },
+        {
+          "name": "phone",
+          "type": "phone",
+          "tag": "contact.phone"
+        },
+        {
+          "name": "role",
+          "type": "enum",
+          "values": [
+            "end-user",
+            "agent",
+            "admin"
+          ]
+        },
+        {
+          "name": "organization_id",
+          "type": "string"
+        }
+      ]
+    }
+  },
+  "events": {
+    "ticket.tagsChanged": {
+      "delivery": "webhook",
+      "object": "ticket",
+      "subscribe": "webhook.create",
+      "description": "Event-subscription webhook zen:event-type:ticket.tags_changed. $.record is the ticket (detail); added/removed tags are in event.",
+      "payload": {
+        "account_id": 22129848,
+        "detail": {
+          "id": 35436,
+          "url": "https://acmehelp.zendesk.com/api/v2/tickets/35436.json",
+          "subject": "Checkout fails with 500 for EU customers",
+          "description": "Since this morning every EU checkout returns a 500 at the payment step.",
+          "status": "open",
+          "priority": "urgent",
+          "type": "incident",
+          "requester_id": 20978392,
+          "assignee_id": 235323,
+          "group_id": 98738,
+          "organization_id": 509974,
+          "tags": [
+            "checkout",
+            "eu",
+            "escalate_jira"
+          ],
+          "external_id": null,
+          "created_at": "2026-10-20T08:12:44Z",
+          "updated_at": "2026-10-20T09:01:02Z"
+        },
+        "event": {
+          "tags_added": [
+            "escalate_jira"
+          ],
+          "tags_removed": []
+        },
+        "id": "cbe4028c-7239-495d-b020-f22348516046",
+        "subject": "zen:ticket:35436",
+        "time": "2026-10-20T09:01:02.882Z",
+        "type": "zen:event-type:ticket.tags_changed",
+        "zendesk_event_version": "2022-11-06"
+      },
+      "record": "detail",
+      "match": "zen:event-type:ticket.tags_changed"
+    },
+    "ticket.priorityChanged": {
+      "delivery": "webhook",
+      "object": "ticket",
+      "subscribe": "webhook.create",
+      "payload": {
+        "account_id": 22129848,
+        "detail": {
+          "id": 35436,
+          "url": "https://acmehelp.zendesk.com/api/v2/tickets/35436.json",
+          "subject": "Checkout fails with 500 for EU customers",
+          "description": "Since this morning every EU checkout returns a 500 at the payment step.",
+          "status": "open",
+          "priority": "urgent",
+          "type": "incident",
+          "requester_id": 20978392,
+          "assignee_id": 235323,
+          "group_id": 98738,
+          "organization_id": 509974,
+          "tags": [
+            "checkout",
+            "eu",
+            "escalate_jira"
+          ],
+          "external_id": null,
+          "created_at": "2026-10-20T08:12:44Z",
+          "updated_at": "2026-10-20T09:01:02Z"
+        },
+        "event": {
+          "current": "urgent",
+          "previous": "high"
+        },
+        "id": "cbe4028c-7239-495d-b020-f22348516046",
+        "subject": "zen:ticket:35436",
+        "time": "2026-10-20T09:01:02.882Z",
+        "type": "zen:event-type:ticket.priority_changed",
+        "zendesk_event_version": "2022-11-06"
+      },
+      "record": "detail",
+      "match": "zen:event-type:ticket.priority_changed"
+    },
+    "ticket.statusChanged": {
+      "delivery": "webhook",
+      "object": "ticket",
+      "subscribe": "webhook.create",
+      "payload": {
+        "account_id": 22129848,
+        "detail": {
+          "id": 35436,
+          "url": "https://acmehelp.zendesk.com/api/v2/tickets/35436.json",
+          "subject": "Checkout fails with 500 for EU customers",
+          "description": "Since this morning every EU checkout returns a 500 at the payment step.",
+          "status": "solved",
+          "priority": "urgent",
+          "type": "incident",
+          "requester_id": 20978392,
+          "assignee_id": 235323,
+          "group_id": 98738,
+          "organization_id": 509974,
+          "tags": [
+            "checkout",
+            "eu",
+            "escalate_jira"
+          ],
+          "external_id": null,
+          "created_at": "2026-10-20T08:12:44Z",
+          "updated_at": "2026-10-20T09:01:02Z"
+        },
+        "event": {
+          "current": "SOLVED",
+          "previous": "OPEN"
+        },
+        "id": "cbe4028c-7239-495d-b020-f22348516046",
+        "subject": "zen:ticket:35436",
+        "time": "2026-10-20T09:01:02.882Z",
+        "type": "zen:event-type:ticket.status_changed",
+        "zendesk_event_version": "2022-11-06"
+      },
+      "record": "detail",
+      "match": "zen:event-type:ticket.status_changed"
+    }
+  },
+  "webhook": {
+    "scope": "installation",
+    "topic": "{{body.type}}",
+    "eventId": "{{body.id}}",
+    "verify": "verifyWebhookSignature"
+  },
+  "capabilities": {
+    "ticket.get": {
+      "kind": "read",
+      "method": "showTicket",
+      "input": {
+        "id": {
+          "type": "string",
+          "required": true
+        }
+      },
+      "output": "ticket"
+    },
+    "ticket.update": {
+      "kind": "write",
+      "method": "updateTicket",
+      "input": {
+        "id": {
+          "type": "string",
+          "required": true
+        },
+        "ticket": {
+          "type": "object",
+          "required": true
+        }
+      },
+      "output": "ticket"
+    },
+    "ticket.addComment": {
+      "kind": "write",
+      "method": "addTicketComment",
+      "input": {
+        "id": {
+          "type": "string",
+          "required": true
+        },
+        "body": {
+          "type": "string",
+          "required": true
+        },
+        "public": {
+          "type": "boolean"
+        }
+      },
+      "output": "ticket"
+    },
+    "ticket.search": {
+      "kind": "search",
+      "method": "searchTickets",
+      "input": {
+        "query": {
+          "type": "string",
+          "required": true
+        }
+      },
+      "output": "ticket[]"
+    },
+    "user.get": {
+      "kind": "read",
+      "method": "showUser",
+      "input": {
+        "id": {
+          "type": "string",
+          "required": true
+        }
+      },
+      "output": "user"
+    },
+    "group.list": {
+      "kind": "read",
+      "method": "listGroups",
+      "input": {},
+      "output": "group[]"
+    },
+    "webhook.create": {
+      "kind": "subscribe",
+      "method": "createWebhook",
+      "input": {
+        "name": {
+          "type": "string",
+          "required": true
+        },
+        "endpoint": {
+          "type": "string",
+          "required": true
+        },
+        "subscriptions": {
+          "type": "array",
+          "required": true
+        }
+      },
+      "output": "webhook"
+    },
+    "webhook.delete": {
+      "kind": "delete",
+      "method": "deleteWebhook",
+      "input": {
+        "id": {
+          "type": "string",
+          "required": true
+        }
+      },
+      "output": "void"
+    }
+  },
+  "options": {
+    "group": {
+      "capability": "group.list",
+      "label": "{{item.name}}",
+      "value": "$.item.id"
+    }
+  },
+  "ui": {
+    "placements": [
+      "ticket_sidebar",
+      "new_ticket_sidebar",
+      "user_sidebar",
+      "organization_sidebar"
+    ],
+    "renderer": "frigg-zaf-app"
+  }
+}

package/integrations/data-defined/compile.js

@@ -0,0 +1,77 @@
+/**
+ * Compile a definition + one installation into what Frigg runs: an events map shaped exactly like a hand-written
+ * integration's `this.events`, plus the routing tables the runtime needs. Pure; no I/O.
+ *
+ * Only what the installation has enabled is compiled, so a disabled workflow has no event, no route and no schedule.
+ *
+ * Event names:  SYNC_<ID>_BACKFILL (USER_ACTION) · SYNC_<ID>_PAGE (QUEUE) · SYNC_<ID>_ONGOING (WEBHOOK|CRON)
+ *               WF_<ID> (WEBHOOK|CRON|USER_ACTION|QUEUE) · Q_<ID> (ROUTE) · UI_<ID> (ROUTE)
+ */
+const eventName = (prefix, id, suffix) => [prefix, id.toUpperCase().replace(/-/g, '_'), suffix].filter(Boolean).join('_');
+
+function isOn(item, chosen) {
+    if (chosen && typeof chosen.enabled === 'boolean') return chosen.enabled;
+    return (item.default || 'on') === 'on';
+}
+
+function compile(def, installation = {}) {
+    const events = {};
+    const webhooks = {};      // moduleKey -> topic -> [eventName]
+    const schedules = [];     // { event, cron, timezone }
+    const userActions = [];   // { event, label, from }
+    const routes = [];        // { method, path, event }
+    const add = (name, e) => { events[name] = e; return name; };
+    const route = (mod, topic, name) => { ((webhooks[mod] ||= {})[topic] ||= []).push(name); };
+
+    for (const s of def.syncs || []) {
+        if (!isOn(s, installation.syncs?.[s.id])) continue;
+        if (s.backfill?.trigger === 'userAction') {
+            const n = add(eventName('SYNC', s.id, 'BACKFILL'), { type: 'USER_ACTION', userActionType: 'SYNC_ACTION', title: `Sync existing ${s.label.toLowerCase()}`, ref: { kind: 'sync', id: s.id, phase: 'backfill' } });
+            userActions.push({ event: n, label: events[n].title });
+        }
+        add(eventName('SYNC', s.id, 'PAGE'), { type: 'QUEUE', ref: { kind: 'sync', id: s.id, phase: 'page' } });
+        const mode = s.ongoing?.mode || 'none';
+        if (mode === 'webhook') {
+            const n = add(eventName('SYNC', s.id, 'ONGOING'), { type: 'WEBHOOK', ref: { kind: 'sync', id: s.id, phase: 'ongoing' } });
+            for (const side of [s.source, ...(s.direction === 'two_way' ? [s.target] : [])]) {
+                const [mod, obj] = side.split('.');
+                route(mod, `${obj}.*`, n);
+            }
+        } else if (mode === 'poll') {
+            const n = add(eventName('SYNC', s.id, 'ONGOING'), { type: 'CRON', ref: { kind: 'sync', id: s.id, phase: 'ongoing' } });
+            schedules.push({ event: n, every: s.ongoing.every || '15m' });
+        }
+    }
+
+    for (const w of def.workflows || []) {
+        if (!isOn(w, installation.workflows?.[w.id])) continue;
+        const t = w.trigger;
+        const type = { webhook: 'WEBHOOK', schedule: 'CRON', userAction: 'USER_ACTION', syncRecord: 'QUEUE' }[t.type];
+        const n = add(eventName('WF', w.id), { type, ...(type === 'USER_ACTION' ? { userActionType: 'DATA_ACTION', title: t.label } : {}), ref: { kind: 'workflow', id: w.id } });
+        if (t.type === 'webhook') route(t.module, t.topic, n);
+        if (t.type === 'schedule') schedules.push({ event: n, cron: t.cron, timezone: t.timezone || 'UTC' });
+        if (t.type === 'userAction') userActions.push({ event: n, label: t.label, from: t.from || null });
+        if (t.type === 'syncRecord') route('$sync', `${t.sync}:${(t.on || []).join('|')}`, n);
+    }
+
+    for (const q of def.queries || []) add(eventName('Q', q.id), { type: 'ROUTE', ref: { kind: 'query', id: q.id } });
+    for (const u of def.ui || []) {
+        if (!isOn(u, installation.ui?.[u.id])) continue;
+        const n = add(eventName('UI', u.id), { type: 'ROUTE', ref: { kind: 'ui', id: u.id } });
+        routes.push({ method: 'GET', path: `/ui/${u.id}`, event: n });
+    }
+
+    return { events, webhooks, schedules, userActions, routes };
+}
+
+/** Which compiled events a delivered webhook goes to. Topic patterns may end in ".*". */
+function routeWebhook(compiled, moduleKey, topic) {
+    const table = compiled.webhooks[moduleKey] || {};
+    const out = new Set(table[topic] || []);
+    for (const [pattern, names] of Object.entries(table)) {
+        if (pattern.endsWith('.*') && topic.startsWith(pattern.slice(0, -1))) names.forEach((n) => out.add(n));
+    }
+    return [...out];
+}
+
+module.exports = { compile, routeWebhook, eventName };