hale-commenting-system 2.0.2 → 2.0.4

package/dist/cli/onboarding.js

@@ -0,0 +1,170 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runOnboarding = runOnboarding;
+const inquirer_1 = __importDefault(require("inquirer"));
+const validators = __importStar(require("./validators"));
+const generators = __importStar(require("./generators"));
+async function runOnboarding() {
+    console.log('Welcome to Hale Commenting System!');
+    console.log('This setup will guide you through connecting GitHub and Jira.\n');
+    // Step 1: GitHub OAuth Setup
+    console.log('📦 Step 1: GitHub OAuth Setup\n');
+    console.log('You\'ll need to create a GitHub OAuth App if you haven\'t already.');
+    console.log('Visit: https://github.com/settings/developers\n');
+    const githubAnswers = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'clientId',
+            message: 'GitHub OAuth Client ID:',
+            validate: (input) => {
+                if (!input.trim())
+                    return 'Client ID is required';
+                return true;
+            }
+        },
+        {
+            type: 'password',
+            name: 'clientSecret',
+            message: 'GitHub OAuth Client Secret:',
+            validate: (input) => {
+                if (!input.trim())
+                    return 'Client Secret is required';
+                return true;
+            }
+        },
+        {
+            type: 'input',
+            name: 'owner',
+            message: 'GitHub Owner (username or org):',
+            validate: (input) => {
+                if (!input.trim())
+                    return 'Owner is required';
+                return true;
+            }
+        },
+        {
+            type: 'input',
+            name: 'repo',
+            message: 'GitHub Repository name:',
+            validate: (input) => {
+                if (!input.trim())
+                    return 'Repository name is required';
+                return true;
+            }
+        }
+    ]);
+    // Validate GitHub credentials
+    console.log('\n🔍 Validating GitHub credentials...');
+    const githubValid = await validators.validateGitHubCredentials(githubAnswers.clientId, githubAnswers.clientSecret, githubAnswers.owner, githubAnswers.repo);
+    if (!githubValid) {
+        console.error('❌ GitHub validation failed. Please check your credentials and try again.');
+        process.exit(1);
+    }
+    console.log('✅ GitHub credentials validated!\n');
+    // Step 2: Jira Setup
+    console.log('🎫 Step 2: Jira Setup\n');
+    console.log('For Red Hat Jira, generate a Personal Access Token from:');
+    console.log('https://issues.redhat.com/secure/ViewProfile.jspa\n');
+    const jiraAnswers = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'baseUrl',
+            message: 'Jira Base URL:',
+            default: 'https://issues.redhat.com',
+            validate: (input) => {
+                if (!input.trim())
+                    return 'Base URL is required';
+                try {
+                    new URL(input);
+                    return true;
+                }
+                catch {
+                    return 'Please enter a valid URL';
+                }
+            }
+        },
+        {
+            type: 'input',
+            name: 'email',
+            message: 'Jira Email (optional, leave blank if using Bearer token):',
+            default: ''
+        },
+        {
+            type: 'password',
+            name: 'apiToken',
+            message: 'Jira API Token:',
+            validate: (input) => {
+                if (!input.trim())
+                    return 'API Token is required';
+                return true;
+            }
+        }
+    ]);
+    // Validate Jira credentials
+    console.log('\n🔍 Validating Jira credentials...');
+    const jiraValid = await validators.validateJiraCredentials(jiraAnswers.baseUrl, jiraAnswers.apiToken, jiraAnswers.email || undefined);
+    if (!jiraValid) {
+        console.error('❌ Jira validation failed. Please check your credentials and try again.');
+        process.exit(1);
+    }
+    console.log('✅ Jira credentials validated!\n');
+    // Step 3: Generate files
+    console.log('📝 Step 3: Generating configuration files...\n');
+    await generators.generateFiles({
+        github: {
+            clientId: githubAnswers.clientId,
+            clientSecret: githubAnswers.clientSecret,
+            owner: githubAnswers.owner,
+            repo: githubAnswers.repo
+        },
+        jira: {
+            baseUrl: jiraAnswers.baseUrl,
+            apiToken: jiraAnswers.apiToken,
+            email: jiraAnswers.email || undefined
+        }
+    });
+    // Step 4: Integrate into project
+    console.log('🔧 Step 4: Integrating into PatternFly Seed project...\n');
+    await generators.integrateIntoProject();
+    console.log('\n✅ Setup complete!');
+    console.log('\nNext steps:');
+    console.log('1. Review the generated .env and .env.server files');
+    console.log('2. Restart your dev server: npm run start:dev');
+    console.log('3. The commenting system will be available in your app!\n');
+}

package/dist/cli/postinstall.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/postinstall.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+"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 });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const detect = __importStar(require("./detect"));
+const onboarding = __importStar(require("./onboarding"));
+async function main() {
+    const cwd = process.cwd();
+    const envPath = path.join(cwd, '.env');
+    // Check if already configured (has GitHub client ID in .env)
+    if (fs.existsSync(envPath)) {
+        const envContent = fs.readFileSync(envPath, 'utf-8');
+        if (envContent.includes('VITE_GITHUB_CLIENT_ID')) {
+            // Already configured, skip onboarding
+            return;
+        }
+    }
+    // Check if we're in a PatternFly Seed project
+    const isPFSeed = detect.detectPatternFlySeed();
+    if (!isPFSeed) {
+        // Not a PF Seed project, skip silently (might be installing in a different context)
+        return;
+    }
+    // Run onboarding
+    console.log('🚀 Hale Commenting System - First-time setup\n');
+    await onboarding.runOnboarding();
+}
+main().catch((error) => {
+    // Don't fail the install if onboarding has issues
+    console.error('⚠️  Onboarding error (non-fatal):', error.message);
+});

package/dist/cli/validators.d.ts

@@ -0,0 +1,2 @@
+export declare function validateGitHubCredentials(clientId: string, clientSecret: string, owner: string, repo: string): Promise<boolean>;
+export declare function validateJiraCredentials(baseUrl: string, apiToken: string, email?: string): Promise<boolean>;

package/dist/cli/validators.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateGitHubCredentials = validateGitHubCredentials;
+exports.validateJiraCredentials = validateJiraCredentials;
+const node_fetch_1 = __importDefault(require("node-fetch"));
+async function validateGitHubCredentials(clientId, clientSecret, owner, repo) {
+    try {
+        // Test OAuth app credentials by attempting token exchange (we'll use a dummy code)
+        // Actually, we can't test OAuth without a real callback, so we'll just check repo access
+        // For a real validation, we'd need the user to complete OAuth flow, but for onboarding
+        // we'll just verify the repo exists and is accessible
+        const repoUrl = `https://api.github.com/repos/${owner}/${repo}`;
+        const response = await (0, node_fetch_1.default)(repoUrl, {
+            headers: {
+                'Accept': 'application/vnd.github+json',
+                'User-Agent': 'hale-commenting-system'
+            }
+        });
+        if (response.ok) {
+            return true;
+        }
+        if (response.status === 404) {
+            console.error(`   Repository ${owner}/${repo} not found or not accessible`);
+            return false;
+        }
+        console.error(`   GitHub API error: ${response.status}`);
+        return false;
+    }
+    catch (error) {
+        console.error(`   Error validating GitHub: ${error.message}`);
+        return false;
+    }
+}
+async function validateJiraCredentials(baseUrl, apiToken, email) {
+    try {
+        const url = `${baseUrl.replace(/\/+$/, '')}/rest/api/2/myself`;
+        const authHeader = email
+            ? `Basic ${Buffer.from(`${email}:${apiToken}`).toString('base64')}`
+            : `Bearer ${apiToken}`;
+        const response = await (0, node_fetch_1.default)(url, {
+            headers: {
+                'Accept': 'application/json',
+                'Authorization': authHeader,
+                'User-Agent': 'hale-commenting-system'
+            }
+        });
+        if (response.ok) {
+            const data = await response.json();
+            console.log(`   ✅ Authenticated as: ${data.displayName || data.name || 'User'}`);
+            return true;
+        }
+        if (response.status === 401 || response.status === 403) {
+            console.error(`   Authentication failed. Check your token and email (if required).`);
+            return false;
+        }
+        console.error(`   Jira API error: ${response.status}`);
+        return false;
+    }
+    catch (error) {
+        console.error(`   Error validating Jira: ${error.message}`);
+        return false;
+    }
+}

package/dist/components/CommentOverlay.d.ts

@@ -0,0 +1,2 @@
+import * as React from 'react';
+export declare const CommentOverlay: React.FunctionComponent;

package/dist/components/CommentOverlay.js

@@ -0,0 +1,101 @@
+"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.CommentOverlay = void 0;
+const React = __importStar(require("react"));
+const react_router_dom_1 = require("react-router-dom");
+const CommentContext_1 = require("../contexts/CommentContext");
+const CommentPin_1 = require("./CommentPin");
+const version_1 = require("../utils/version");
+const CommentOverlay = () => {
+    const location = (0, react_router_dom_1.useLocation)();
+    const { commentsEnabled, addThread, selectedThreadId, setSelectedThreadId, syncFromGitHub, getThreadsForRoute } = (0, CommentContext_1.useComments)();
+    const detectedVersion = (0, version_1.getVersionFromPathOrQuery)(location.pathname, location.search);
+    const overlayRef = React.useRef(null);
+    // Show both open and closed threads as pins (GitHub-style: closed issues still exist)
+    const currentThreads = getThreadsForRoute(location.pathname, detectedVersion);
+    const handlePageClick = (e) => {
+        if (!commentsEnabled)
+            return;
+        // Check if clicking on a pin or any interactive element
+        const target = e.target;
+        if (target.closest('button') ||
+            target.closest('a') ||
+            target.closest('input') ||
+            target.closest('select') ||
+            target.closest('textarea') ||
+            target.closest('[role="button"]') ||
+            target.closest('[data-comment-controls]') ||
+            target.closest('[data-comment-pin]')) {
+            return; // Don't create pin if clicking interactive elements
+        }
+        // Get the overlay container dimensions (accounts for drawer being open)
+        if (!overlayRef.current)
+            return;
+        const rect = overlayRef.current.getBoundingClientRect();
+        // Calculate percentage based on the content area, not the full window
+        const xPercent = ((e.clientX - rect.left) / rect.width) * 100;
+        const yPercent = ((e.clientY - rect.top) / rect.height) * 100;
+        const threadId = addThread(xPercent, yPercent, location.pathname, detectedVersion);
+        setSelectedThreadId(threadId);
+    };
+    React.useEffect(() => {
+        console.log('🔄 CommentOverlay useEffect triggered', { commentsEnabled, pathname: location.pathname, detectedVersion });
+        if (commentsEnabled) {
+            document.addEventListener('click', handlePageClick);
+            // Pull latest changes from GitHub when entering comment mode or switching routes
+            console.log('🔄 CommentOverlay calling syncFromGitHub...');
+            syncFromGitHub(location.pathname, detectedVersion).catch(() => undefined);
+        }
+        return () => {
+            document.removeEventListener('click', handlePageClick);
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [commentsEnabled, location.pathname, detectedVersion]);
+    // Only show pins when commenting is enabled
+    if (!commentsEnabled) {
+        return null;
+    }
+    return (React.createElement("div", { ref: overlayRef, style: {
+            position: 'absolute',
+            top: 0,
+            left: 0,
+            width: '100%',
+            height: '100%',
+            pointerEvents: 'none',
+            zIndex: 999,
+        } }, currentThreads.map((thread) => (React.createElement(CommentPin_1.CommentPin, { key: thread.id, xPercent: thread.xPercent, yPercent: thread.yPercent, commentCount: thread.comments.length, isClosed: thread.status === 'closed', isSelected: selectedThreadId === thread.id, onClick: () => setSelectedThreadId(thread.id) })))));
+};
+exports.CommentOverlay = CommentOverlay;

package/dist/components/CommentPanel.d.ts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+interface CommentPanelProps {
+    children: React.ReactNode;
+}
+export declare const CommentPanel: React.FunctionComponent<CommentPanelProps>;
+export {};