@taodigital/connectors 0.0.0-stage → 1.2.1

package/dist/jira.js

@@ -0,0 +1,354 @@
+"use strict";
+/**
+ * JIRA connector — credentials passed in, never read from env.
+ * baseUrl and email stored as-is; apiToken stored encrypted.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testConnection = testConnection;
+exports.listProjects = listProjects;
+exports.listRecentIssues = listRecentIssues;
+exports.getIssue = getIssue;
+exports.createBug = createBug;
+exports.listUserStories = listUserStories;
+exports.createTestCase = createTestCase;
+exports.searchIssues = searchIssues;
+const core_1 = require("@taodigital/core");
+function validateProxyUrl(proxyUrl) {
+    let parsed;
+    try {
+        parsed = new URL(proxyUrl);
+    }
+    catch {
+        throw new Error(`Invalid proxy URL: ${proxyUrl}`);
+    }
+    const h = parsed.hostname.toLowerCase();
+    // Block loopback, link-local metadata
+    if (h === 'localhost' || h === '127.0.0.1' || h === '::1' || h === '169.254.169.254') {
+        throw new Error('Proxy URL must not target localhost or metadata addresses');
+    }
+    // Block RFC-1918 private ranges (10/8, 172.16-31/12, 192.168/16)
+    const parts = h.split('.').map(Number);
+    if (parts.length === 4 && !parts.some(isNaN)) {
+        const [a, b] = parts;
+        if (a === 10)
+            throw new Error('Proxy URL must not target private network (10.0.0.0/8)');
+        if (a === 172 && b >= 16 && b <= 31)
+            throw new Error('Proxy URL must not target private network (172.16.0.0/12)');
+        if (a === 192 && b === 168)
+            throw new Error('Proxy URL must not target private network (192.168.0.0/16)');
+    }
+}
+async function makeFetch(creds) {
+    const TIMEOUT_MS = 15_000;
+    if (creds.proxyUrl) {
+        validateProxyUrl(creds.proxyUrl);
+        const { ProxyAgent } = await import('undici');
+        const dispatcher = new ProxyAgent(creds.proxyUrl);
+        return (url, init) => fetch(url, { signal: AbortSignal.timeout(TIMEOUT_MS), ...(init ?? {}), dispatcher });
+    }
+    // Wrap global fetch with a 15s timeout on every call
+    return (url, init) => fetch(url, { signal: AbortSignal.timeout(TIMEOUT_MS), ...(init ?? {}) });
+}
+function authHeader(creds) {
+    if (creds.bearerToken)
+        return `Bearer ${creds.bearerToken}`;
+    const secret = creds.password || creds.apiToken; // password = Server/DC, apiToken = Cloud
+    return 'Basic ' + Buffer.from(`${creds.email}:${secret}`).toString('base64');
+}
+async function testConnection(creds) {
+    try {
+        const doFetch = await makeFetch(creds);
+        if (!creds.proxyUrl)
+            await (0, core_1.assertResolvesToPublicAddress)(creds.baseUrl);
+        const res = await doFetch(`${creds.baseUrl}/rest/api/3/myself`, {
+            headers: { Authorization: authHeader(creds), Accept: 'application/json' },
+        });
+        if (!res.ok)
+            return { ok: false, error: `JIRA returned ${res.status}` };
+        const data = (await res.json());
+        return { ok: true, displayName: data.displayName };
+    }
+    catch (err) {
+        return { ok: false, error: String(err) };
+    }
+}
+async function listProjects(creds) {
+    const doFetch = await makeFetch(creds);
+    if (!creds.proxyUrl)
+        await (0, core_1.assertResolvesToPublicAddress)(creds.baseUrl);
+    const { getSystemConfig } = await import('@taodigital/core');
+    const jiraCfg = await getSystemConfig('connectors_jira');
+    const pageSize = parseInt(String(jiraCfg?.pageSize ?? '50'), 10);
+    const MAX_PAGES = 10;
+    const allProjects = [];
+    let startAt = 0;
+    let truncated = false;
+    for (let page = 0; page < MAX_PAGES; page++) {
+        const res = await doFetch(`${creds.baseUrl}/rest/api/3/project/search?maxResults=${pageSize}&startAt=${startAt}`, {
+            headers: { Authorization: authHeader(creds), Accept: 'application/json' },
+        });
+        if (!res.ok)
+            throw new Error(`JIRA error: ${res.status}`);
+        const data = (await res.json());
+        const values = data.values ?? [];
+        allProjects.push(...values);
+        const total = data.total ?? 0;
+        if (values.length < pageSize || allProjects.length >= total)
+            break;
+        startAt += values.length;
+        if (page === MAX_PAGES - 1) {
+            truncated = true;
+            console.warn(`listProjects: total=${total} exceeds page cap (${MAX_PAGES * pageSize}); results truncated`);
+            break;
+        }
+    }
+    return allProjects.map((p) => ({ key: p.key, name: p.name, id: p.id }));
+}
+async function listRecentIssues(creds, maxResults) {
+    const doFetch = await makeFetch(creds);
+    if (!creds.proxyUrl)
+        await (0, core_1.assertResolvesToPublicAddress)(creds.baseUrl);
+    const { getSystemConfig } = await import('@taodigital/core');
+    const jiraCfg = await getSystemConfig('connectors_jira');
+    const resolvedMaxResults = maxResults ?? parseInt(String(jiraCfg?.recentPageSize ?? '20'), 10);
+    const jql = creds.projectKey
+        ? `project = "${(creds.projectKey ?? '').replace(/"/g, '\\"')}" ORDER BY updated DESC`
+        : 'ORDER BY updated DESC';
+    const res = await doFetch(`${creds.baseUrl}/rest/api/3/search?jql=${encodeURIComponent(jql)}&maxResults=${resolvedMaxResults}&fields=summary,status,priority,assignee,updated`, { headers: { Authorization: authHeader(creds), Accept: 'application/json' } });
+    if (!res.ok)
+        throw new Error(`JIRA error: ${res.status}`);
+    const data = (await res.json());
+    return (data.issues ?? []).map((i) => ({
+        key: i.key,
+        summary: i.fields?.summary,
+        status: i.fields?.status?.name,
+        priority: i.fields?.priority?.name,
+        assignee: i.fields?.assignee?.displayName,
+        updated: i.fields?.updated,
+    }));
+}
+async function getIssue(creds, issueKey, options = {}) {
+    const doFetch = await makeFetch(creds);
+    if (!creds.proxyUrl)
+        await (0, core_1.assertResolvesToPublicAddress)(creds.baseUrl);
+    const { getSystemConfig } = await import('@taodigital/core');
+    const jiraCfg = await getSystemConfig('connectors_jira');
+    const acField = options.acceptanceCriteriaFieldId ?? String(jiraCfg?.acFieldId ?? '');
+    const fieldsParam = `summary,description,status,priority,issuetype,labels,components,issuelinks,parent,subtasks${acField ? `,${acField}` : ''}`;
+    const res = await doFetch(`${creds.baseUrl}/rest/api/3/issue/${issueKey}?fields=${encodeURIComponent(fieldsParam)}`, {
+        headers: { Authorization: authHeader(creds), Accept: 'application/json' },
+    });
+    if (!res.ok)
+        throw new Error(`JIRA error: ${res.status}`);
+    const i = (await res.json());
+    return {
+        key: i.key,
+        summary: i.fields?.summary,
+        description: i.fields?.description,
+        status: i.fields?.status?.name,
+        priority: i.fields?.priority?.name,
+        issueType: i.fields?.issuetype?.name,
+        acceptanceCriteria: acField ? (i.fields?.[acField] ?? null) : null,
+        labels: i.fields?.labels ?? [],
+        components: (i.fields?.components ?? []).map((c) => c.name),
+        epic: i.fields?.parent ? { key: i.fields.parent.key, summary: i.fields.parent.fields?.summary } : null,
+        links: (i.fields?.issuelinks ?? []).map((l) => ({
+            type: l.type?.name ?? l.type?.inward ?? l.type?.outward ?? 'relates',
+            key: l.inwardIssue?.key ?? l.outwardIssue?.key,
+            summary: l.inwardIssue?.fields?.summary ?? l.outwardIssue?.fields?.summary,
+        })).filter((x) => Boolean(x.key)),
+        subtasks: (i.fields?.subtasks ?? []).map((st) => ({ key: st.key, summary: st.fields?.summary })),
+        url: `${creds.baseUrl}/browse/${i.key}`,
+    };
+}
+async function createBug(creds, opts) {
+    const doFetch = await makeFetch(creds);
+    if (!creds.proxyUrl)
+        await (0, core_1.assertResolvesToPublicAddress)(creds.baseUrl);
+    if (!creds.projectKey)
+        throw new Error('projectKey required to create JIRA issues.');
+    const res = await doFetch(`${creds.baseUrl}/rest/api/3/issue`, {
+        method: 'POST',
+        headers: {
+            Authorization: authHeader(creds),
+            Accept: 'application/json',
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            fields: {
+                project: { key: creds.projectKey },
+                summary: opts.summary,
+                description: {
+                    type: 'doc',
+                    version: 1,
+                    content: [{ type: 'paragraph', content: [{ type: 'text', text: opts.description }] }],
+                },
+                issuetype: { name: 'Bug' },
+                priority: { name: opts.priority ?? opts.defaultBugPriority ?? 'High' },
+                labels: opts.labels ?? (opts.defaultBugLabel ? [opts.defaultBugLabel] : []),
+            },
+        }),
+    });
+    if (!res.ok)
+        throw new Error(`JIRA error: ${res.status} ${await res.text()}`);
+    const created = (await res.json());
+    return { key: created.key, url: `${creds.baseUrl}/browse/${created.key}` };
+}
+async function listUserStories(creds, sprintId, maxResults, options = {}) {
+    const doFetch = await makeFetch(creds);
+    if (!creds.proxyUrl)
+        await (0, core_1.assertResolvesToPublicAddress)(creds.baseUrl);
+    const { getSystemConfig } = await import('@taodigital/core');
+    const jiraCfg = await getSystemConfig('connectors_jira');
+    const pageSize = Math.min(maxResults ?? parseInt(String(jiraCfg?.pageSize ?? '50'), 10), 100);
+    const acField = options.acceptanceCriteriaFieldId ?? String(jiraCfg?.acFieldId ?? '');
+    const jql = sprintId
+        ? `project = "${(creds.projectKey ?? '').replace(/"/g, '\\"')}" AND sprint = ${sprintId} AND issuetype = Story ORDER BY priority DESC`
+        : `project = "${(creds.projectKey ?? '').replace(/"/g, '\\"')}" AND issuetype = Story ORDER BY updated DESC`;
+    const fieldsParam = `summary,description,status,priority,issuetype,labels,components,issuelinks,parent,subtasks${acField ? `,${acField}` : ''}`;
+    const MAX_PAGES = 20;
+    const allIssues = [];
+    let startAt = 0;
+    let truncated = false;
+    for (let page = 0; page < MAX_PAGES; page++) {
+        const res = await doFetch(`${creds.baseUrl}/rest/api/3/search?jql=${encodeURIComponent(jql)}&maxResults=${pageSize}&startAt=${startAt}&fields=${encodeURIComponent(fieldsParam)}`, { headers: { Authorization: authHeader(creds), Accept: 'application/json' } });
+        if (!res.ok)
+            throw new Error(`JIRA error: ${res.status}`);
+        const data = (await res.json());
+        const issues = data.issues ?? [];
+        allIssues.push(...issues);
+        const total = data.total ?? 0;
+        if (issues.length < pageSize || allIssues.length >= total)
+            break;
+        startAt += issues.length;
+        if (page === MAX_PAGES - 1) {
+            truncated = true;
+            break;
+        }
+    }
+    const mapped = allIssues.map((i) => ({
+        key: i.key,
+        summary: i.fields?.summary,
+        description: i.fields?.description,
+        acceptanceCriteria: acField ? (i.fields?.[acField] ?? null) : null,
+        status: i.fields?.status?.name,
+        priority: i.fields?.priority?.name,
+        issueType: i.fields?.issuetype?.name,
+        labels: i.fields?.labels ?? [],
+        components: (i.fields?.components ?? []).map((c) => c.name),
+        epic: i.fields?.parent
+            ? { key: i.fields.parent.key, summary: i.fields.parent.summary ?? i.fields.parent.fields?.summary ?? null }
+            : null,
+        links: (i.fields?.issuelinks ?? []).map((l) => ({
+            type: l.type?.name ?? l.type?.inward ?? l.type?.outward ?? 'relates',
+            key: l.inwardIssue?.key ?? l.outwardIssue?.key,
+            summary: l.inwardIssue?.fields?.summary ?? l.outwardIssue?.fields?.summary,
+        })).filter((x) => Boolean(x.key)),
+        subtasks: (i.fields?.subtasks ?? []).map((st) => ({ key: st.key, summary: st.fields?.summary })),
+        url: `${creds.baseUrl}/browse/${i.key}`,
+    }));
+    return { stories: mapped, truncated };
+}
+async function createTestCase(creds, opts) {
+    const doFetch = await makeFetch(creds);
+    if (!creds.proxyUrl)
+        await (0, core_1.assertResolvesToPublicAddress)(creds.baseUrl);
+    if (!creds.projectKey)
+        throw new Error('projectKey required to create Jira test cases.');
+    const { stepsHtml } = opts;
+    const stepLines = (stepsHtml ?? '')
+        .split(/<br\s*\/?>|<\/li>/i)
+        .map((s) => s.replace(/<[^>]+>/g, '').trim())
+        .filter(Boolean);
+    const stepsNode = stepLines.length > 0
+        ? {
+            type: 'orderedList',
+            content: stepLines.map((t) => ({
+                type: 'listItem',
+                content: [{ type: 'paragraph', content: [{ type: 'text', text: t }] }]
+            }))
+        }
+        : { type: 'paragraph', content: [{ type: 'text', text: stepsHtml ?? '' }] };
+    const res = await doFetch(`${creds.baseUrl}/rest/api/3/issue`, {
+        method: 'POST',
+        headers: {
+            Authorization: authHeader(creds),
+            Accept: 'application/json',
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            fields: {
+                project: { key: creds.projectKey },
+                summary: opts.summary,
+                description: {
+                    type: 'doc',
+                    version: 1,
+                    content: [stepsNode],
+                },
+                // 'Test' issuetype requires Xray; falls back to 'Story' if not found (Jira returns 400)
+                issuetype: { name: opts.defaultIssueType ?? 'Test' },
+                priority: { name: opts.priority ?? 'High' },
+                labels: (opts.labels ?? []).map((l) => l.replace(/^@/, '')),
+            },
+        }),
+    });
+    if (!res.ok) {
+        const errText = await res.text().catch(() => '');
+        // Xray 'Test' issue type not available — retry as Story
+        if (res.status === 400 && errText.includes('issuetype')) {
+            const retry = await doFetch(`${creds.baseUrl}/rest/api/3/issue`, {
+                method: 'POST',
+                headers: {
+                    Authorization: authHeader(creds),
+                    Accept: 'application/json',
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    fields: {
+                        project: { key: creds.projectKey },
+                        summary: opts.summary,
+                        description: {
+                            type: 'doc',
+                            version: 1,
+                            content: [stepsNode],
+                        },
+                        issuetype: { name: 'Story' },
+                        priority: { name: opts.priority ?? 'High' },
+                        labels: [...(opts.defaultTestCaseLabel ? [opts.defaultTestCaseLabel] : []), ...(opts.labels ?? []).map((l) => l.replace(/^@/, ''))],
+                    },
+                }),
+            });
+            if (!retry.ok)
+                throw new Error(`Jira error: ${retry.status} ${await retry.text().catch(() => '')}`);
+            const d = (await retry.json());
+            return { key: d.key, url: `${creds.baseUrl}/browse/${d.key}` };
+        }
+        throw new Error(`Jira error: ${res.status} ${errText.slice(0, 200)}`);
+    }
+    const created = (await res.json());
+    return { key: created.key, url: `${creds.baseUrl}/browse/${created.key}` };
+}
+/** Free-text search — finds issues that mention a screen URL or name. */
+async function searchIssues(creds, text, maxResults) {
+    const doFetch = await makeFetch(creds);
+    if (!creds.proxyUrl)
+        await (0, core_1.assertResolvesToPublicAddress)(creds.baseUrl);
+    const { getSystemConfig } = await import('@taodigital/core');
+    const jiraCfg = await getSystemConfig('connectors_jira');
+    const resolvedMaxResults = maxResults ?? parseInt(String(jiraCfg?.searchPageSize ?? '10'), 10);
+    const safeText = text.replace(/["\\]/g, ' ').trim();
+    const projectClause = creds.projectKey ? `project = "${(creds.projectKey ?? '').replace(/"/g, '\\"')}" AND ` : '';
+    const jql = `${projectClause}text ~ "${safeText}" ORDER BY updated DESC`;
+    const res = await doFetch(`${creds.baseUrl}/rest/api/3/search?jql=${encodeURIComponent(jql)}&maxResults=${resolvedMaxResults}&fields=summary,status,priority,updated`, { headers: { Authorization: authHeader(creds), Accept: 'application/json' } });
+    if (!res.ok)
+        throw new Error(`Jira search failed: ${res.status} ${await res.text().catch(() => '')}`);
+    const data = (await res.json());
+    return (data.issues ?? []).map((i) => ({
+        key: i.key,
+        summary: i.fields?.summary,
+        status: i.fields?.status?.name,
+        priority: i.fields?.priority?.name,
+        updated: i.fields?.updated,
+        url: `${creds.baseUrl}/browse/${i.key}`,
+    }));
+}

package/dist/pagerduty.d.ts

@@ -0,0 +1,25 @@
+/**
+ * PagerDuty connector — alert on critical test failures.
+ * API key stored encrypted per project.
+ */
+export interface PagerDutyCredentials {
+    apiKey: string;
+    serviceId?: string;
+    escalationPolicyId?: string;
+}
+export declare function testConnection(creds: PagerDutyCredentials): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function createIncident(creds: PagerDutyCredentials, opts: {
+    title: string;
+    body: string;
+    severity: 'critical' | 'error' | 'warning' | 'info';
+    severityMap?: Partial<Record<'critical' | 'error' | 'warning' | 'info', 'high' | 'low'>>;
+}): Promise<{
+    id: any;
+    url: any;
+}>;
+export declare function resolveIncident(creds: PagerDutyCredentials, incidentId: string): Promise<{
+    resolved: boolean;
+}>;

package/dist/pagerduty.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * PagerDuty connector — alert on critical test failures.
+ * API key stored encrypted per project.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testConnection = testConnection;
+exports.createIncident = createIncident;
+exports.resolveIncident = resolveIncident;
+function headers(creds, fromEmail = '') {
+    return {
+        Authorization: `Token token=${creds.apiKey}`,
+        Accept: 'application/vnd.pagerduty+json;version=2',
+        'Content-Type': 'application/json',
+        From: fromEmail,
+    };
+}
+async function testConnection(creds) {
+    try {
+        const { getSystemConfig } = await import('@taodigital/core');
+        const pdCfg = await getSystemConfig('connectors_pagerduty');
+        const fromEmail = String(pdCfg?.fromEmail ?? '');
+        const res = await fetch('https://api.pagerduty.com/users/me', { headers: headers(creds, fromEmail) });
+        if (!res.ok)
+            return { ok: false, error: `PagerDuty returned ${res.status}` };
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, error: String(err) };
+    }
+}
+async function createIncident(creds, opts) {
+    if (!creds.serviceId)
+        throw new Error('PagerDuty serviceId is required to create incidents.');
+    const { getSystemConfig } = await import('@taodigital/core');
+    const pdCfg = await getSystemConfig('connectors_pagerduty');
+    const fromEmail = String(pdCfg?.fromEmail ?? '');
+    const defaultSeverityMap = (() => {
+        try {
+            return JSON.parse(String(pdCfg?.severityMap ?? '{"critical":"high","error":"high","warning":"medium","info":"low"}'));
+        }
+        catch {
+            return { critical: 'high', error: 'high' };
+        }
+    })();
+    const res = await fetch('https://api.pagerduty.com/incidents', {
+        method: 'POST',
+        headers: headers(creds, fromEmail),
+        body: JSON.stringify({
+            incident: {
+                type: 'incident',
+                title: opts.title,
+                service: { id: creds.serviceId, type: 'service_reference' },
+                urgency: (opts.severityMap ?? defaultSeverityMap)[opts.severity] ?? 'low',
+                body: { type: 'incident_body', details: opts.body },
+            },
+        }),
+    });
+    if (!res.ok)
+        throw new Error(`PagerDuty error: ${res.status} ${await res.text()}`);
+    const data = (await res.json());
+    return { id: data.incident?.id, url: data.incident?.html_url };
+}
+async function resolveIncident(creds, incidentId) {
+    const { getSystemConfig } = await import('@taodigital/core');
+    const pdCfg = await getSystemConfig('connectors_pagerduty');
+    const fromEmail = String(pdCfg?.fromEmail ?? '');
+    const res = await fetch(`https://api.pagerduty.com/incidents/${incidentId}`, {
+        method: 'PUT',
+        headers: headers(creds, fromEmail),
+        body: JSON.stringify({ incident: { type: 'incident', status: 'resolved' } }),
+    });
+    if (!res.ok)
+        throw new Error(`PagerDuty error: ${res.status}`);
+    return { resolved: true };
+}

package/dist/salesforce.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Salesforce connector — OAuth2 client credentials flow.
+ * clientId + encrypted clientSecret stored per project.
+ */
+export interface SalesforceCredentials {
+    instanceUrl: string;
+    clientId: string;
+    clientSecret: string;
+    username?: string;
+    password?: string;
+}
+export declare function testConnection(creds: SalesforceCredentials): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function listObjects(creds: SalesforceCredentials): Promise<any>;
+export declare function queryRecords(creds: SalesforceCredentials, soql: string): Promise<{
+    totalSize: any;
+    records: any;
+}>;
+export declare function createCase(creds: SalesforceCredentials, opts: {
+    subject: string;
+    description: string;
+    priority?: 'High' | 'Medium' | 'Low';
+    origin?: string;
+}): Promise<{
+    id: any;
+    url: string;
+}>;
+export declare function listCases(creds: SalesforceCredentials, opts?: {
+    limit?: number;
+}): Promise<{
+    totalSize: any;
+    records: any;
+}>;

package/dist/salesforce.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Salesforce connector — OAuth2 client credentials flow.
+ * clientId + encrypted clientSecret stored per project.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testConnection = testConnection;
+exports.listObjects = listObjects;
+exports.queryRecords = queryRecords;
+exports.createCase = createCase;
+exports.listCases = listCases;
+const core_1 = require("@taodigital/core");
+async function getAccessToken(creds) {
+    const params = new URLSearchParams({
+        grant_type: 'client_credentials',
+        client_id: creds.clientId,
+        client_secret: creds.clientSecret,
+    });
+    const res = await fetch(`${creds.instanceUrl}/services/oauth2/token`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: params.toString(),
+    });
+    if (!res.ok)
+        throw new Error(`Salesforce OAuth error: ${res.status} ${await res.text()}`);
+    const data = (await res.json());
+    return data.access_token;
+}
+async function testConnection(creds) {
+    try {
+        await (0, core_1.assertResolvesToPublicAddress)(creds.instanceUrl);
+        await getAccessToken(creds);
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, error: String(err) };
+    }
+}
+async function listObjects(creds) {
+    await (0, core_1.assertResolvesToPublicAddress)(creds.instanceUrl);
+    const { getSystemConfig } = await import('@taodigital/core');
+    const sfCfg = await getSystemConfig('connectors_salesforce');
+    const apiVersion = String(sfCfg?.apiVersion ?? 'v59.0');
+    const token = await getAccessToken(creds);
+    const res = await fetch(`${creds.instanceUrl}/services/data/${apiVersion}/sobjects/`, {
+        headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
+    });
+    if (!res.ok)
+        throw new Error(`Salesforce error: ${res.status}`);
+    const data = (await res.json());
+    return (data.sobjects ?? []).map((o) => ({ name: o.name, label: o.label, custom: o.custom }));
+}
+async function queryRecords(creds, soql) {
+    await (0, core_1.assertResolvesToPublicAddress)(creds.instanceUrl);
+    const { getSystemConfig } = await import('@taodigital/core');
+    const sfCfg = await getSystemConfig('connectors_salesforce');
+    const apiVersion = String(sfCfg?.apiVersion ?? 'v59.0');
+    const token = await getAccessToken(creds);
+    const res = await fetch(`${creds.instanceUrl}/services/data/${apiVersion}/query?q=${encodeURIComponent(soql)}`, { headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' } });
+    if (!res.ok)
+        throw new Error(`Salesforce error: ${res.status}`);
+    const data = (await res.json());
+    return { totalSize: data.totalSize, records: data.records ?? [] };
+}
+async function createCase(creds, opts) {
+    await (0, core_1.assertResolvesToPublicAddress)(creds.instanceUrl);
+    const { getSystemConfig } = await import('@taodigital/core');
+    const sfCfg = await getSystemConfig('connectors_salesforce');
+    const apiVersion = String(sfCfg?.apiVersion ?? 'v59.0');
+    const token = await getAccessToken(creds);
+    const res = await fetch(`${creds.instanceUrl}/services/data/${apiVersion}/sobjects/Case/`, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+        body: JSON.stringify({
+            Subject: opts.subject,
+            Description: opts.description,
+            Priority: opts.priority ?? 'High',
+            Origin: opts.origin ?? String(sfCfg?.caseOrigin ?? ''),
+            Status: 'New',
+        }),
+    });
+    if (!res.ok)
+        throw new Error(`Salesforce error: ${res.status} ${await res.text()}`);
+    const data = (await res.json());
+    return { id: data.id, url: `${creds.instanceUrl}/lightning/r/Case/${data.id}/view` };
+}
+async function listCases(creds, opts) {
+    return queryRecords(creds, `SELECT Id, CaseNumber, Subject, Status, Priority, CreatedDate, Description FROM Case ORDER BY CreatedDate DESC LIMIT ${opts?.limit ?? 25}`);
+}

package/dist/servicenow.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ServiceNow connector — incident and change management integration.
+ * Credentials stored encrypted per project.
+ */
+export interface ServiceNowCredentials {
+    instanceUrl: string;
+    username: string;
+    password: string;
+}
+export declare function testConnection(creds: ServiceNowCredentials): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function createIncident(creds: ServiceNowCredentials, opts: {
+    shortDescription: string;
+    description: string;
+    urgency?: 1 | 2 | 3;
+    impact?: 1 | 2 | 3;
+    category?: string;
+    defaultUrgency?: 1 | 2 | 3;
+    defaultImpact?: 1 | 2 | 3;
+    defaultCategory?: string;
+}): Promise<{
+    sysId: any;
+    number: any;
+    url: string;
+}>;
+export declare function createChangeRequest(creds: ServiceNowCredentials, opts: {
+    shortDescription: string;
+    description: string;
+    type?: 'normal' | 'standard' | 'emergency';
+    defaultType?: 'normal' | 'standard' | 'emergency';
+}): Promise<{
+    sysId: any;
+    number: any;
+}>;
+export declare function listIncidents(creds: ServiceNowCredentials, opts?: {
+    limit?: number;
+    state?: string;
+}): Promise<any[]>;