@taodigital/connectors 0.0.0-stage → 1.2.0

package/src/pagerduty.ts

@@ -0,0 +1,78 @@
+/**
+ * PagerDuty connector — alert on critical test failures.
+ * API key stored encrypted per project.
+ */
+
+export interface PagerDutyCredentials {
+  apiKey: string;
+  serviceId?: string;   // PD service to create incidents under
+  escalationPolicyId?: string;
+}
+
+function headers(creds: PagerDutyCredentials, fromEmail = '') {
+  return {
+    Authorization: `Token token=${creds.apiKey}`,
+    Accept: 'application/vnd.pagerduty+json;version=2',
+    'Content-Type': 'application/json',
+    From: fromEmail,
+  };
+}
+
+export async function testConnection(creds: PagerDutyCredentials): Promise<{ ok: boolean; error?: string }> {
+  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) };
+  }
+}
+
+export async function createIncident(creds: PagerDutyCredentials, opts: {
+  title: string;
+  body: string;
+  severity: 'critical' | 'error' | 'warning' | 'info';
+  severityMap?: Partial<Record<'critical' | 'error' | 'warning' | 'info', 'high' | 'low'>>;
+}) {
+  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: Partial<Record<'critical' | 'error' | 'warning' | 'info', 'high' | 'low'>> = (() => {
+    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()) as any;
+  return { id: data.incident?.id, url: data.incident?.html_url };
+}
+
+export async function resolveIncident(creds: PagerDutyCredentials, incidentId: string) {
+  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/src/salesforce.ts

@@ -0,0 +1,109 @@
+/**
+ * Salesforce connector — OAuth2 client credentials flow.
+ * clientId + encrypted clientSecret stored per project.
+ */
+
+import { assertResolvesToPublicAddress } from '@taodigital/core';
+
+export interface SalesforceCredentials {
+  instanceUrl: string;   // e.g. https://yourorg.my.salesforce.com
+  clientId: string;      // Connected App Consumer Key
+  clientSecret: string;  // Consumer Secret (stored encrypted)
+  username?: string;     // Optional: for username-password flow
+  password?: string;     // Optional: stored encrypted
+}
+
+async function getAccessToken(creds: SalesforceCredentials): Promise<string> {
+  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()) as any;
+  return data.access_token;
+}
+
+export async function testConnection(creds: SalesforceCredentials): Promise<{ ok: boolean; error?: string }> {
+  try {
+    await assertResolvesToPublicAddress(creds.instanceUrl);
+    await getAccessToken(creds);
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, error: String(err) };
+  }
+}
+
+export async function listObjects(creds: SalesforceCredentials) {
+  await 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()) as any;
+  return (data.sobjects ?? []).map((o: any) => ({ name: o.name, label: o.label, custom: o.custom }));
+}
+
+export async function queryRecords(creds: SalesforceCredentials, soql: string) {
+  await 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()) as any;
+  return { totalSize: data.totalSize, records: data.records ?? [] };
+}
+
+export async function createCase(creds: SalesforceCredentials, opts: {
+  subject: string;
+  description: string;
+  priority?: 'High' | 'Medium' | 'Low';
+  origin?: string;
+}) {
+  await 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()) as any;
+  return { id: data.id, url: `${creds.instanceUrl}/lightning/r/Case/${data.id}/view` };
+}
+
+export async function listCases(creds: SalesforceCredentials, opts?: { limit?: number }) {
+  return queryRecords(
+    creds,
+    `SELECT Id, CaseNumber, Subject, Status, Priority, CreatedDate, Description FROM Case ORDER BY CreatedDate DESC LIMIT ${opts?.limit ?? 25}`,
+  );
+}

package/src/servicenow.ts

@@ -0,0 +1,112 @@
+/**
+ * ServiceNow connector — incident and change management integration.
+ * Credentials stored encrypted per project.
+ */
+
+import { assertResolvesToPublicAddress } from '@taodigital/core';
+
+export interface ServiceNowCredentials {
+  instanceUrl: string;  // e.g. https://yourcompany.service-now.com
+  username: string;
+  password: string;
+}
+
+function authHeader(creds: ServiceNowCredentials): string {
+  return 'Basic ' + Buffer.from(`${creds.username}:${creds.password}`).toString('base64');
+}
+
+function headers(creds: ServiceNowCredentials) {
+  return {
+    Authorization: authHeader(creds),
+    'Content-Type': 'application/json',
+    Accept: 'application/json',
+  };
+}
+
+export async function testConnection(creds: ServiceNowCredentials): Promise<{ ok: boolean; error?: string }> {
+  try {
+    await assertResolvesToPublicAddress(creds.instanceUrl);
+    const res = await fetch(`${creds.instanceUrl}/api/now/table/sys_user?sysparm_limit=1`, {
+      headers: headers(creds),
+    });
+    if (!res.ok) return { ok: false, error: `ServiceNow returned ${res.status}` };
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, error: String(err) };
+  }
+}
+
+export async 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;
+}) {
+  await assertResolvesToPublicAddress(creds.instanceUrl);
+  const { getSystemConfig } = await import('@taodigital/core');
+  const snCfg = await getSystemConfig('connectors_servicenow');
+  const res = await fetch(`${creds.instanceUrl}/api/now/table/incident`, {
+    method: 'POST',
+    headers: headers(creds),
+    body: JSON.stringify({
+      short_description: opts.shortDescription,
+      description: opts.description,
+      urgency: String(opts.urgency ?? opts.defaultUrgency ?? 2),
+      impact: String(opts.impact ?? opts.defaultImpact ?? 2),
+      category: opts.category ?? opts.defaultCategory ?? String(snCfg?.defaultCategory ?? ''),
+      caller_id: creds.username,
+    }),
+  });
+  if (!res.ok) throw new Error(`ServiceNow error: ${res.status} ${await res.text()}`);
+  const data = (await res.json()) as any;
+  return {
+    sysId: data.result?.sys_id,
+    number: data.result?.number,
+    url: `${creds.instanceUrl}/nav_to.do?uri=incident.do?sys_id=${data.result?.sys_id}`,
+  };
+}
+
+export async function createChangeRequest(creds: ServiceNowCredentials, opts: {
+  shortDescription: string;
+  description: string;
+  type?: 'normal' | 'standard' | 'emergency';
+  defaultType?: 'normal' | 'standard' | 'emergency';
+}) {
+  await assertResolvesToPublicAddress(creds.instanceUrl);
+  const res = await fetch(`${creds.instanceUrl}/api/now/table/change_request`, {
+    method: 'POST',
+    headers: headers(creds),
+    body: JSON.stringify({
+      short_description: opts.shortDescription,
+      description: opts.description,
+      type: opts.type ?? opts.defaultType ?? 'normal',
+      requested_by: creds.username,
+    }),
+  });
+  if (!res.ok) throw new Error(`ServiceNow error: ${res.status}`);
+  const data = (await res.json()) as any;
+  return { sysId: data.result?.sys_id, number: data.result?.number };
+}
+
+export async function listIncidents(creds: ServiceNowCredentials, opts?: { limit?: number; state?: string }) {
+  await assertResolvesToPublicAddress(creds.instanceUrl);
+  const { getSystemConfig } = await import('@taodigital/core');
+  const snCfg = await getSystemConfig('connectors_servicenow');
+  const pageLimit = parseInt(String(snCfg?.pageLimit ?? '25'), 10);
+  const params = new URLSearchParams({
+    sysparm_limit: String(opts?.limit ?? pageLimit),
+    sysparm_fields: 'sys_id,number,short_description,state,urgency,priority,opened_at,caller_id',
+    sysparm_display_value: 'true',
+    ...(opts?.state ? { sysparm_query: `state=${opts.state}` } : {}),
+  });
+  const res = await fetch(`${creds.instanceUrl}/api/now/table/incident?${params}`, {
+    headers: headers(creds),
+  });
+  if (!res.ok) throw new Error(`ServiceNow error: ${res.status}`);
+  const data = (await res.json()) as any;
+  return (data.result ?? []) as any[];
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"]
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.