npm - @kosmas10/portal - Versions diffs - 0.0.2 - Mend

@kosmas10/portal 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,22 @@
+MIT License
+Copyright (c) 2025 Kosmas Karadimitriou
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,164 @@
+# Portal
+**Version:** 0.0.1
+**Package:** `@kosmas10/portal`
+A launcher portal for AI Chat Extensions applications. Provides a unified entry point to access Chat & Verify, Folder LLM Analyzer, and other AI-powered tools.
+## 🎯 Key Features
+- **🚀 Unified Launcher**: Single entry point for all AI Chat Extensions apps
+- **📱 Responsive Design**: Works on desktop and mobile devices
+- **⚡ Fast Loading**: 3-stage architecture for reliable, efficient loading
+- **🔄 Auto-Updates**: Always loads the latest version of apps
+- **💻 No Installation Required**: Single HTML file that runs in any modern browser
+## 🏗️ Architecture: 3-Stage Loading System
+This application uses an innovative **3-stage loading architecture** designed for maximum reliability and flexibility:
+### Stage 1: Bootstrap (User Installs This)
+- **File**: `portal-bootstrap.html`
+- **Purpose**: Ultra-minimal loader that NEVER changes
+- **Size**: ~2KB
+- **What it does**: Loads Stage 2 from npm/CDN
+### Stage 2: Loader (Auto-Updates)
+- **Package**: `@kosmas10/html-app-loader`
+- **Purpose**: Sophisticated HTML app loader
+- **What it does**: Handles complex loading logic, can be updated via npm
+### Stage 3: Application (Auto-Updates)
+- **Package**: `@kosmas10/portal` (this package)
+- **Purpose**: The actual Portal application
+- **What it does**: Provides the launcher interface
+### Why This Architecture?
+1. **🛡️ Future-Proof**: Stage 1 never changes, so users never need to update their local file
+2. **🔄 Auto-Updates**: Stages 2 & 3 update automatically via npm/CDN
+3. **🐛 Bug Fixes**: Loader bugs can be fixed without user intervention
+4. **📦 Flexible**: Can adapt to new requirements without breaking existing installations
+## 🚀 Quick Start
+### Option A: Using the Bootstrap (Recommended)
+1. **Download the bootstrap file** (one time only):
+   ```bash
+   curl -O https://cdn.jsdelivr.net/npm/@kosmas10/portal@latest/portal-bootstrap.html
+   ```
+2. **Open it in your browser**:
+   - Double-click the file, or
+   - Open it from your browser's File menu
+3. **That's it!** The application will load automatically and stay up-to-date.
+### Option B: Direct CDN Link
+Simply navigate to:
+```
+https://cdn.jsdelivr.net/npm/@kosmas10/portal@latest/portal-bootstrap.html
+```
+### Option C: Load Specific Version
+Use URL parameters to control versions:
+```
+https://cdn.jsdelivr.net/npm/@kosmas10/portal@latest/portal-bootstrap.html?appVersion=0.0.1
+```
+## 📖 Available Applications
+The Portal provides access to:
+### Chat & Verify
+A chatbot with citations and highlights in source documents for easy verification of answers. Supports PDF and Word documents.
+### Folder LLM Analyzer
+Analyze entire folders of files using Large Language Models. Upload a folder, ask questions, and get AI-powered insights.
+## 🔧 Advanced Configuration
+### URL Parameters
+Control the loading behavior with URL parameters:
+```
+?loader=@kosmas10/html-app-loader          # Use different Stage 2 loader
+?loaderVersion=1.0.0                        # Pin Stage 2 version
+?app=@kosmas10/portal                       # Load different app
+?appVersion=0.0.1                           # Pin app version
+?appFile=portal.html                        # Load specific file
+```
+### Example: Pin All Versions
+```
+portal-bootstrap.html?loaderVersion=1.0.0&appVersion=0.0.1
+```
+## 📦 Package Structure
+```
+@kosmas10/portal/
+├── portal.html              # Main application (Stage 3)
+├── portal-bootstrap.html    # Bootstrap loader (Stage 1)
+├── README.md                # This file
+└── LICENSE                  # MIT License
+```
+## 🌐 Browser Compatibility
+- ✅ Chrome/Chromium 90+
+- ✅ Firefox 88+
+- ✅ Safari 14+
+- ✅ Edge 90+
+## 🔒 Privacy & Security
+- **No Tracking**: No analytics or tracking code
+- **Open Source**: Full source code available for inspection
+- **Local Storage**: Any settings stored locally in browser
+## 🐛 Troubleshooting
+### Application Won't Load
+1. Check your internet connection
+2. Ensure cdn.jsdelivr.net is accessible (not blocked by firewall)
+3. Try clearing browser cache
+4. Check browser console for errors (F12)
+## 📝 Version History
+### 0.0.1 (Current)
+- Initial release
+- Launcher interface for AI Chat Extensions apps
+- 3-stage loading architecture
+## 🤝 Contributing
+Contributions are welcome! Please visit:
+https://github.com/kosmas10/ai-chat-extensions
+## 📄 License
+MIT License - See LICENSE file for details
+## 🆘 Support
+For issues, questions, or feature requests:
+- **GitHub Issues**: https://github.com/kosmas10/ai-chat-extensions/issues
+- **Package**: https://www.npmjs.com/package/@kosmas10/portal
+## 🔗 Related Packages
+- **Stage 2 Loader**: [@kosmas10/html-app-loader](https://www.npmjs.com/package/@kosmas10/html-app-loader)
+- **Chat & Verify**: [@kosmas10/chat-and-verify](https://www.npmjs.com/package/@kosmas10/chat-and-verify)
+- **Folder LLM Analyzer**: [@kosmas10/folder-llm-analyzer](https://www.npmjs.com/package/@kosmas10/folder-llm-analyzer)
+---
+**Made with ❤️ as a unified gateway to AI-powered tools**

package/package.json ADDED Viewed

@@ -0,0 +1,48 @@
+{
+  "name": "@kosmas10/portal",
+  "version": "0.0.2",
+  "description": "A launcher portal for AI Chat Extensions applications. Provides a unified entry point to access Chat & Verify, Folder LLM Analyzer, and other AI-powered tools. Part of a 3-stage loading architecture for maximum reliability.",
+  "main": "portal.html",
+  "files": [
+    "portal.html",
+    "portal-bootstrap.html",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "echo \"No tests specified\" && exit 0",
+    "purge-cdn": "bash purge-cdn.sh"
+  },
+  "keywords": [
+    "portal",
+    "launcher",
+    "ai",
+    "llm",
+    "claude",
+    "openai",
+    "gpt",
+    "chat",
+    "document-analysis",
+    "folder-analyzer",
+    "claude-artifacts",
+    "ai-tools"
+  ],
+  "author": "Kosmas Karadimitriou",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kosmas10/ai-chat-extensions.git",
+    "directory": "portal"
+  },
+  "bugs": {
+    "url": "https://github.com/kosmas10/ai-chat-extensions/issues"
+  },
+  "homepage": "https://github.com/kosmas10/ai-chat-extensions/tree/main/portal#readme",
+  "engines": {
+    "node": ">=12.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/portal-bootstrap.html ADDED Viewed

@@ -0,0 +1,67 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Loading...</title>
+</head>
+<body>
+    <script>
+        /**
+         * Portal Bootstrap Loader
+         * Copyright (c) 2025 Nova Science Ventures LLC
+         * Created by Kosmas Karadimitriou
+         *
+         * Licensed under the MIT License
+         * GitHub: https://github.com/kosmas10/ai-chat-extensions
+         */
+        // ============================================================================
+        // STAGE 1 BOOTSTRAP - IMMUTABLE
+        // ============================================================================
+        // This file should NEVER be modified after deployment.
+        // Always uses @latest to automatically get loader updates.
+        // Only change: the app package name (@kosmas10/portal)
+        // ============================================================================
+        (function() {
+            var script = document.createElement('script');
+            // Add timestamp to force cache refresh (helps with CDN caching issues)
+            script.src = 'https://cdn.jsdelivr.net/npm/@kosmas10/html-app-loader@latest/loader.js?app=@kosmas10/portal&_=' + Date.now();
+            script.onerror = function() {
+                document.body.innerHTML =
+                    '<!DOCTYPE html>' +
+                    '<html><head><meta charset="UTF-8"><style>' +
+                    'body{margin:0;padding:40px;font-family:system-ui,sans-serif;line-height:1.6}' +
+                    '.error{max-width:600px;margin:0 auto;padding:30px;background:#fee;border:2px solid #c33;border-radius:8px}' +
+                    'h1{color:#c33;margin-top:0}' +
+                    'code{background:#f5f5f5;padding:2px 6px;border-radius:3px;font-size:0.9em}' +
+                    'ul{margin:15px 0}li{margin:8px 0}' +
+                    '</style></head><body>' +
+                    '<div class="error">' +
+                    '<h1>Failed to Load Application</h1>' +
+                    '<p>The application loader could not be loaded from:</p>' +
+                    '<p><code>' + script.src + '</code></p>' +
+                    '<p><strong>Possible causes:</strong></p>' +
+                    '<ul>' +
+                    '<li>No internet connection</li>' +
+                    '<li>CDN (cdn.jsdelivr.net) is blocked by firewall or proxy</li>' +
+                    '<li>NPM registry is inaccessible</li>' +
+                    '<li>Corporate network restrictions</li>' +
+                    '<li>Browser extensions blocking the request</li>' +
+                    '</ul>' +
+                    '<p><strong>What to try:</strong></p>' +
+                    '<ul>' +
+                    '<li>Check your internet connection</li>' +
+                    '<li>Try accessing <a href="https://cdn.jsdelivr.net" target="_blank">cdn.jsdelivr.net</a> directly</li>' +
+                    '<li>Disable VPN or proxy temporarily</li>' +
+                    '<li>Check firewall settings</li>' +
+                    '<li>Try a different network</li>' +
+                    '<li>Contact your IT department if on a corporate network</li>' +
+                    '</ul>' +
+                    '</div></body></html>';
+            };
+            document.head.appendChild(script);
+        })();
+    </script>
+</body>
+</html>

package/portal.html ADDED Viewed

@@ -0,0 +1,411 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>AI Chat Extensions</title>
+    <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><rect x='0' y='0' width='50' height='50' fill='%236ee7b7'/><rect x='50' y='0' width='50' height='50' fill='%23fbbf24'/><rect x='0' y='50' width='50' height='50' fill='%23764ba2'/><rect x='50' y='50' width='50' height='50' fill='%23ffffff'/></svg>">
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+        body {
+            font-family: ui-serif, Georgia, Cambria, "Times New Roman", Times, serif;
+            background: linear-gradient(135deg, #d4c4a8 0%, #c4b5a0 100%);
+            min-height: 100vh;
+            display: flex;
+            align-items: flex-start;
+            justify-content: center;
+            padding: 60px 20px 20px 20px;
+            overflow-x: hidden;
+        }
+        .container {
+            background: rgba(255, 255, 255, 0.95);
+            backdrop-filter: blur(10px);
+            border-radius: 20px;
+            padding: 40px 70px 70px 70px;
+            box-shadow: 0 20px 40px rgba(0, 0, 0, 0.1);
+            max-width: 871px;
+            width: 100%;
+            text-align: center;
+            box-sizing: border-box;
+        }
+        .version {
+            position: absolute;
+            top: 5px;
+            right: 10px;
+            font-size: 0.7rem;
+            opacity: 0.5;
+            color: #6b7280;
+            font-family: Arial, Helvetica, sans-serif;
+            z-index: 1000;
+        }
+        .header {
+            margin-bottom: 40px;
+        }
+        .header h1 {
+            color: #333;
+            font-size: 2.5rem;
+            margin-bottom: 10px;
+            font-family: ui-serif, Georgia, Cambria, "Times New Roman", Times, serif;
+            background: linear-gradient(135deg, #000000, #333333);
+            -webkit-background-clip: text;
+            -webkit-text-fill-color: transparent;
+            background-clip: text;
+        }
+        .header p {
+            color: #666;
+            font-size: 1.1rem;
+            line-height: 1.6;
+        }
+        .apps-grid {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(305px, 1fr));
+            gap: 30px;
+            margin-top: 40px;
+            width: 100%;
+        }
+        .app-card {
+            background: white;
+            border-radius: 15px;
+            padding: 30px;
+            box-shadow: 0 10px 30px rgba(0, 0, 0, 0.1);
+            transition: all 0.3s ease;
+            border: 2px solid transparent;
+            position: relative;
+            overflow: hidden;
+            box-sizing: border-box;
+            width: 100%;
+        }
+        .app-card::before {
+            content: '';
+            position: absolute;
+            top: 0;
+            left: 0;
+            right: 0;
+            height: 4px;
+            background: linear-gradient(135deg, #667eea, #764ba2);
+        }
+        /* Chat & Verify Card - Green Theme */
+        .chat-verify-card::before {
+            background: linear-gradient(135deg, #a7f3d0, #6ee7b7);
+        }
+        .chat-verify-card:hover {
+            border-color: #a7f3d0;
+        }
+        .chat-verify-button {
+            background: linear-gradient(135deg, #a7f3d0, #6ee7b7);
+            color: #1f2937;
+        }
+        .chat-verify-button:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 10px 20px rgba(167, 243, 208, 0.3);
+        }
+        /* Folder Analyzer Card - Yellow Theme */
+        .folder-analyzer-card::before {
+            background: linear-gradient(135deg, #fde68a, #fbbf24);
+        }
+        .folder-analyzer-card:hover {
+            border-color: #fde68a;
+        }
+        .folder-analyzer-button {
+            background: linear-gradient(135deg, #fde68a, #fbbf24);
+            color: #1f2937;
+        }
+        .folder-analyzer-button:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 10px 20px rgba(253, 230, 138, 0.3);
+        }
+        .app-card:hover {
+            transform: translateY(-5px);
+            box-shadow: 0 20px 40px rgba(0, 0, 0, 0.15);
+        }
+        /* Chat & Verify hover effects */
+        .chat-verify-card:hover {
+            border-color: #d1d5db;
+            box-shadow: 0 20px 40px rgba(209, 213, 219, 0.2);
+        }
+        /* Folder Analyzer hover effects */
+        .folder-analyzer-card:hover {
+            border-color: #d1d5db;
+            box-shadow: 0 20px 40px rgba(209, 213, 219, 0.2);
+        }
+        .app-icon {
+            width: 60px;
+            height: 60px;
+            margin: 0 auto 20px;
+            background: linear-gradient(135deg, #667eea, #764ba2);
+            border-radius: 50%;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            font-size: 24px;
+            color: white;
+        }
+        /* Chat & Verify Icon - Green Theme */
+        .chat-verify-card .app-icon {
+            background: linear-gradient(135deg, #a7f3d0, #6ee7b7);
+            color: #1f2937;
+            position: relative;
+        }
+        /* Custom thick checkmark for Chat & Verify */
+        .chat-verify-card .app-icon::before {
+            content: '';
+            position: absolute;
+            width: 8px;
+            height: 16px;
+            border: solid #1f2937;
+            border-width: 0 4px 4px 0;
+            transform: rotate(45deg);
+            margin-top: -2px;
+        }
+        /* Folder Analyzer Icon - Yellow Theme */
+        .folder-analyzer-card .app-icon {
+            background: linear-gradient(135deg, #fde68a, #fbbf24);
+            color: #1f2937;
+        }
+        .app-title {
+            font-size: 1.5rem;
+            color: #333;
+            margin-bottom: 15px;
+            font-weight: 600;
+        }
+        .app-description {
+            color: #666;
+            line-height: 1.6;
+            margin-bottom: 25px;
+            font-size: 0.95rem;
+        }
+        .app-features {
+            list-style: none;
+            margin-bottom: 25px;
+            text-align: left;
+        }
+        .app-features li {
+            color: #555;
+            margin-bottom: 8px;
+            padding-left: 20px;
+            position: relative;
+            font-size: 0.9rem;
+        }
+        .app-features li::before {
+            content: '✓';
+            position: absolute;
+            left: 0;
+            color: #667eea;
+            font-weight: bold;
+        }
+        .app-button {
+            background: linear-gradient(135deg, #667eea, #764ba2);
+            color: white;
+            border: none;
+            padding: 12px 30px;
+            border-radius: 25px;
+            font-size: 1rem;
+            font-weight: 600;
+            cursor: pointer;
+            transition: all 0.3s ease;
+            text-decoration: none;
+            display: inline-block;
+            width: 100%;
+        }
+        .app-button:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 10px 20px rgba(102, 126, 234, 0.3);
+        }
+        /* Themed button styles */
+        .chat-verify-button {
+            background: linear-gradient(135deg, #a7f3d0, #6ee7b7);
+            color: #1f2937;
+        }
+        .chat-verify-button:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 10px 20px rgba(167, 243, 208, 0.3);
+        }
+        .folder-analyzer-button {
+            background: linear-gradient(135deg, #fde68a, #fbbf24);
+            color: #1f2937;
+        }
+        .folder-analyzer-button:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 10px 20px rgba(253, 230, 138, 0.3);
+        }
+        .footer {
+            margin-top: 40px;
+            padding-top: 20px;
+            border-top: 1px solid #eee;
+            color: #666;
+            font-size: 0.9rem;
+            font-family: Arial, Helvetica, sans-serif;
+        }
+        @media (max-width: 768px) {
+            body {
+                padding: 40px 10px 10px 10px;
+            }
+            .container {
+                padding: 20px;
+                margin: 0;
+            }
+            .header h1 {
+                font-size: 2rem;
+            }
+            .apps-grid {
+                grid-template-columns: 1fr;
+                gap: 20px;
+            }
+            .app-card {
+                padding: 20px;
+            }
+        }
+        @media (max-width: 480px) {
+            body {
+                padding: 20px 5px 5px 5px;
+            }
+            .container {
+                padding: 15px;
+            }
+            .header h1 {
+                font-size: 1.8rem;
+            }
+            .app-card {
+                padding: 15px;
+            }
+        }
+    </style>
+</head>
+<body>
+    <div class="version">v<span id="app-version"></span></div>
+    <div class="container">
+        <div class="header">
+            <h1>AI Chat Extensions</h1>
+            <p>Tools and extensions to enhance AI chat productivity.</p>
+        </div>
+        <div class="apps-grid">
+            <div class="app-card chat-verify-card">
+                <div class="app-icon"></div>
+                <h2 class="app-title">Chat & Verify</h2>
+                <p class="app-description">
+                    Chat with citations and highlights in the source document for easy verifications.
+                </p>
+                <button class="app-button chat-verify-button" onclick="openApp('chat-and-verify')">
+                    Launch Chat & Verify
+                </button>
+            </div>
+            <div class="app-card folder-analyzer-card">
+                <div class="app-icon">📁</div>
+                <h2 class="app-title">Folder LLM Analyzer</h2>
+                <p class="app-description">
+                    Runs the same LLM query on each file in a folder and displays results in a grid.
+                </p>
+                <button class="app-button folder-analyzer-button" onclick="openApp('folder-llm-analyzer')">
+                    Launch Folder Analyzer
+                </button>
+            </div>
+        </div>
+    </div>
+    <script>
+        // App version - keep in sync with package.json
+        const APP_VERSION = '0.0.2';
+        console.log('Portal v' + APP_VERSION + ' loaded');
+        // CDN base URL for loading apps
+        const CDN_BASE = 'https://cdn.jsdelivr.net/npm/@kosmas10/';
+        function openApp(packageName) {
+            // Open the application bootstrap from CDN in a new tab/window
+            const url = CDN_BASE + packageName + '@latest/' + packageName + '-bootstrap.html';
+            window.open(url, '_blank');
+        }
+        // Add some interactive effects
+        document.addEventListener('DOMContentLoaded', function() {
+            // Set the version display from the constant
+            const versionElement = document.getElementById('app-version');
+            if (versionElement) {
+                versionElement.textContent = APP_VERSION;
+            }
+            const cards = document.querySelectorAll('.app-card');
+            cards.forEach(card => {
+                card.addEventListener('mouseenter', function() {
+                    this.style.transform = 'translateY(-5px) scale(1.02)';
+                });
+                card.addEventListener('mouseleave', function() {
+                    this.style.transform = 'translateY(0) scale(1)';
+                });
+                // Make entire card clickable
+                card.addEventListener('click', function(e) {
+                    // Don't trigger if clicking on the button (to avoid double-triggering)
+                    if (e.target.classList.contains('app-button')) {
+                        return;
+                    }
+                    // Find the button in this card and trigger its click
+                    const button = this.querySelector('.app-button');
+                    if (button) {
+                        button.click();
+                    }
+                });
+                // Add cursor pointer to indicate clickability
+                card.style.cursor = 'pointer';
+            });
+        });
+    </script>
+</body>
+</html>