@taodigital/connectors 0.0.0-stage → 1.2.0

package/dist/github.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * GitHub connector — credentials passed in, never read from env.
+ * Token is stored encrypted in Connector.config per project.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testConnection = testConnection;
+exports.listRecentCommits = listRecentCommits;
+exports.createIssue = createIssue;
+exports.listPullRequests = listPullRequests;
+exports.pushFile = pushFile;
+const core_1 = require("@taodigital/core");
+/** Test that the stored credentials actually work. */
+async function testConnection(creds) {
+    try {
+        await (0, core_1.assertResolvesToPublicAddress)('https://api.github.com');
+        const res = await fetch('https://api.github.com/user', {
+            headers: { Authorization: `Bearer ${creds.token}`, 'User-Agent': 'zeta-ai' },
+        });
+        if (!res.ok)
+            return { ok: false, error: `GitHub returned ${res.status}` };
+        const data = (await res.json());
+        return { ok: true, login: data.login };
+    }
+    catch (err) {
+        return { ok: false, error: String(err) };
+    }
+}
+async function listRecentCommits(creds, branch) {
+    await (0, core_1.assertResolvesToPublicAddress)('https://api.github.com');
+    const { getSystemConfig } = await import('@taodigital/core');
+    const ghCfg = await getSystemConfig('connectors_github');
+    const pageSize = parseInt(String(ghCfg?.pageSize ?? '10'), 10);
+    const ref = branch ?? creds.defaultBranch ?? 'main';
+    const res = await fetch(`https://api.github.com/repos/${creds.repo}/commits?sha=${ref}&per_page=${pageSize}`, { headers: { Authorization: `Bearer ${creds.token}`, 'User-Agent': 'zeta-ai' } });
+    if (!res.ok)
+        throw new Error(`GitHub error: ${res.status}`);
+    const commits = (await res.json());
+    return commits.map((c) => ({
+        sha: c.sha?.slice(0, 7),
+        message: c.commit?.message?.split('\n')[0],
+        author: c.commit?.author?.name,
+        date: c.commit?.author?.date,
+    }));
+}
+async function createIssue(creds, title, body, labels, opts) {
+    await (0, core_1.assertResolvesToPublicAddress)('https://api.github.com');
+    const res = await fetch(`https://api.github.com/repos/${creds.repo}/issues`, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${creds.token}`,
+            'User-Agent': 'zeta-ai',
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ title, body, labels: labels ?? opts?.defaultLabels ?? [] }),
+    });
+    if (!res.ok)
+        throw new Error(`GitHub error: ${res.status}`);
+    const issue = (await res.json());
+    return { number: issue.number, url: issue.html_url, title: issue.title };
+}
+async function listPullRequests(creds, state = 'open') {
+    await (0, core_1.assertResolvesToPublicAddress)('https://api.github.com');
+    const { getSystemConfig } = await import('@taodigital/core');
+    const ghCfg = await getSystemConfig('connectors_github');
+    const pageSize = parseInt(String(ghCfg?.pageSize ?? '10'), 10);
+    const res = await fetch(`https://api.github.com/repos/${creds.repo}/pulls?state=${state}&per_page=${pageSize}`, { headers: { Authorization: `Bearer ${creds.token}`, 'User-Agent': 'zeta-ai' } });
+    if (!res.ok)
+        throw new Error(`GitHub error: ${res.status}`);
+    const prs = (await res.json());
+    return prs.map((p) => ({
+        number: p.number,
+        title: p.title,
+        state: p.state,
+        branch: p.head?.ref,
+        url: p.html_url,
+    }));
+}
+/**
+ * Push (create or update) a single file in a GitHub repository.
+ * Uses the GitHub Contents API (PUT /repos/:owner/:repo/contents/:path).
+ */
+async function pushFile(creds, filePath, content, commitMessage, branch) {
+    await (0, core_1.assertResolvesToPublicAddress)('https://api.github.com');
+    const targetBranch = branch ?? creds.defaultBranch ?? 'main';
+    const apiBase = 'https://api.github.com';
+    const headers = {
+        Authorization: `Bearer ${creds.token}`,
+        Accept: 'application/vnd.github.v3+json',
+        'Content-Type': 'application/json',
+        'User-Agent': 'zeta-ai',
+    };
+    const encodedContent = Buffer.from(content, 'utf8').toString('base64');
+    // Fetch existing file SHA (required by GitHub API to update an existing file)
+    let sha;
+    const existing = await fetch(`${apiBase}/repos/${creds.repo}/contents/${filePath}?ref=${targetBranch}`, { headers }).then((r) => (r.ok ? r.json() : null)).catch(() => null);
+    if (existing?.sha)
+        sha = existing.sha;
+    const body = {
+        message: commitMessage,
+        content: encodedContent,
+        branch: targetBranch,
+    };
+    if (sha)
+        body.sha = sha;
+    const res = await fetch(`${apiBase}/repos/${creds.repo}/contents/${filePath}`, {
+        method: 'PUT',
+        headers,
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(`GitHub push failed: ${err.message ?? res.statusText}`);
+    }
+    const data = await res.json();
+    return {
+        url: data.content?.html_url ?? `https://github.com/${creds.repo}/blob/${targetBranch}/${filePath}`,
+        sha: data.content?.sha ?? '',
+    };
+}

package/dist/gitlab.d.ts

@@ -0,0 +1,42 @@
+/**
+ * GitLab connector — credentials passed in, never read from env.
+ * Token (Personal Access Token or project token) stored encrypted
+ * in Connector.config per project. Supports gitlab.com and self-hosted.
+ */
+export interface GitLabCredentials {
+    token: string;
+    projectPath: string;
+    baseUrl?: string;
+    defaultBranch?: string;
+}
+export declare function testConnection(creds: GitLabCredentials): Promise<{
+    ok: boolean;
+    login?: string;
+    error?: string;
+}>;
+export declare function listRecentCommits(creds: GitLabCredentials, branch?: string): Promise<{
+    sha: any;
+    message: any;
+    author: any;
+    date: any;
+}[]>;
+export declare function createIssue(creds: GitLabCredentials, title: string, body: string, labels?: string[]): Promise<{
+    number: number;
+    url: string;
+    title: string;
+}>;
+export declare function listMergeRequests(creds: GitLabCredentials, state?: 'opened' | 'closed' | 'merged' | 'all'): Promise<{
+    number: any;
+    title: any;
+    state: any;
+    branch: any;
+    url: any;
+}[]>;
+/**
+ * Push (create or update) a single file in a GitLab repository.
+ * Uses the GitLab Repository Files API.
+ */
+export declare function pushFile(creds: GitLabCredentials, filePath: string, content: string, commitMessage: string, branch?: string): Promise<{
+    url: string;
+    sha: string;
+}>;

package/dist/gitlab.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * GitLab connector — credentials passed in, never read from env.
+ * Token (Personal Access Token or project token) stored encrypted
+ * in Connector.config per project. Supports gitlab.com and self-hosted.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testConnection = testConnection;
+exports.listRecentCommits = listRecentCommits;
+exports.createIssue = createIssue;
+exports.listMergeRequests = listMergeRequests;
+exports.pushFile = pushFile;
+const core_1 = require("@taodigital/core");
+function apiBase(creds) {
+    const host = (creds.baseUrl ?? 'https://gitlab.com').replace(/\/$/, '');
+    return `${host}/api/v4`;
+}
+function authHeaders(token) {
+    return { 'PRIVATE-TOKEN': token, 'Content-Type': 'application/json' };
+}
+/** URL-encode a project path for use in GitLab API paths. */
+function encodeProject(projectPath) {
+    return encodeURIComponent(projectPath);
+}
+async function testConnection(creds) {
+    try {
+        const host = creds.baseUrl ?? 'https://gitlab.com';
+        await (0, core_1.assertResolvesToPublicAddress)(host);
+        const base = apiBase(creds);
+        const res = await fetch(`${base}/projects/${encodeProject(creds.projectPath)}`, {
+            headers: authHeaders(creds.token),
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (res.status === 401)
+            return { ok: false, error: 'Invalid GitLab token.' };
+        if (res.status === 404)
+            return { ok: false, error: `Project "${creds.projectPath}" not found or token lacks access.` };
+        if (!res.ok)
+            return { ok: false, error: `GitLab returned ${res.status}.` };
+        const project = (await res.json());
+        return { ok: true, login: project.path_with_namespace ?? creds.projectPath };
+    }
+    catch (err) {
+        return { ok: false, error: err?.message ?? 'Could not reach GitLab.' };
+    }
+}
+async function listRecentCommits(creds, branch) {
+    const host = creds.baseUrl ?? 'https://gitlab.com';
+    await (0, core_1.assertResolvesToPublicAddress)(host);
+    const { getSystemConfig } = await import('@taodigital/core');
+    const cfg = await getSystemConfig('connectors_gitlab');
+    const pageSize = parseInt(String(cfg?.pageSize ?? '10'), 10);
+    const ref = branch ?? creds.defaultBranch ?? 'main';
+    const base = apiBase(creds);
+    const res = await fetch(`${base}/projects/${encodeProject(creds.projectPath)}/repository/commits?ref_name=${encodeURIComponent(ref)}&per_page=${pageSize}`, { headers: authHeaders(creds.token), signal: AbortSignal.timeout(15_000) });
+    if (!res.ok)
+        throw new Error(`GitLab error: ${res.status}`);
+    const commits = (await res.json());
+    return commits.map((c) => ({
+        sha: c.id?.slice(0, 7),
+        message: c.title ?? c.message?.split('\n')[0],
+        author: c.author_name,
+        date: c.created_at,
+    }));
+}
+async function createIssue(creds, title, body, labels) {
+    const host = creds.baseUrl ?? 'https://gitlab.com';
+    await (0, core_1.assertResolvesToPublicAddress)(host);
+    const base = apiBase(creds);
+    const res = await fetch(`${base}/projects/${encodeProject(creds.projectPath)}/issues`, {
+        method: 'POST',
+        headers: authHeaders(creds.token),
+        body: JSON.stringify({ title, description: body, labels: labels?.join(',') }),
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!res.ok)
+        throw new Error(`GitLab error: ${res.status}`);
+    const issue = (await res.json());
+    return { number: issue.iid, url: issue.web_url, title: issue.title };
+}
+async function listMergeRequests(creds, state = 'opened') {
+    const host = creds.baseUrl ?? 'https://gitlab.com';
+    await (0, core_1.assertResolvesToPublicAddress)(host);
+    const { getSystemConfig } = await import('@taodigital/core');
+    const cfg = await getSystemConfig('connectors_gitlab');
+    const pageSize = parseInt(String(cfg?.pageSize ?? '10'), 10);
+    const base = apiBase(creds);
+    const res = await fetch(`${base}/projects/${encodeProject(creds.projectPath)}/merge_requests?state=${state}&per_page=${pageSize}`, { headers: authHeaders(creds.token), signal: AbortSignal.timeout(15_000) });
+    if (!res.ok)
+        throw new Error(`GitLab error: ${res.status}`);
+    const mrs = (await res.json());
+    return mrs.map((m) => ({
+        number: m.iid,
+        title: m.title,
+        state: m.state,
+        branch: m.source_branch,
+        url: m.web_url,
+    }));
+}
+/**
+ * Push (create or update) a single file in a GitLab repository.
+ * Uses the GitLab Repository Files API.
+ */
+async function pushFile(creds, filePath, content, commitMessage, branch) {
+    const host = creds.baseUrl ?? 'https://gitlab.com';
+    await (0, core_1.assertResolvesToPublicAddress)(host);
+    const targetBranch = branch ?? creds.defaultBranch ?? 'main';
+    const base = apiBase(creds);
+    const encodedProject = encodeProject(creds.projectPath);
+    const encodedPath = encodeURIComponent(filePath);
+    const encodedContent = Buffer.from(content, 'utf8').toString('base64');
+    // Check if file exists to decide between POST (create) and PUT (update)
+    const existing = await fetch(`${base}/projects/${encodedProject}/repository/files/${encodedPath}?ref=${encodeURIComponent(targetBranch)}`, { headers: authHeaders(creds.token), signal: AbortSignal.timeout(10_000) }).catch(() => null);
+    const fileExists = existing?.ok ?? false;
+    const method = fileExists ? 'PUT' : 'POST';
+    const res = await fetch(`${base}/projects/${encodedProject}/repository/files/${encodedPath}`, {
+        method,
+        headers: authHeaders(creds.token),
+        body: JSON.stringify({
+            branch: targetBranch,
+            content: encodedContent,
+            encoding: 'base64',
+            commit_message: commitMessage,
+        }),
+        signal: AbortSignal.timeout(20_000),
+    });
+    if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(`GitLab push failed: ${err.message ?? res.statusText}`);
+    }
+    const data = (await res.json());
+    const glBase = (creds.baseUrl ?? 'https://gitlab.com').replace(/\/$/, '');
+    return {
+        url: `${glBase}/${creds.projectPath}/-/blob/${targetBranch}/${filePath}`,
+        sha: data.file_path ?? filePath,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * as github from './github.js';
+export * as gitlab from './gitlab.js';
+export * as azuredevops from './azuredevops.js';
+export * as jira from './jira.js';
+export * as figma from './figma.js';
+export * as confluence from './confluence.js';
+export * as pagerduty from './pagerduty.js';
+export * as servicenow from './servicenow.js';
+export * as salesforce from './salesforce.js';

package/dist/index.js

@@ -0,0 +1,45 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.salesforce = exports.servicenow = exports.pagerduty = exports.confluence = exports.figma = exports.jira = exports.azuredevops = exports.gitlab = exports.github = void 0;
+exports.github = __importStar(require("./github.js"));
+exports.gitlab = __importStar(require("./gitlab.js"));
+exports.azuredevops = __importStar(require("./azuredevops.js"));
+exports.jira = __importStar(require("./jira.js"));
+exports.figma = __importStar(require("./figma.js"));
+exports.confluence = __importStar(require("./confluence.js"));
+exports.pagerduty = __importStar(require("./pagerduty.js"));
+exports.servicenow = __importStar(require("./servicenow.js"));
+exports.salesforce = __importStar(require("./salesforce.js"));

package/dist/jira.d.ts

@@ -0,0 +1,93 @@
+/**
+ * JIRA connector — credentials passed in, never read from env.
+ * baseUrl and email stored as-is; apiToken stored encrypted.
+ */
+export interface JiraCredentials {
+    baseUrl: string;
+    email: string;
+    apiToken: string;
+    password?: string;
+    projectKey?: string;
+    bearerToken?: string;
+    proxyUrl?: string;
+}
+export declare function testConnection(creds: JiraCredentials): Promise<{
+    ok: boolean;
+    displayName?: string;
+    error?: string;
+}>;
+export declare function listProjects(creds: JiraCredentials): Promise<{
+    key: any;
+    name: any;
+    id: any;
+}[]>;
+export declare function listRecentIssues(creds: JiraCredentials, maxResults?: number): Promise<any>;
+export interface GetIssueOptions {
+    acceptanceCriteriaFieldId?: string;
+}
+export declare function getIssue(creds: JiraCredentials, issueKey: string, options?: GetIssueOptions): Promise<{
+    key: any;
+    summary: any;
+    description: any;
+    status: any;
+    priority: any;
+    issueType: any;
+    acceptanceCriteria: any;
+    labels: any;
+    components: any;
+    epic: {
+        key: any;
+        summary: any;
+    } | null;
+    links: any;
+    subtasks: any;
+    url: string;
+}>;
+export declare function createBug(creds: JiraCredentials, opts: {
+    summary: string;
+    description: string;
+    priority?: 'Highest' | 'High' | 'Medium' | 'Low' | 'Lowest';
+    labels?: string[];
+    defaultBugPriority?: string;
+    defaultBugLabel?: string;
+}): Promise<{
+    key: any;
+    url: string;
+}>;
+export interface ListUserStoriesOptions {
+    acceptanceCriteriaFieldId?: string;
+}
+export declare function listUserStories(creds: JiraCredentials, sprintId?: string, maxResults?: number, options?: ListUserStoriesOptions): Promise<{
+    stories: {
+        key: any;
+        summary: any;
+        description: any;
+        acceptanceCriteria: any;
+        status: any;
+        priority: any;
+        issueType: any;
+        labels: any;
+        components: any;
+        epic: {
+            key: any;
+            summary: any;
+        } | null;
+        links: any;
+        subtasks: any;
+        url: string;
+    }[];
+    truncated: boolean;
+}>;
+export declare function createTestCase(creds: JiraCredentials, opts: {
+    summary: string;
+    stepsHtml: string;
+    priority?: 'Highest' | 'High' | 'Medium' | 'Low' | 'Lowest';
+    labels?: string[];
+    defaultIssueType?: string;
+    defaultTestCaseLabel?: string;
+}): Promise<{
+    key: string;
+    url: string;
+}>;
+/** Free-text search — finds issues that mention a screen URL or name. */
+export declare function searchIssues(creds: JiraCredentials, text: string, maxResults?: number): Promise<any>;