digital-tools 2.0.2 → 2.1.1

package/src/providers/development/github.js

@@ -0,0 +1,472 @@
+/**
+ * GitHub Development Provider
+ *
+ * Concrete implementation of DevelopmentProvider using GitHub REST API v3.
+ *
+ * @packageDocumentation
+ */
+import { defineProvider } from '../registry.js';
+const GITHUB_API_URL = 'https://api.github.com';
+/**
+ * GitHub provider info
+ */
+export const githubInfo = {
+    id: 'development.github',
+    name: 'GitHub',
+    description: 'GitHub development platform and version control service',
+    category: 'development',
+    website: 'https://github.com',
+    docsUrl: 'https://docs.github.com/rest',
+    requiredConfig: ['accessToken'],
+    optionalConfig: ['baseUrl'],
+};
+/**
+ * Create GitHub development provider
+ */
+export function createGitHubProvider(config) {
+    let accessToken;
+    let baseUrl;
+    return {
+        info: githubInfo,
+        async initialize(cfg) {
+            accessToken = cfg.accessToken;
+            baseUrl = cfg.baseUrl || GITHUB_API_URL;
+            if (!accessToken) {
+                throw new Error('GitHub access token is required');
+            }
+        },
+        async healthCheck() {
+            const start = Date.now();
+            try {
+                const response = await fetch(`${baseUrl}/user`, {
+                    headers: {
+                        Authorization: `Bearer ${accessToken}`,
+                        Accept: 'application/vnd.github.v3+json',
+                    },
+                });
+                return {
+                    healthy: response.ok,
+                    latencyMs: Date.now() - start,
+                    message: response.ok ? 'Connected' : `HTTP ${response.status}`,
+                    checkedAt: new Date(),
+                };
+            }
+            catch (error) {
+                return {
+                    healthy: false,
+                    latencyMs: Date.now() - start,
+                    message: error instanceof Error ? error.message : 'Unknown error',
+                    checkedAt: new Date(),
+                };
+            }
+        },
+        async dispose() {
+            // No cleanup needed
+        },
+        async listRepos(options) {
+            const params = new URLSearchParams();
+            if (options?.visibility) {
+                params.append('visibility', options.visibility);
+            }
+            if (options?.sort) {
+                params.append('sort', options.sort);
+            }
+            if (options?.limit) {
+                params.append('per_page', String(options.limit));
+            }
+            if (options?.cursor) {
+                params.append('page', options.cursor);
+            }
+            const response = await fetch(`${baseUrl}/user/repos?${params.toString()}`, {
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                    Accept: 'application/vnd.github.v3+json',
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            const repos = data.map((repo) => ({
+                id: String(repo.id),
+                owner: repo.owner.login,
+                name: repo.name,
+                fullName: repo.full_name,
+                description: repo.description,
+                private: repo.private,
+                defaultBranch: repo.default_branch,
+                url: repo.html_url,
+                cloneUrl: repo.clone_url,
+                stars: repo.stargazers_count,
+                forks: repo.forks_count,
+                openIssues: repo.open_issues_count,
+                createdAt: new Date(repo.created_at),
+                updatedAt: new Date(repo.updated_at),
+            }));
+            const linkHeader = response.headers.get('Link');
+            const hasMore = linkHeader ? linkHeader.includes('rel="next"') : false;
+            const nextCursor = hasMore ? String(Number(options?.cursor || '1') + 1) : undefined;
+            return {
+                items: repos,
+                hasMore,
+                nextCursor,
+                total: undefined,
+            };
+        },
+        async getRepo(owner, repo) {
+            const response = await fetch(`${baseUrl}/repos/${owner}/${repo}`, {
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                    Accept: 'application/vnd.github.v3+json',
+                },
+            });
+            if (response.status === 404) {
+                return null;
+            }
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            return {
+                id: String(data.id),
+                owner: data.owner.login,
+                name: data.name,
+                fullName: data.full_name,
+                description: data.description,
+                private: data.private,
+                defaultBranch: data.default_branch,
+                url: data.html_url,
+                cloneUrl: data.clone_url,
+                stars: data.stargazers_count,
+                forks: data.forks_count,
+                openIssues: data.open_issues_count,
+                createdAt: new Date(data.created_at),
+                updatedAt: new Date(data.updated_at),
+            };
+        },
+        async createIssue(owner, repo, issue) {
+            const body = {
+                title: issue.title,
+                body: issue.body,
+                labels: issue.labels,
+                assignees: issue.assignees,
+                milestone: issue.milestone,
+            };
+            const response = await fetch(`${baseUrl}/repos/${owner}/${repo}/issues`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                    Accept: 'application/vnd.github.v3+json',
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            return {
+                id: String(data.id),
+                number: data.number,
+                title: data.title,
+                body: data.body,
+                state: data.state,
+                labels: data.labels.map((l) => l.name),
+                assignees: data.assignees.map((a) => a.login),
+                authorId: data.user.login,
+                url: data.html_url,
+                createdAt: new Date(data.created_at),
+                updatedAt: new Date(data.updated_at),
+                closedAt: data.closed_at ? new Date(data.closed_at) : undefined,
+            };
+        },
+        async getIssue(owner, repo, issueNumber) {
+            const response = await fetch(`${baseUrl}/repos/${owner}/${repo}/issues/${issueNumber}`, {
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                    Accept: 'application/vnd.github.v3+json',
+                },
+            });
+            if (response.status === 404) {
+                return null;
+            }
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            return {
+                id: String(data.id),
+                number: data.number,
+                title: data.title,
+                body: data.body,
+                state: data.state,
+                labels: data.labels.map((l) => l.name),
+                assignees: data.assignees.map((a) => a.login),
+                authorId: data.user.login,
+                url: data.html_url,
+                createdAt: new Date(data.created_at),
+                updatedAt: new Date(data.updated_at),
+                closedAt: data.closed_at ? new Date(data.closed_at) : undefined,
+            };
+        },
+        async updateIssue(owner, repo, issueNumber, updates) {
+            const body = {};
+            if (updates.title !== undefined)
+                body.title = updates.title;
+            if (updates.body !== undefined)
+                body.body = updates.body;
+            if (updates.labels !== undefined)
+                body.labels = updates.labels;
+            if (updates.assignees !== undefined)
+                body.assignees = updates.assignees;
+            if (updates.milestone !== undefined)
+                body.milestone = updates.milestone;
+            const response = await fetch(`${baseUrl}/repos/${owner}/${repo}/issues/${issueNumber}`, {
+                method: 'PATCH',
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                    Accept: 'application/vnd.github.v3+json',
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            return {
+                id: String(data.id),
+                number: data.number,
+                title: data.title,
+                body: data.body,
+                state: data.state,
+                labels: data.labels.map((l) => l.name),
+                assignees: data.assignees.map((a) => a.login),
+                authorId: data.user.login,
+                url: data.html_url,
+                createdAt: new Date(data.created_at),
+                updatedAt: new Date(data.updated_at),
+                closedAt: data.closed_at ? new Date(data.closed_at) : undefined,
+            };
+        },
+        async listIssues(owner, repo, options) {
+            const params = new URLSearchParams();
+            if (options?.state) {
+                params.append('state', options.state);
+            }
+            if (options?.labels?.length) {
+                params.append('labels', options.labels.join(','));
+            }
+            if (options?.assignee) {
+                params.append('assignee', options.assignee);
+            }
+            if (options?.sort) {
+                params.append('sort', options.sort);
+            }
+            if (options?.limit) {
+                params.append('per_page', String(options.limit));
+            }
+            if (options?.cursor) {
+                params.append('page', options.cursor);
+            }
+            const response = await fetch(`${baseUrl}/repos/${owner}/${repo}/issues?${params.toString()}`, {
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                    Accept: 'application/vnd.github.v3+json',
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            const issues = data
+                .filter((item) => !item.pull_request) // Filter out PRs
+                .map((issue) => ({
+                id: String(issue.id),
+                number: issue.number,
+                title: issue.title,
+                body: issue.body,
+                state: issue.state,
+                labels: issue.labels.map((l) => l.name),
+                assignees: issue.assignees.map((a) => a.login),
+                authorId: issue.user.login,
+                url: issue.html_url,
+                createdAt: new Date(issue.created_at),
+                updatedAt: new Date(issue.updated_at),
+                closedAt: issue.closed_at ? new Date(issue.closed_at) : undefined,
+            }));
+            const linkHeader = response.headers.get('Link');
+            const hasMore = linkHeader ? linkHeader.includes('rel="next"') : false;
+            const nextCursor = hasMore ? String(Number(options?.cursor || '1') + 1) : undefined;
+            return {
+                items: issues,
+                hasMore,
+                nextCursor,
+                total: undefined,
+            };
+        },
+        async createPullRequest(owner, repo, pr) {
+            const body = {
+                title: pr.title,
+                body: pr.body,
+                head: pr.head,
+                base: pr.base,
+                draft: pr.draft,
+            };
+            const response = await fetch(`${baseUrl}/repos/${owner}/${repo}/pulls`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                    Accept: 'application/vnd.github.v3+json',
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            return {
+                id: String(data.id),
+                number: data.number,
+                title: data.title,
+                body: data.body,
+                state: data.merged_at ? 'merged' : data.state,
+                head: data.head.ref,
+                base: data.base.ref,
+                authorId: data.user.login,
+                draft: data.draft,
+                mergeable: data.mergeable,
+                url: data.html_url,
+                createdAt: new Date(data.created_at),
+                updatedAt: new Date(data.updated_at),
+                mergedAt: data.merged_at ? new Date(data.merged_at) : undefined,
+                closedAt: data.closed_at ? new Date(data.closed_at) : undefined,
+            };
+        },
+        async getPullRequest(owner, repo, prNumber) {
+            const response = await fetch(`${baseUrl}/repos/${owner}/${repo}/pulls/${prNumber}`, {
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                    Accept: 'application/vnd.github.v3+json',
+                },
+            });
+            if (response.status === 404) {
+                return null;
+            }
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            return {
+                id: String(data.id),
+                number: data.number,
+                title: data.title,
+                body: data.body,
+                state: data.merged_at ? 'merged' : data.state,
+                head: data.head.ref,
+                base: data.base.ref,
+                authorId: data.user.login,
+                draft: data.draft,
+                mergeable: data.mergeable,
+                url: data.html_url,
+                createdAt: new Date(data.created_at),
+                updatedAt: new Date(data.updated_at),
+                mergedAt: data.merged_at ? new Date(data.merged_at) : undefined,
+                closedAt: data.closed_at ? new Date(data.closed_at) : undefined,
+            };
+        },
+        async listPullRequests(owner, repo, options) {
+            const params = new URLSearchParams();
+            if (options?.state) {
+                params.append('state', options.state);
+            }
+            if (options?.sort) {
+                params.append('sort', options.sort);
+            }
+            if (options?.direction) {
+                params.append('direction', options.direction);
+            }
+            if (options?.limit) {
+                params.append('per_page', String(options.limit));
+            }
+            if (options?.cursor) {
+                params.append('page', options.cursor);
+            }
+            const response = await fetch(`${baseUrl}/repos/${owner}/${repo}/pulls?${params.toString()}`, {
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                    Accept: 'application/vnd.github.v3+json',
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            const prs = data.map((pr) => ({
+                id: String(pr.id),
+                number: pr.number,
+                title: pr.title,
+                body: pr.body,
+                state: pr.merged_at ? 'merged' : pr.state,
+                head: pr.head.ref,
+                base: pr.base.ref,
+                authorId: pr.user.login,
+                draft: pr.draft,
+                mergeable: pr.mergeable,
+                url: pr.html_url,
+                createdAt: new Date(pr.created_at),
+                updatedAt: new Date(pr.updated_at),
+                mergedAt: pr.merged_at ? new Date(pr.merged_at) : undefined,
+                closedAt: pr.closed_at ? new Date(pr.closed_at) : undefined,
+            }));
+            const linkHeader = response.headers.get('Link');
+            const hasMore = linkHeader ? linkHeader.includes('rel="next"') : false;
+            const nextCursor = hasMore ? String(Number(options?.cursor || '1') + 1) : undefined;
+            return {
+                items: prs,
+                hasMore,
+                nextCursor,
+                total: undefined,
+            };
+        },
+        async mergePullRequest(owner, repo, prNumber) {
+            const response = await fetch(`${baseUrl}/repos/${owner}/${repo}/pulls/${prNumber}/merge`, {
+                method: 'PUT',
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                    Accept: 'application/vnd.github.v3+json',
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({}),
+            });
+            return response.ok;
+        },
+        async addComment(owner, repo, issueNumber, body) {
+            const response = await fetch(`${baseUrl}/repos/${owner}/${repo}/issues/${issueNumber}/comments`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                    Accept: 'application/vnd.github.v3+json',
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ body }),
+            });
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            return {
+                id: String(data.id),
+                body: data.body,
+                authorId: data.user.login,
+                createdAt: new Date(data.created_at),
+                updatedAt: new Date(data.updated_at),
+            };
+        },
+    };
+}
+/**
+ * GitHub provider definition
+ */
+export const githubProvider = defineProvider(githubInfo, async (config) => createGitHubProvider(config));

package/src/providers/development/index.js

@@ -0,0 +1,17 @@
+/**
+ * Development Providers
+ *
+ * @packageDocumentation
+ */
+export { githubInfo, githubProvider, createGitHubProvider } from './github.js';
+import { githubProvider } from './github.js';
+/**
+ * Register all development providers
+ */
+export function registerDevelopmentProviders() {
+    githubProvider.register();
+}
+/**
+ * All development providers
+ */
+export const developmentProviders = [githubProvider];

package/src/providers/ecommerce/index.js

@@ -0,0 +1,17 @@
+/**
+ * E-commerce Providers
+ *
+ * @packageDocumentation
+ */
+export { shopifyInfo, shopifyProvider, createShopifyProvider } from './shopify.js';
+import { shopifyProvider } from './shopify.js';
+/**
+ * Register all e-commerce providers
+ */
+export function registerEcommerceProviders() {
+    shopifyProvider.register();
+}
+/**
+ * All e-commerce providers
+ */
+export const ecommerceProviders = [shopifyProvider];