@arbium/enterprise-agent-connect 0.1.1 → 0.1.2-dev.75145ef

package/dist/connectors/soap/index.js

@@ -0,0 +1,248 @@
+import { createHash, randomBytes } from "node:crypto";
+import { z } from "zod";
+import { audited, Denied, json, listLimit, VendorFailed, } from "../../packages/connector-kit/src/common.js";
+import { pickDisplay, } from "../../packages/connector-kit/src/connector.js";
+import { vendorError } from "../../packages/connector-kit/src/oauth.js";
+import { ConnectError, } from "../../packages/connector-kit/src/types.js";
+import { answerWithin, authHeaders, formValues, guardedFetch, MAX_BODY_BYTES, paramLimits, zodType, } from "../http/index.js";
+import { escapeXml, localName, parseXml, toJson, XmlError } from "./xml.js";
+// The generic module behind every connector.json with a `soap` block: a SOAP 1.1 or 1.2
+// service described as data. Calls reach only the endpoint's origin, always POSTing to it.
+const ENVELOPE = {
+    "1.1": "http://schemas.xmlsoap.org/soap/envelope/",
+    "1.2": "http://www.w3.org/2003/05/soap-envelope",
+};
+const WSSE = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd";
+const WSU = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd";
+const TOKEN_PROFILE = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0";
+const XML_TYPES = /^(text\/|application\/([\w.+-]*\+)?(xml|json))/i;
+// Characters XML 1.0 cannot carry, even escaped.
+const NOT_XML = /[\u0000-\u0008\u000B\u000C\u000E-\u001F￾￿]/;
+// The Body content of one call: the template with each value escaped, and an optional
+// param's element dropped when it is left out.
+export function renderBody(tool, args) {
+    let body = tool.body;
+    for (const [name, p] of Object.entries(tool.params)) {
+        if (args[name] !== undefined)
+            continue;
+        if (p.required)
+            throw new Denied(`${name} is required`);
+        body = body.replace(new RegExp(`<([\\w.:-]+)(\\s[^>]*)?>\\{${name}\\}</\\1>`), "");
+    }
+    // One pass, so a value holding "{other}" is never read as a placeholder.
+    return body.replace(/\{([a-z][a-z0-9_]*)\}/g, (_, name) => {
+        const value = String(args[name]);
+        if (NOT_XML.test(value))
+            throw new Denied(`${name} has characters XML cannot carry`);
+        return escapeXml(value);
+    });
+}
+function usernameToken(username, password, digest) {
+    const nonce = randomBytes(16);
+    const created = new Date().toISOString();
+    const value = digest
+        ? createHash("sha1")
+            .update(Buffer.concat([nonce, Buffer.from(created + password)]))
+            .digest("base64")
+        : password;
+    return (`<wsse:Security xmlns:wsse="${WSSE}" xmlns:wsu="${WSU}"><wsse:UsernameToken>` +
+        `<wsse:Username>${escapeXml(username)}</wsse:Username>` +
+        `<wsse:Password Type="${TOKEN_PROFILE}#${digest ? "PasswordDigest" : "PasswordText"}">${escapeXml(value)}</wsse:Password>` +
+        `<wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">${nonce.toString("base64")}</wsse:Nonce>` +
+        `<wsu:Created>${created}</wsu:Created></wsse:UsernameToken></wsse:Security>`);
+}
+const child = (node, name) => node?.children.find((c) => localName(c.name) === name);
+// A SOAP Fault's code and text, from either version's shape.
+function faultText(fault) {
+    const f = toJson(fault);
+    const first = (v) => (Array.isArray(v) ? v[0] : v);
+    const reason = f.Reason;
+    const code = f.Code;
+    const message = String(first(f.faultstring ?? reason?.Text) ?? "no reason given");
+    const kind = f.faultcode ?? code?.Value;
+    return `${message.slice(0, 300)}${typeof kind === "string" ? ` (${kind})` : ""}`;
+}
+function failure(status, data) {
+    const fault = data?.fault;
+    if (fault)
+        return `The service refused the call: ${fault}`;
+    const detail = vendorError(data);
+    return `The service answered ${status}${detail ? `: ${detail}` : ""}`;
+}
+export function soapVendor(connector, fetchImpl = fetch) {
+    const soap = connector.soap;
+    const endpoint = new URL(soap.endpoint);
+    const safe = guardedFetch([endpoint.origin], fetchImpl, XML_TYPES, "XML, JSON or text");
+    const ns = Object.entries(soap.namespaces)
+        .map(([prefix, uri]) => ` xmlns:${prefix}="${escapeXml(uri)}"`)
+        .join("");
+    // request.body is the Body's content (already escaped), request.headers.soapaction its action.
+    const call = async (c, request) => {
+        const ws = soap.wsSecurity;
+        const header = ws
+            ? `<soap:Header>${usernameToken(c.config[ws.username], c.secret[ws.password], ws.digest)}</soap:Header>`
+            : "";
+        const envelope = `<?xml version="1.0" encoding="utf-8"?><soap:Envelope xmlns:soap="${ENVELOPE[soap.version]}"${ns}>` +
+            `${header}<soap:Body>${String(request.body)}</soap:Body></soap:Envelope>`;
+        const action = request.headers?.soapaction;
+        const res = await safe(endpoint, {
+            method: "POST",
+            headers: {
+                accept: soap.version === "1.1" ? "text/xml" : "application/soap+xml",
+                ...(soap.auth ? authHeaders(soap.auth, c) : {}),
+                ...(soap.version === "1.1"
+                    ? { "content-type": "text/xml; charset=utf-8", soapaction: `"${action ?? ""}"` }
+                    : {
+                        "content-type": `application/soap+xml; charset=utf-8${action ? `; action="${action}"` : ""}`,
+                    }),
+            },
+            body: envelope,
+        });
+        const raw = await res.text();
+        let doc = null;
+        try {
+            doc = parseXml(raw);
+        }
+        catch (error) {
+            if (!(error instanceof XmlError))
+                throw error;
+            if (res.ok)
+                throw new ConnectError(`The service's answer is not usable XML: ${error.message}`);
+        }
+        const body = doc && localName(doc.name) === "Envelope" ? child(doc, "Body") : undefined;
+        if (!body) {
+            // A gateway's error page, say: its own words, as for any app.
+            if (!res.ok)
+                return { status: res.status, data: raw.slice(0, 300) };
+            throw new ConnectError("The service answered without a SOAP envelope");
+        }
+        const fault = child(body, "Fault");
+        if (fault)
+            return { status: res.ok ? 500 : res.status, data: { fault: faultText(fault) } };
+        return { status: res.status, data: toJson(body) };
+    };
+    return {
+        async connect(fields) {
+            const { config, secret } = formValues(connector, fields);
+            const conn = { config: { host: endpoint.host, ...config }, secret };
+            return { ...conn, accountLabel: conn.config[connector.accountKey] ?? endpoint.host };
+        },
+        call,
+        checks: soap.verify
+            ? {
+                // The connector's `verify` call, with the admin's own arguments.
+                async operation(c) {
+                    const verify = soap.verify;
+                    const tool = soap.tools.find((t) => t.name === verify.tool);
+                    const res = await call(c, {
+                        method: "POST",
+                        path: "",
+                        body: renderBody(tool, verify.args),
+                        headers: tool.soapAction ? { soapaction: tool.soapAction } : {},
+                    });
+                    if (res.status < 200 || res.status >= 300)
+                        throw new ConnectError(failure(res.status, res.data));
+                    const shown = answer(tool, res.data);
+                    return {
+                        values: (Array.isArray(shown) ? shown : [shown]).flatMap((item) => pickDisplay(item, verify.show)),
+                    };
+                },
+            }
+            : undefined,
+    };
+}
+// The tool's part of the Body: its `result` path, a list when it ends in [], and only its
+// `fields`.
+export function answer(tool, body) {
+    const path = tool.result ?? `${tool.operation}Response`;
+    const list = path.endsWith("[]");
+    let value = body;
+    for (const key of path.replace(/\[\]$/, "").split(".")) {
+        value =
+            value && typeof value === "object" && !Array.isArray(value) && Object.hasOwn(value, key)
+                ? value[key]
+                : undefined;
+    }
+    if (list)
+        value = value === undefined || value === "" ? [] : [value].flat();
+    const keep = tool.fields;
+    if (!keep)
+        return value ?? null;
+    const trim = (item) => item && typeof item === "object"
+        ? Object.fromEntries(keep.flatMap((k) => Object.hasOwn(item, k) ? [[k, item[k]]] : []))
+        : item;
+    return Array.isArray(value) ? value.map(trim) : trim(value ?? null);
+}
+export function soapTools(soap) {
+    return {
+        names: soap.tools.map((t) => t.name),
+        register(server, ctx, allowed) {
+            for (const tool of soap.tools) {
+                if (!allowed.has(tool.name))
+                    continue;
+                const shape = Object.fromEntries(Object.entries(tool.params).map(([name, p]) => {
+                    const type = zodType[p.type].describe(p.description);
+                    return [name, p.required ? type : type.optional()];
+                }));
+                server.registerTool(tool.name, {
+                    description: tool.description,
+                    inputSchema: z.object(shape).strict(),
+                    annotations: {
+                        readOnlyHint: tool.readOnly,
+                        destructiveHint: tool.destructive,
+                        openWorldHint: true,
+                    },
+                }, (args) => audited(ctx, tool.name, JSON.stringify(args).slice(0, 300), async (mark) => {
+                    paramLimits(ctx.limits, tool.params, args);
+                    const body = renderBody(tool, args);
+                    if (Buffer.byteLength(body) > MAX_BODY_BYTES)
+                        throw new Denied(`The request is larger than ${MAX_BODY_BYTES / 1024} KB`);
+                    let res;
+                    try {
+                        res = await ctx.call({
+                            method: "POST",
+                            path: "",
+                            body,
+                            headers: tool.soapAction ? { soapaction: tool.soapAction } : {},
+                        });
+                    }
+                    catch (error) {
+                        if (error instanceof ConnectError)
+                            throw new VendorFailed(502, error.message);
+                        throw error;
+                    }
+                    mark(res.status);
+                    if (res.status < 200 || res.status >= 300) {
+                        throw new VendorFailed(res.status, failure(res.status, res.data));
+                    }
+                    const result = answer(tool, res.data);
+                    for (const a of tool.answerLimits) {
+                        const values = listLimit(ctx.limits, a.limit);
+                        if (values && !answerWithin(result, a.field, values))
+                            throw new Denied(`The answer's ${a.field} is outside this agent's limits`);
+                    }
+                    return json(result);
+                }));
+            }
+        },
+    };
+}
+/** Binds to any connector with a `soap` block; createAgentConnect uses it for those. */
+export default {
+    id: "soap",
+    create: ({ connector }) => {
+        const soap = connector.soap;
+        // Each body must be well-formed once filled, so a typo fails at startup, not on a call.
+        for (const tool of soap.tools) {
+            const sample = tool.body.replace(/\{[a-z][a-z0-9_]*\}/g, "x");
+            try {
+                parseXml(`<soap:Body xmlns:soap="${ENVELOPE[soap.version]}">${sample}</soap:Body>`);
+            }
+            catch (error) {
+                throw new Error(`${connector.id}: ${tool.name}'s body is not XML: ${error.message}`);
+            }
+        }
+        return { vendor: soapVendor(connector), toolset: soapTools(soap) };
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/connectors/soap/index.js.map

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

package/dist/connectors/soap/xml.d.ts

@@ -0,0 +1,12 @@
+export type XmlNode = {
+    name: string;
+    attrs: Record<string, string>;
+    children: XmlNode[];
+    text: string;
+};
+export declare class XmlError extends Error {
+}
+export declare function parseXml(xml: string): XmlNode;
+export declare const localName: (name: string) => string;
+export declare function toJson(node: XmlNode): unknown;
+export declare const escapeXml: (value: string) => string;

package/dist/connectors/soap/xml.js

@@ -0,0 +1,126 @@
+// A small XML reader for SOAP answers, WSDL and OData $metadata: elements, attributes, text
+// and CDATA. A document type declaration is refused, so there are no external or expanding
+// entities: only XML's five named ones and character references.
+export class XmlError extends Error {
+}
+const MAX_DEPTH = 100;
+const START = /<([A-Za-z_][\w.:-]*)((?:\s+[A-Za-z_][\w.:-]*\s*=\s*(?:"[^"<]*"|'[^'<]*'))*)\s*(\/?)>/y;
+const ATTR = /([A-Za-z_][\w.:-]*)\s*=\s*(?:"([^"<]*)"|'([^'<]*)')/g;
+const NAMED = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
+function decode(raw) {
+    return raw.replace(/&(?:#x([0-9a-fA-F]+)|#([0-9]+)|([a-z]+))?;?/g, (m, hex, dec, name) => {
+        if (!m.endsWith(";") || m === "&;")
+            throw new XmlError("A bare & in the text");
+        if (name !== undefined) {
+            if (!Object.hasOwn(NAMED, name))
+                throw new XmlError(`Unknown entity &${name};`);
+            return NAMED[name];
+        }
+        const code = hex !== undefined ? parseInt(hex, 16) : Number(dec);
+        if (!(code > 0 && code <= 0x10ffff))
+            throw new XmlError("A character reference out of range");
+        return String.fromCodePoint(code);
+    });
+}
+export function parseXml(xml) {
+    const root = { name: "", attrs: {}, children: [], text: "" };
+    const stack = [root];
+    const until = (end, from) => {
+        const at = xml.indexOf(end, from);
+        if (at === -1)
+            throw new XmlError(`Unclosed ${xml.slice(from, from + 9)}`);
+        return at;
+    };
+    let i = 0;
+    while (i < xml.length) {
+        const lt = xml.indexOf("<", i);
+        const text = xml.slice(i, lt === -1 ? xml.length : lt);
+        if (stack.length > 1)
+            stack.at(-1).text += decode(text);
+        else if (text.trim())
+            throw new XmlError("Text outside the root element");
+        if (lt === -1)
+            break;
+        if (xml.startsWith("<!--", lt))
+            i = until("-->", lt + 4) + 3;
+        else if (xml.startsWith("<![CDATA[", lt)) {
+            const end = until("]]>", lt + 9);
+            if (stack.length === 1)
+                throw new XmlError("Text outside the root element");
+            stack.at(-1).text += xml.slice(lt + 9, end);
+            i = end + 3;
+        }
+        else if (xml.startsWith("<!", lt))
+            throw new XmlError("A document type declaration is not accepted");
+        else if (xml.startsWith("<?", lt))
+            i = until("?>", lt + 2) + 2;
+        else if (xml.startsWith("</", lt)) {
+            const end = until(">", lt + 2);
+            const name = xml.slice(lt + 2, end).trim();
+            const open = stack.pop();
+            if (stack.length === 0 || open.name !== name)
+                throw new XmlError(`Unexpected closing tag ${name}`);
+            i = end + 1;
+        }
+        else {
+            START.lastIndex = lt;
+            const m = START.exec(xml);
+            if (!m)
+                throw new XmlError("A malformed tag");
+            const node = { name: m[1], attrs: {}, children: [], text: "" };
+            for (const a of m[2].matchAll(ATTR)) {
+                if (Object.hasOwn(node.attrs, a[1]))
+                    throw new XmlError(`Attribute ${a[1]} twice`);
+                node.attrs[a[1]] = decode(a[2] ?? a[3]);
+            }
+            if (stack.length === 1 && root.children.length)
+                throw new XmlError("Two root elements");
+            stack.at(-1).children.push(node);
+            if (!m[3])
+                stack.push(node);
+            if (stack.length > MAX_DEPTH)
+                throw new XmlError("The XML is nested too deeply");
+            i = START.lastIndex;
+        }
+    }
+    if (stack.length !== 1 || root.children.length !== 1)
+        throw new XmlError("Unclosed elements");
+    return root.children[0];
+}
+export const localName = (name) => name.slice(name.indexOf(":") + 1);
+// A key set as data, never as the object's prototype (an element named __proto__).
+function put(out, key, value) {
+    Object.defineProperty(out, key, { value, enumerable: true, writable: true, configurable: true });
+}
+// An element as plain JSON: names without prefixes, repeated children as a list, text
+// trimmed, an element with only text as its text, xsi:nil as null. Attributes with a prefix
+// (namespaces, xsi:type) are left out; others become keys, which child elements win over.
+export function toJson(node) {
+    const nil = Object.entries(node.attrs).some(([k, v]) => localName(k) === "nil" && v === "true");
+    if (nil)
+        return null;
+    const out = {};
+    const listed = new Set();
+    for (const child of node.children) {
+        const key = localName(child.name);
+        const value = toJson(child);
+        if (!listed.has(key))
+            put(out, key, value);
+        else if (Array.isArray(out[key]))
+            out[key].push(value);
+        else
+            put(out, key, [out[key], value]);
+        listed.add(key);
+    }
+    for (const [k, v] of Object.entries(node.attrs))
+        if (!k.includes(":") && k !== "xmlns" && !listed.has(k))
+            put(out, k, v);
+    const text = node.text.trim();
+    if (!Object.keys(out).length)
+        return text;
+    if (text)
+        put(out, "_text", text);
+    return out;
+}
+export const escapeXml = (value) => value.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&apos;" })[c]);
+//# sourceMappingURL=xml.js.map

package/dist/connectors/soap/xml.js.map

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

package/dist/connectors/sql/engines.d.ts

@@ -0,0 +1,58 @@
+import type { SqlApp } from "../../packages/connector-kit/src/connector.js";
+/** A statement's text around its :name params: parts.length is names.length + 1. */
+export type Statement = {
+    parts: string[];
+    names: string[];
+};
+export type Rows = Record<string, unknown>[];
+export type RunInput = {
+    statement: Statement;
+    values: Record<string, unknown>;
+    write: boolean;
+    maxRows: number;
+    timeoutMs: number;
+    check(out: {
+        rows: Rows;
+        rowsAffected: number | null;
+    }): void;
+};
+export type Engine = {
+    run(input: RunInput): Promise<{
+        rows: Rows;
+        rowsAffected: number | null;
+    }>;
+    /** The server's version, from a trivial query proving the connection. */
+    version(): Promise<string>;
+    close(): Promise<void>;
+};
+export type Target = {
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: string;
+    tls: SqlApp["tls"];
+    readOnly: boolean;
+};
+export declare const DEFAULT_PORT: {
+    postgres: number;
+    sqlserver: number;
+    mysql: number;
+    oracle: number;
+};
+export declare const DRIVER: {
+    readonly sqlserver: "mssql";
+    readonly mysql: "mysql2/promise";
+    readonly oracle: "oracledb";
+};
+/** Splits on :name, skipping quoted text, comments and casts (::type). */
+export declare function parseStatement(sql: string): Statement;
+/** Throws when the engine's driver is not installed, naming what to install. */
+export declare function assertDriver(engine: SqlApp["engine"], app: string, resolve?: (name: string) => string): void;
+type Driver = any;
+export declare function openEngine(engine: SqlApp["engine"], target: Target, driver?: Driver): Promise<Engine>;
+export declare function pgEngine(t: Target, pg: Driver): Engine;
+export declare function sqlServerEngine(t: Target, mssql: Driver): Engine;
+export declare function mySqlEngine(t: Target, mysql: Driver): Engine;
+export declare function oracleEngine(t: Target, oracledb: Driver): Engine;
+export {};