runline 0.2.0 → 0.2.2

package/dist/plugins/keap/src/index.js

@@ -7,8 +7,17 @@ async function apiRequest(token, method, endpoint, body, qs) {
                 url.searchParams.set(k, String(v));
         }
     }
-    const opts = { method, headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" } };
-    if (body && Object.keys(body).length > 0 && method !== "GET" && method !== "DELETE")
+    const opts = {
+        method,
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
+    };
+    if (body &&
+        Object.keys(body).length > 0 &&
+        method !== "GET" &&
+        method !== "DELETE")
         opts.body = JSON.stringify(body);
     const res = await fetch(url.toString(), opts);
     if (!res.ok)
@@ -37,18 +46,43 @@ export default function keap(rl) {
     rl.setName("keap");
     rl.setVersion("0.1.0");
     rl.setConnectionSchema({
-        accessToken: { type: "string", required: true, description: "Keap OAuth2 access token", env: "KEAP_ACCESS_TOKEN" },
+        accessToken: {
+            type: "string",
+            required: true,
+            description: "Keap OAuth2 access token",
+            env: "KEAP_ACCESS_TOKEN",
+        },
     });
     const tok = (ctx) => ctx.connection.config.accessToken;
     // ── Company ─────────────────────────────────────────
     rl.registerAction("company.create", {
         description: "Create a company",
         inputSchema: {
-            companyName: { type: "string", required: true, description: "Company name" },
-            address: { type: "object", required: false, description: "Address object (line1, line2, locality, region, zip_code, country_code)" },
-            phone: { type: "object", required: false, description: "Phone object (number, field, type)" },
-            fax: { type: "object", required: false, description: "Fax object (number, type)" },
-            additionalFields: { type: "object", required: false, description: "Additional company fields (email_address, website, notes, etc.)" },
+            companyName: {
+                type: "string",
+                required: true,
+                description: "Company name",
+            },
+            address: {
+                type: "object",
+                required: false,
+                description: "Address object (line1, line2, locality, region, zip_code, country_code)",
+            },
+            phone: {
+                type: "object",
+                required: false,
+                description: "Phone object (number, field, type)",
+            },
+            fax: {
+                type: "object",
+                required: false,
+                description: "Fax object (number, type)",
+            },
+            additionalFields: {
+                type: "object",
+                required: false,
+                description: "Additional company fields (email_address, website, notes, etc.)",
+            },
         },
         async execute(input, ctx) {
             const { companyName, address, phone, fax, additionalFields } = input;
@@ -67,9 +101,17 @@ export default function keap(rl) {
     rl.registerAction("company.list", {
         description: "List companies",
         inputSchema: {
-            limit: { type: "number", required: false, description: "Max results (default 50)" },
+            limit: {
+                type: "number",
+                required: false,
+                description: "Max results (default 50)",
+            },
             offset: { type: "number", required: false },
-            optionalProperties: { type: "string", required: false, description: "Comma-separated optional fields to include" },
+            optionalProperties: {
+                type: "string",
+                required: false,
+                description: "Comma-separated optional fields to include",
+            },
         },
         async execute(input, ctx) {
             const { limit, offset, optionalProperties } = (input ?? {});
@@ -80,7 +122,7 @@ export default function keap(rl) {
                 qs.offset = offset;
             if (optionalProperties)
                 qs.optional_properties = optionalProperties;
-            const data = await apiRequest(tok(ctx), "GET", "/companies", undefined, qs);
+            const data = (await apiRequest(tok(ctx), "GET", "/companies", undefined, qs));
             return data.companies;
         },
     });
@@ -88,19 +130,49 @@ export default function keap(rl) {
     rl.registerAction("contact.upsert", {
         description: "Create or update a contact (PUT). Duplicate matching is controlled by duplicate_option.",
         inputSchema: {
-            duplicateOption: { type: "string", required: true, description: "How to handle duplicates: 'Email', 'EmailAndName', 'EmailAndNameAndCompany'" },
-            emailAddresses: { type: "array", required: false, description: "Array of {email, field} objects (field: EMAIL1, EMAIL2, EMAIL3)" },
+            duplicateOption: {
+                type: "string",
+                required: true,
+                description: "How to handle duplicates: 'Email', 'EmailAndName', 'EmailAndNameAndCompany'",
+            },
+            emailAddresses: {
+                type: "array",
+                required: false,
+                description: "Array of {email, field} objects (field: EMAIL1, EMAIL2, EMAIL3)",
+            },
             givenName: { type: "string", required: false },
             familyName: { type: "string", required: false },
-            phoneNumbers: { type: "array", required: false, description: "Array of {number, field, type} objects" },
-            addresses: { type: "array", required: false, description: "Array of address objects (line1, line2, locality, region, zip_code, country_code, field)" },
-            faxNumbers: { type: "array", required: false, description: "Array of {number, type} objects" },
-            socialAccounts: { type: "array", required: false, description: "Array of {name, type} objects" },
-            additionalFields: { type: "object", required: false, description: "Additional fields: contact_type, job_title, lead_source_id, middle_name, opt_in_reason, owner_id, preferred_locale, preferred_name, source_type, spouse_name, time_zone, website, anniversary, company (as {id: number}), origin (as {ip_address: string})" },
+            phoneNumbers: {
+                type: "array",
+                required: false,
+                description: "Array of {number, field, type} objects",
+            },
+            addresses: {
+                type: "array",
+                required: false,
+                description: "Array of address objects (line1, line2, locality, region, zip_code, country_code, field)",
+            },
+            faxNumbers: {
+                type: "array",
+                required: false,
+                description: "Array of {number, type} objects",
+            },
+            socialAccounts: {
+                type: "array",
+                required: false,
+                description: "Array of {name, type} objects",
+            },
+            additionalFields: {
+                type: "object",
+                required: false,
+                description: "Additional fields: contact_type, job_title, lead_source_id, middle_name, opt_in_reason, owner_id, preferred_locale, preferred_name, source_type, spouse_name, time_zone, website, anniversary, company (as {id: number}), origin (as {ip_address: string})",
+            },
         },
         async execute(input, ctx) {
-            const { duplicateOption, emailAddresses, givenName, familyName, phoneNumbers, addresses, faxNumbers, socialAccounts, additionalFields } = input;
-            const body = { duplicate_option: duplicateOption };
+            const { duplicateOption, emailAddresses, givenName, familyName, phoneNumbers, addresses, faxNumbers, socialAccounts, additionalFields, } = input;
+            const body = {
+                duplicate_option: duplicateOption,
+            };
             if (givenName)
                 body.given_name = givenName;
             if (familyName)
@@ -124,7 +196,11 @@ export default function keap(rl) {
         description: "Get a contact by ID",
         inputSchema: {
             contactId: { type: "number", required: true },
-            optionalProperties: { type: "string", required: false, description: "Comma-separated optional fields" },
+            optionalProperties: {
+                type: "string",
+                required: false,
+                description: "Comma-separated optional fields",
+            },
         },
         async execute(input, ctx) {
             const { contactId, optionalProperties } = input;
@@ -142,7 +218,11 @@ export default function keap(rl) {
             givenName: { type: "string", required: false },
             familyName: { type: "string", required: false },
             order: { type: "string", required: false },
-            orderDirection: { type: "string", required: false, description: "ASCENDING or DESCENDING" },
+            orderDirection: {
+                type: "string",
+                required: false,
+                description: "ASCENDING or DESCENDING",
+            },
             since: { type: "string", required: false, description: "ISO date" },
             until: { type: "string", required: false, description: "ISO date" },
         },
@@ -165,7 +245,7 @@ export default function keap(rl) {
                 qs.since = p.since;
             if (p.until)
                 qs.until = p.until;
-            const data = await apiRequest(tok(ctx), "GET", "/contacts", undefined, qs);
+            const data = (await apiRequest(tok(ctx), "GET", "/contacts", undefined, qs));
             return data.contacts;
         },
     });
@@ -181,15 +261,26 @@ export default function keap(rl) {
     rl.registerAction("contactNote.create", {
         description: "Create a note on a contact",
         inputSchema: {
-            userId: { type: "number", required: true, description: "Keap user ID who is creating the note" },
+            userId: {
+                type: "number",
+                required: true,
+                description: "Keap user ID who is creating the note",
+            },
             contactId: { type: "number", required: true },
             body: { type: "string", required: false, description: "Note body text" },
             title: { type: "string", required: false },
-            type: { type: "string", required: false, description: "Appointment, Call, Email, Fax, Letter, Other" },
+            type: {
+                type: "string",
+                required: false,
+                description: "Appointment, Call, Email, Fax, Letter, Other",
+            },
         },
         async execute(input, ctx) {
-            const { userId, contactId, body: noteBody, title, type } = input;
-            const b = { user_id: userId, contact_id: contactId };
+            const { userId, contactId, body: noteBody, title, type, } = input;
+            const b = {
+                user_id: userId,
+                contact_id: contactId,
+            };
             if (noteBody)
                 b.body = noteBody;
             if (title)
@@ -202,14 +293,24 @@ export default function keap(rl) {
     rl.registerAction("contactNote.get", {
         description: "Get a note",
         inputSchema: { noteId: { type: "number", required: true } },
-        async execute(input, ctx) { return apiRequest(tok(ctx), "GET", `/notes/${input.noteId}`); },
+        async execute(input, ctx) {
+            return apiRequest(tok(ctx), "GET", `/notes/${input.noteId}`);
+        },
     });
     rl.registerAction("contactNote.list", {
         description: "List notes (optionally filtered by contact_id, user_id)",
         inputSchema: {
             limit: { type: "number", required: false },
-            contactId: { type: "number", required: false, description: "Filter by contact" },
-            userId: { type: "number", required: false, description: "Filter by user" },
+            contactId: {
+                type: "number",
+                required: false,
+                description: "Filter by contact",
+            },
+            userId: {
+                type: "number",
+                required: false,
+                description: "Filter by user",
+            },
         },
         async execute(input, ctx) {
             const p = (input ?? {});
@@ -220,7 +321,7 @@ export default function keap(rl) {
                 qs.contact_id = p.contactId;
             if (p.userId)
                 qs.user_id = p.userId;
-            const data = await apiRequest(tok(ctx), "GET", "/notes", undefined, qs);
+            const data = (await apiRequest(tok(ctx), "GET", "/notes", undefined, qs));
             return data.notes;
         },
     });
@@ -257,18 +358,28 @@ export default function keap(rl) {
         description: "Apply tags to a contact",
         inputSchema: {
             contactId: { type: "number", required: true },
-            tagIds: { type: "array", required: true, description: "Array of tag IDs to apply" },
+            tagIds: {
+                type: "array",
+                required: true,
+                description: "Array of tag IDs to apply",
+            },
         },
         async execute(input, ctx) {
             const { contactId, tagIds } = input;
-            return apiRequest(tok(ctx), "POST", `/contacts/${contactId}/tags`, { tagIds });
+            return apiRequest(tok(ctx), "POST", `/contacts/${contactId}/tags`, {
+                tagIds,
+            });
         },
     });
     rl.registerAction("contactTag.remove", {
         description: "Remove tags from a contact",
         inputSchema: {
             contactId: { type: "number", required: true },
-            tagIds: { type: "string", required: true, description: "Comma-separated tag IDs to remove" },
+            tagIds: {
+                type: "string",
+                required: true,
+                description: "Comma-separated tag IDs to remove",
+            },
         },
         async execute(input, ctx) {
             const { contactId, tagIds } = input;
@@ -287,7 +398,7 @@ export default function keap(rl) {
             const qs = {};
             if (limit)
                 qs.limit = limit;
-            const data = await apiRequest(tok(ctx), "GET", `/contacts/${contactId}/tags`, undefined, qs);
+            const data = (await apiRequest(tok(ctx), "GET", `/contacts/${contactId}/tags`, undefined, qs));
             return data.tags;
         },
     });
@@ -298,13 +409,25 @@ export default function keap(rl) {
             contactId: { type: "number", required: true },
             orderDate: { type: "string", required: true, description: "ISO date" },
             orderTitle: { type: "string", required: true },
-            orderType: { type: "string", required: true, description: "Online, Offline, etc." },
-            orderItems: { type: "array", required: true, description: "Array of order item objects (product_id, quantity, price, etc.)" },
+            orderType: {
+                type: "string",
+                required: true,
+                description: "Online, Offline, etc.",
+            },
+            orderItems: {
+                type: "array",
+                required: true,
+                description: "Array of order item objects (product_id, quantity, price, etc.)",
+            },
             shippingAddress: { type: "object", required: false },
-            additionalFields: { type: "object", required: false, description: "promo_codes (array), lead_affiliate_id, sale_affiliate_id, etc." },
+            additionalFields: {
+                type: "object",
+                required: false,
+                description: "promo_codes (array), lead_affiliate_id, sale_affiliate_id, etc.",
+            },
         },
         async execute(input, ctx) {
-            const { contactId, orderDate, orderTitle, orderType, orderItems, shippingAddress, additionalFields } = input;
+            const { contactId, orderDate, orderTitle, orderType, orderItems, shippingAddress, additionalFields, } = input;
             const body = {
                 contact_id: contactId,
                 order_date: orderDate,
@@ -322,7 +445,9 @@ export default function keap(rl) {
     rl.registerAction("order.get", {
         description: "Get an order",
         inputSchema: { orderId: { type: "number", required: true } },
-        async execute(input, ctx) { return apiRequest(tok(ctx), "GET", `/orders/${input.orderId}`); },
+        async execute(input, ctx) {
+            return apiRequest(tok(ctx), "GET", `/orders/${input.orderId}`);
+        },
     });
     rl.registerAction("order.list", {
         description: "List orders",
@@ -343,7 +468,7 @@ export default function keap(rl) {
                 qs.since = p.since;
             if (p.until)
                 qs.until = p.until;
-            const data = await apiRequest(tok(ctx), "GET", "/orders", undefined, qs);
+            const data = (await apiRequest(tok(ctx), "GET", "/orders", undefined, qs));
             return data.orders;
         },
     });
@@ -360,7 +485,11 @@ export default function keap(rl) {
         description: "Create a product",
         inputSchema: {
             productName: { type: "string", required: true },
-            additionalFields: { type: "object", required: false, description: "product_price, product_desc, sku, etc." },
+            additionalFields: {
+                type: "object",
+                required: false,
+                description: "product_price, product_desc, sku, etc.",
+            },
         },
         async execute(input, ctx) {
             const { productName, additionalFields } = input;
@@ -373,7 +502,9 @@ export default function keap(rl) {
     rl.registerAction("product.get", {
         description: "Get a product",
         inputSchema: { productId: { type: "number", required: true } },
-        async execute(input, ctx) { return apiRequest(tok(ctx), "GET", `/products/${input.productId}`); },
+        async execute(input, ctx) {
+            return apiRequest(tok(ctx), "GET", `/products/${input.productId}`);
+        },
     });
     rl.registerAction("product.list", {
         description: "List products",
@@ -382,7 +513,7 @@ export default function keap(rl) {
             const qs = {};
             if (input?.limit)
                 qs.limit = input.limit;
-            const data = await apiRequest(tok(ctx), "GET", "/products", undefined, qs);
+            const data = (await apiRequest(tok(ctx), "GET", "/products", undefined, qs));
             return data.products;
         },
     });
@@ -400,11 +531,18 @@ export default function keap(rl) {
         inputSchema: {
             sentFromAddress: { type: "string", required: true },
             sentToAddress: { type: "string", required: true },
-            additionalFields: { type: "object", required: false, description: "subject, sent_date, received_date, headers, html_content, plain_content, etc." },
+            additionalFields: {
+                type: "object",
+                required: false,
+                description: "subject, sent_date, received_date, headers, html_content, plain_content, etc.",
+            },
         },
         async execute(input, ctx) {
             const { sentFromAddress, sentToAddress, additionalFields } = input;
-            const body = { sent_to_address: sentToAddress, sent_from_address: sentFromAddress };
+            const body = {
+                sent_to_address: sentToAddress,
+                sent_from_address: sentFromAddress,
+            };
             if (additionalFields)
                 Object.assign(body, additionalFields);
             return apiRequest(tok(ctx), "POST", "/emails", body);
@@ -437,23 +575,39 @@ export default function keap(rl) {
                 qs.email = p.email;
             if (p.sinceDate)
                 qs.since_sent_date = p.sinceDate;
-            const data = await apiRequest(tok(ctx), "GET", "/emails", undefined, qs);
+            const data = (await apiRequest(tok(ctx), "GET", "/emails", undefined, qs));
             return data.emails;
         },
     });
     rl.registerAction("email.send", {
         description: "Queue an email to be sent",
         inputSchema: {
-            userId: { type: "number", required: true, description: "Keap user ID sending the email" },
-            contactIds: { type: "array", required: true, description: "Array of contact IDs to send to" },
+            userId: {
+                type: "number",
+                required: true,
+                description: "Keap user ID sending the email",
+            },
+            contactIds: {
+                type: "array",
+                required: true,
+                description: "Array of contact IDs to send to",
+            },
             subject: { type: "string", required: true },
             htmlContent: { type: "string", required: false },
             plainContent: { type: "string", required: false },
-            attachments: { type: "array", required: false, description: "Array of {file_data, file_name} objects" },
+            attachments: {
+                type: "array",
+                required: false,
+                description: "Array of {file_data, file_name} objects",
+            },
         },
         async execute(input, ctx) {
-            const { userId, contactIds, subject, htmlContent, plainContent, attachments } = input;
-            const body = { user_id: userId, contacts: contactIds, subject };
+            const { userId, contactIds, subject, htmlContent, plainContent, attachments, } = input;
+            const body = {
+                user_id: userId,
+                contacts: contactIds,
+                subject,
+            };
             if (htmlContent)
                 body.html_content = htmlContent;
             if (plainContent)
@@ -477,9 +631,21 @@ export default function keap(rl) {
         description: "List files",
         inputSchema: {
             limit: { type: "number", required: false },
-            permission: { type: "string", required: false, description: "USER, COMPANY" },
-            type: { type: "string", required: false, description: "Application, Image, Fax, Attachment, Ticket, Contact, Digital Product, Import, Hidden, Webform, Styled Cart, Logo, Resampled, Template Thumbnail, Funnel" },
-            viewable: { type: "string", required: false, description: "PUBLIC, PRIVATE, BOTH" },
+            permission: {
+                type: "string",
+                required: false,
+                description: "USER, COMPANY",
+            },
+            type: {
+                type: "string",
+                required: false,
+                description: "Application, Image, Fax, Attachment, Ticket, Contact, Digital Product, Import, Hidden, Webform, Styled Cart, Logo, Resampled, Template Thumbnail, Funnel",
+            },
+            viewable: {
+                type: "string",
+                required: false,
+                description: "PUBLIC, PRIVATE, BOTH",
+            },
             contactId: { type: "number", required: false },
         },
         async execute(input, ctx) {
@@ -495,7 +661,7 @@ export default function keap(rl) {
                 qs.viewable = p.viewable.toUpperCase();
             if (p.contactId)
                 qs.contact_id = p.contactId;
-            const data = await apiRequest(tok(ctx), "GET", "/files", undefined, qs);
+            const data = (await apiRequest(tok(ctx), "GET", "/files", undefined, qs));
             return data.files;
         },
     });