refactor: deep cleanup - remove all website code from framework repo
REMOVED: 77 website-specific files from src/ and public/
Website Models (9):
- Blog, CaseSubmission, Document, Donation, MediaInquiry,
ModerationQueue, NewsletterSubscription, Resource, User
Website Services (6):
- BlogCuration, MediaTriage, Koha, ClaudeAPI, ClaudeMdAnalyzer,
AdaptiveCommunicationOrchestrator
Website Controllers (9):
- blog, cases, documents, koha, media, newsletter, auth, admin, variables
Website Routes (10):
- blog, cases, documents, koha, media, newsletter, auth, admin, test, demo
Website Middleware (4):
- auth, csrf-protection, file-security, response-sanitization
Website Utils (3):
- document-section-parser, jwt, markdown
Website JS (36):
- Website components, docs viewers, page features, i18n, Koha
RETAINED Framework Code:
- 6 core services (Boundary, ContextPressure, CrossReference,
InstructionPersistence, Metacognitive, PluralisticDeliberation)
- 4 support services (AnthropicMemoryClient, MemoryProxy,
RuleOptimizer, VariableSubstitution)
- 9 framework models (governance, audit, deliberation, project state)
- 3 framework controllers (rules, projects, audit)
- 7 framework routes (rules, governance, projects, audit, hooks, sync)
- 6 framework middleware (error, validation, security, governance)
- Minimal admin UI (rule manager, dashboard, hooks dashboard)
- Framework demos and documentation
PURPOSE: Tractatus-framework repo is now PURELY framework code.
All website/project code remains in internal repo only.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
TheFlow
parent
cd6e7bcd0b
commit
aab23e8c33
77 changed files with 0 additions and 21354 deletions
|
|
@ -1,36 +0,0 @@
|
||||||
# Security Policy
|
|
||||||
|
|
||||||
Contact: mailto:security@agenticgovernance.digital
|
|
||||||
Expires: 2026-10-09T00:00:00.000Z
|
|
||||||
Preferred-Languages: en
|
|
||||||
Canonical: https://agenticgovernance.digital/.well-known/security.txt
|
|
||||||
|
|
||||||
# Encryption
|
|
||||||
# Please use PGP encryption for sensitive security reports
|
|
||||||
# Public key available at: https://agenticgovernance.digital/.well-known/pgp-key.txt
|
|
||||||
|
|
||||||
# Policy
|
|
||||||
# We take security seriously and appreciate responsible disclosure
|
|
||||||
# Please allow up to 48 hours for initial response
|
|
||||||
# We aim to patch critical vulnerabilities within 7 days
|
|
||||||
|
|
||||||
# Scope
|
|
||||||
# In scope:
|
|
||||||
# - XSS, CSRF, SQL/NoSQL injection
|
|
||||||
# - Authentication/authorization bypass
|
|
||||||
# - Sensitive data exposure
|
|
||||||
# - Server-side vulnerabilities
|
|
||||||
|
|
||||||
# Out of scope:
|
|
||||||
# - Social engineering
|
|
||||||
# - Physical security
|
|
||||||
# - Denial of Service (DoS/DDoS)
|
|
||||||
# - Self-XSS
|
|
||||||
# - Clickjacking on pages without sensitive actions
|
|
||||||
|
|
||||||
# Acknowledgments
|
|
||||||
# https://agenticgovernance.digital/security-researchers
|
|
||||||
|
|
||||||
# Hall of Fame
|
|
||||||
# Security researchers who responsibly disclosed vulnerabilities:
|
|
||||||
# (None yet - be the first!)
|
|
||||||
Binary file not shown.
|
|
@ -1,107 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<svg width="200" height="200" viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg">
|
|
||||||
<defs>
|
|
||||||
<!-- Central core gradient (shared with Passport - cyan to blue) -->
|
|
||||||
<radialGradient id="tractatusCore">
|
|
||||||
<stop offset="0%" style="stop-color:#64ffda;stop-opacity:1" />
|
|
||||||
<stop offset="70%" style="stop-color:#448aff;stop-opacity:1" />
|
|
||||||
<stop offset="100%" style="stop-color:#0ea5e9;stop-opacity:1" />
|
|
||||||
</radialGradient>
|
|
||||||
|
|
||||||
<!-- Service-specific gradients (6 governance services) -->
|
|
||||||
<!-- 1. BoundaryEnforcer - Green (safety, protection) -->
|
|
||||||
<linearGradient id="serviceBoundary" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
||||||
<stop offset="0%" style="stop-color:#10b981;stop-opacity:1" />
|
|
||||||
<stop offset="100%" style="stop-color:#059669;stop-opacity:1" />
|
|
||||||
</linearGradient>
|
|
||||||
|
|
||||||
<!-- 2. InstructionPersistenceClassifier - Indigo (memory, persistence) -->
|
|
||||||
<linearGradient id="serviceInstruction" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
||||||
<stop offset="0%" style="stop-color:#6366f1;stop-opacity:1" />
|
|
||||||
<stop offset="100%" style="stop-color:#4f46e5;stop-opacity:1" />
|
|
||||||
</linearGradient>
|
|
||||||
|
|
||||||
<!-- 3. CrossReferenceValidator - Purple (verification) -->
|
|
||||||
<linearGradient id="serviceValidator" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
||||||
<stop offset="0%" style="stop-color:#8b5cf6;stop-opacity:1" />
|
|
||||||
<stop offset="100%" style="stop-color:#7c3aed;stop-opacity:1" />
|
|
||||||
</linearGradient>
|
|
||||||
|
|
||||||
<!-- 4. ContextPressureMonitor - Amber (alertness, monitoring) -->
|
|
||||||
<linearGradient id="servicePressure" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
||||||
<stop offset="0%" style="stop-color:#f59e0b;stop-opacity:1" />
|
|
||||||
<stop offset="100%" style="stop-color:#d97706;stop-opacity:1" />
|
|
||||||
</linearGradient>
|
|
||||||
|
|
||||||
<!-- 5. MetacognitiveVerifier - Rose (reflection, thought) -->
|
|
||||||
<linearGradient id="serviceMetacognitive" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
||||||
<stop offset="0%" style="stop-color:#ec4899;stop-opacity:1" />
|
|
||||||
<stop offset="100%" style="stop-color:#db2777;stop-opacity:1" />
|
|
||||||
</linearGradient>
|
|
||||||
|
|
||||||
<!-- 6. PluralisticDeliberationOrchestrator - Teal (balance, mediation) -->
|
|
||||||
<linearGradient id="serviceDeliberation" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
||||||
<stop offset="0%" style="stop-color:#14b8a6;stop-opacity:1" />
|
|
||||||
<stop offset="100%" style="stop-color:#0d9488;stop-opacity:1" />
|
|
||||||
</linearGradient>
|
|
||||||
|
|
||||||
<!-- Connection lines gradient -->
|
|
||||||
<linearGradient id="connectionGradient" x1="0%" y1="0%" x2="100%" y2="0%">
|
|
||||||
<stop offset="0%" style="stop-color:#64ffda;stop-opacity:0.2" />
|
|
||||||
<stop offset="50%" style="stop-color:#64ffda;stop-opacity:0.5" />
|
|
||||||
<stop offset="100%" style="stop-color:#64ffda;stop-opacity:0.2" />
|
|
||||||
</linearGradient>
|
|
||||||
|
|
||||||
<!-- Drop shadow for depth -->
|
|
||||||
<filter id="dropShadow">
|
|
||||||
<feDropShadow dx="0" dy="2" stdDeviation="3" flood-opacity="0.3"/>
|
|
||||||
</filter>
|
|
||||||
</defs>
|
|
||||||
|
|
||||||
<!-- Subtle background for contrast -->
|
|
||||||
<circle cx="100" cy="100" r="95" fill="rgba(255,255,255,0.02)"/>
|
|
||||||
|
|
||||||
<!-- Orbital rings (3 layers - governance architecture) -->
|
|
||||||
<circle cx="100" cy="100" r="85" stroke="#64ffda" stroke-width="1" opacity="0.15" fill="none"/>
|
|
||||||
<circle cx="100" cy="100" r="70" stroke="#64ffda" stroke-width="1" opacity="0.25" fill="none"/>
|
|
||||||
<circle cx="100" cy="100" r="55" stroke="#64ffda" stroke-width="1" opacity="0.35" fill="none"/>
|
|
||||||
|
|
||||||
<!-- Connection lines from center to each service node (hexagonal pattern) -->
|
|
||||||
<g opacity="0.4">
|
|
||||||
<line x1="100" y1="100" x2="100" y2="35" stroke="url(#connectionGradient)" stroke-width="2"/>
|
|
||||||
<line x1="100" y1="100" x2="156" y2="67.5" stroke="url(#connectionGradient)" stroke-width="2"/>
|
|
||||||
<line x1="100" y1="100" x2="156" y2="132.5" stroke="url(#connectionGradient)" stroke-width="2"/>
|
|
||||||
<line x1="100" y1="100" x2="100" y2="165" stroke="url(#connectionGradient)" stroke-width="2"/>
|
|
||||||
<line x1="100" y1="100" x2="44" y2="132.5" stroke="url(#connectionGradient)" stroke-width="2"/>
|
|
||||||
<line x1="100" y1="100" x2="44" y2="67.5" stroke="url(#connectionGradient)" stroke-width="2"/>
|
|
||||||
</g>
|
|
||||||
|
|
||||||
<!-- Six governance service nodes in hexagonal arrangement -->
|
|
||||||
<!-- 1. BoundaryEnforcer (top) - Green -->
|
|
||||||
<circle cx="100" cy="35" r="18" fill="url(#serviceBoundary)" filter="url(#dropShadow)" opacity="0.9"/>
|
|
||||||
|
|
||||||
<!-- 2. InstructionPersistenceClassifier (top-right) - Indigo -->
|
|
||||||
<circle cx="156" cy="67.5" r="18" fill="url(#serviceInstruction)" filter="url(#dropShadow)" opacity="0.9"/>
|
|
||||||
|
|
||||||
<!-- 3. CrossReferenceValidator (bottom-right) - Purple -->
|
|
||||||
<circle cx="156" cy="132.5" r="18" fill="url(#serviceValidator)" filter="url(#dropShadow)" opacity="0.9"/>
|
|
||||||
|
|
||||||
<!-- 4. ContextPressureMonitor (bottom) - Amber -->
|
|
||||||
<circle cx="100" cy="165" r="18" fill="url(#servicePressure)" filter="url(#dropShadow)" opacity="0.9"/>
|
|
||||||
|
|
||||||
<!-- 5. MetacognitiveVerifier (bottom-left) - Rose -->
|
|
||||||
<circle cx="44" cy="132.5" r="18" fill="url(#serviceMetacognitive)" filter="url(#dropShadow)" opacity="0.9"/>
|
|
||||||
|
|
||||||
<!-- 6. PluralisticDeliberationOrchestrator (top-left) - Teal -->
|
|
||||||
<circle cx="44" cy="67.5" r="18" fill="url(#serviceDeliberation)" filter="url(#dropShadow)" opacity="0.9"/>
|
|
||||||
|
|
||||||
<!-- Central core (AI system being governed) -->
|
|
||||||
<circle cx="100" cy="100" r="35" fill="url(#tractatusCore)" filter="url(#dropShadow)"/>
|
|
||||||
|
|
||||||
<!-- Subtle outer glow -->
|
|
||||||
<circle cx="100" cy="100" r="38" fill="none" stroke="rgba(100,255,218,0.2)" stroke-width="2"/>
|
|
||||||
|
|
||||||
<!-- Center symbol - "T" for Tractatus -->
|
|
||||||
<circle cx="100" cy="100" r="28" fill="rgba(0,0,0,0.25)"/>
|
|
||||||
<text x="100" y="110" text-anchor="middle" font-family="Arial, sans-serif" font-size="32" font-weight="bold" fill="white" opacity="0.95">T</text>
|
|
||||||
</svg>
|
|
||||||
|
Before Width: | Height: | Size: 5.6 KiB |
|
|
@ -1,29 +0,0 @@
|
||||||
<svg viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg" class="tractatus-icon">
|
|
||||||
<!-- Outer orbit -->
|
|
||||||
<circle cx="24" cy="24" r="20" stroke="currentColor" stroke-width="1" opacity="0.3" fill="none"/>
|
|
||||||
|
|
||||||
<!-- Middle orbit -->
|
|
||||||
<circle cx="24" cy="24" r="14" stroke="currentColor" stroke-width="1" opacity="0.4" fill="none"/>
|
|
||||||
|
|
||||||
<!-- Inner orbit -->
|
|
||||||
<circle cx="24" cy="24" r="8" stroke="currentColor" stroke-width="1" opacity="0.5" fill="none"/>
|
|
||||||
|
|
||||||
<!-- Center sphere with gradient for depth -->
|
|
||||||
<defs>
|
|
||||||
<radialGradient id="centerGradient">
|
|
||||||
<stop offset="0%" stop-color="currentColor" stop-opacity="1"/>
|
|
||||||
<stop offset="100%" stop-color="currentColor" stop-opacity="0.7"/>
|
|
||||||
</radialGradient>
|
|
||||||
</defs>
|
|
||||||
<circle cx="24" cy="24" r="5" fill="url(#centerGradient)"/>
|
|
||||||
|
|
||||||
<!-- Orbital dots positioned strategically -->
|
|
||||||
<!-- Outer orbit dot (top-right) -->
|
|
||||||
<circle cx="38" cy="10" r="2" fill="currentColor" opacity="0.7"/>
|
|
||||||
|
|
||||||
<!-- Middle orbit dot (bottom-left) -->
|
|
||||||
<circle cx="14" cy="34" r="1.5" fill="currentColor" opacity="0.8"/>
|
|
||||||
|
|
||||||
<!-- Inner orbit dot (right) -->
|
|
||||||
<circle cx="32" cy="24" r="1.2" fill="currentColor" opacity="0.9"/>
|
|
||||||
</svg>
|
|
||||||
|
Before Width: | Height: | Size: 1.2 KiB |
|
|
@ -1,286 +0,0 @@
|
||||||
/**
|
|
||||||
* Newsletter Management - Admin Interface
|
|
||||||
*/
|
|
||||||
|
|
||||||
let currentPage = 1;
|
|
||||||
const perPage = 50;
|
|
||||||
let currentFilters = {
|
|
||||||
status: 'active',
|
|
||||||
verified: 'all'
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Initialize page
|
|
||||||
*/
|
|
||||||
async function init() {
|
|
||||||
// Event listeners (navbar handles admin name and logout now)
|
|
||||||
document.getElementById('refresh-btn').addEventListener('click', () => loadAll());
|
|
||||||
document.getElementById('export-btn').addEventListener('click', exportSubscribers);
|
|
||||||
document.getElementById('filter-status').addEventListener('change', handleFilterChange);
|
|
||||||
document.getElementById('filter-verified').addEventListener('change', handleFilterChange);
|
|
||||||
document.getElementById('prev-page').addEventListener('click', () => changePage(-1));
|
|
||||||
document.getElementById('next-page').addEventListener('click', () => changePage(1));
|
|
||||||
|
|
||||||
// Load data
|
|
||||||
await loadAll();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Load all data
|
|
||||||
*/
|
|
||||||
async function loadAll() {
|
|
||||||
await Promise.all([
|
|
||||||
loadStats(),
|
|
||||||
loadSubscribers()
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Load statistics
|
|
||||||
*/
|
|
||||||
async function loadStats() {
|
|
||||||
try {
|
|
||||||
const token = localStorage.getItem('admin_token');
|
|
||||||
const response = await fetch('/api/newsletter/admin/stats', {
|
|
||||||
headers: {
|
|
||||||
'Authorization': `Bearer ${token}`
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
if (!response.ok) throw new Error('Failed to load stats');
|
|
||||||
|
|
||||||
const data = await response.json();
|
|
||||||
const stats = data.stats;
|
|
||||||
|
|
||||||
document.getElementById('stat-total').textContent = stats.total || 0;
|
|
||||||
document.getElementById('stat-active').textContent = stats.active || 0;
|
|
||||||
document.getElementById('stat-verified').textContent = stats.verified || 0;
|
|
||||||
document.getElementById('stat-recent').textContent = stats.recent_30_days || 0;
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error loading stats:', error);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Load subscribers list
|
|
||||||
*/
|
|
||||||
async function loadSubscribers() {
|
|
||||||
try {
|
|
||||||
const token = localStorage.getItem('admin_token');
|
|
||||||
const skip = (currentPage - 1) * perPage;
|
|
||||||
|
|
||||||
const params = new URLSearchParams({
|
|
||||||
limit: perPage,
|
|
||||||
skip,
|
|
||||||
active: currentFilters.status === 'all' ? null : currentFilters.status === 'active',
|
|
||||||
verified: currentFilters.verified === 'all' ? null : currentFilters.verified === 'verified'
|
|
||||||
});
|
|
||||||
|
|
||||||
// Remove null values
|
|
||||||
for (const [key, value] of [...params.entries()]) {
|
|
||||||
if (value === 'null' || value === null) {
|
|
||||||
params.delete(key);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
const response = await fetch(`/api/newsletter/admin/subscriptions?${params}`, {
|
|
||||||
headers: {
|
|
||||||
'Authorization': `Bearer ${token}`
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
if (!response.ok) throw new Error('Failed to load subscribers');
|
|
||||||
|
|
||||||
const data = await response.json();
|
|
||||||
renderSubscribers(data.subscriptions);
|
|
||||||
updatePagination(data.pagination);
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error loading subscribers:', error);
|
|
||||||
document.getElementById('subscribers-table').innerHTML = `
|
|
||||||
<tr>
|
|
||||||
<td colspan="6" class="px-6 py-8 text-center text-red-600">
|
|
||||||
Error loading subscribers. Please refresh the page.
|
|
||||||
</td>
|
|
||||||
</tr>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render subscribers table
|
|
||||||
*/
|
|
||||||
function renderSubscribers(subscriptions) {
|
|
||||||
const tbody = document.getElementById('subscribers-table');
|
|
||||||
|
|
||||||
if (!subscriptions || subscriptions.length === 0) {
|
|
||||||
tbody.innerHTML = `
|
|
||||||
<tr>
|
|
||||||
<td colspan="6" class="px-6 py-8 text-center text-gray-500">
|
|
||||||
No subscribers found
|
|
||||||
</td>
|
|
||||||
</tr>
|
|
||||||
`;
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
tbody.innerHTML = subscriptions.map(sub => `
|
|
||||||
<tr>
|
|
||||||
<td class="px-6 py-4 whitespace-nowrap text-sm font-medium text-gray-900">
|
|
||||||
${escapeHtml(sub.email)}
|
|
||||||
</td>
|
|
||||||
<td class="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
|
|
||||||
${escapeHtml(sub.name) || '-'}
|
|
||||||
</td>
|
|
||||||
<td class="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
|
|
||||||
${escapeHtml(sub.source) || 'unknown'}
|
|
||||||
</td>
|
|
||||||
<td class="px-6 py-4 whitespace-nowrap text-sm">
|
|
||||||
${sub.active
|
|
||||||
? `<span class="inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-green-100 text-green-800">
|
|
||||||
${sub.verified ? '<svg class="w-3 h-3 mr-1" fill="currentColor" viewBox="0 0 20 20"><path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z" clip-rule="evenodd"/></svg>' : ''}
|
|
||||||
${sub.verified ? 'Active ✓' : 'Active'}
|
|
||||||
</span>`
|
|
||||||
: '<span class="inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-gray-100 text-gray-800">Inactive</span>'
|
|
||||||
}
|
|
||||||
</td>
|
|
||||||
<td class="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
|
|
||||||
${formatDate(sub.subscribed_at)}
|
|
||||||
</td>
|
|
||||||
<td class="px-6 py-4 whitespace-nowrap text-right text-sm font-medium">
|
|
||||||
<button class="view-details-btn text-blue-600 hover:text-blue-900 mr-3" data-id="${sub._id}">View</button>
|
|
||||||
<button class="delete-subscriber-btn text-red-600 hover:text-red-900" data-id="${sub._id}" data-email="${escapeHtml(sub.email)}">Delete</button>
|
|
||||||
</td>
|
|
||||||
</tr>
|
|
||||||
`).join('');
|
|
||||||
|
|
||||||
// Add event listeners to buttons
|
|
||||||
tbody.querySelectorAll('.view-details-btn').forEach(btn => {
|
|
||||||
btn.addEventListener('click', () => viewDetails(btn.dataset.id));
|
|
||||||
});
|
|
||||||
|
|
||||||
tbody.querySelectorAll('.delete-subscriber-btn').forEach(btn => {
|
|
||||||
btn.addEventListener('click', () => deleteSubscriber(btn.dataset.id, btn.dataset.email));
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update pagination UI
|
|
||||||
*/
|
|
||||||
function updatePagination(pagination) {
|
|
||||||
document.getElementById('showing-from').textContent = pagination.skip + 1;
|
|
||||||
document.getElementById('showing-to').textContent = Math.min(pagination.skip + pagination.limit, pagination.total);
|
|
||||||
document.getElementById('total-count').textContent = pagination.total;
|
|
||||||
|
|
||||||
document.getElementById('prev-page').disabled = currentPage === 1;
|
|
||||||
document.getElementById('next-page').disabled = !pagination.has_more;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle filter change
|
|
||||||
*/
|
|
||||||
function handleFilterChange() {
|
|
||||||
currentFilters.status = document.getElementById('filter-status').value;
|
|
||||||
currentFilters.verified = document.getElementById('filter-verified').value;
|
|
||||||
currentPage = 1;
|
|
||||||
loadSubscribers();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Change page
|
|
||||||
*/
|
|
||||||
function changePage(direction) {
|
|
||||||
currentPage += direction;
|
|
||||||
loadSubscribers();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* View subscriber details
|
|
||||||
*/
|
|
||||||
async function viewDetails(id) {
|
|
||||||
alert(`Subscriber details for ID: ${id}\n(Full implementation would show a modal with complete subscriber information)`);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete subscriber
|
|
||||||
*/
|
|
||||||
async function deleteSubscriber(id, email) {
|
|
||||||
if (!confirm(`Are you sure you want to delete subscription for ${email}?\n\nThis action cannot be undone.`)) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
try {
|
|
||||||
const token = localStorage.getItem('admin_token');
|
|
||||||
const response = await fetch(`/api/newsletter/admin/subscriptions/${id}`, {
|
|
||||||
method: 'DELETE',
|
|
||||||
headers: {
|
|
||||||
'Authorization': `Bearer ${token}`
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
if (!response.ok) throw new Error('Failed to delete subscriber');
|
|
||||||
|
|
||||||
alert('Subscriber deleted successfully');
|
|
||||||
await loadAll();
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error deleting subscriber:', error);
|
|
||||||
alert('Failed to delete subscriber. Please try again.');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Export subscribers as CSV
|
|
||||||
*/
|
|
||||||
async function exportSubscribers() {
|
|
||||||
try {
|
|
||||||
const token = localStorage.getItem('admin_token');
|
|
||||||
const active = currentFilters.status === 'all' ? 'all' : 'true';
|
|
||||||
|
|
||||||
const response = await fetch(`/api/newsletter/admin/export?active=${active}`, {
|
|
||||||
headers: {
|
|
||||||
'Authorization': `Bearer ${token}`
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
if (!response.ok) throw new Error('Failed to export subscribers');
|
|
||||||
|
|
||||||
const blob = await response.blob();
|
|
||||||
const url = window.URL.createObjectURL(blob);
|
|
||||||
const a = document.createElement('a');
|
|
||||||
a.href = url;
|
|
||||||
a.download = `newsletter-subscribers-${Date.now()}.csv`;
|
|
||||||
document.body.appendChild(a);
|
|
||||||
a.click();
|
|
||||||
window.URL.revokeObjectURL(url);
|
|
||||||
document.body.removeChild(a);
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error exporting subscribers:', error);
|
|
||||||
alert('Failed to export subscribers. Please try again.');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Logout handled by navbar component
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Format date
|
|
||||||
*/
|
|
||||||
function formatDate(dateString) {
|
|
||||||
const date = new Date(dateString);
|
|
||||||
return date.toLocaleDateString('en-US', {
|
|
||||||
year: 'numeric',
|
|
||||||
month: 'short',
|
|
||||||
day: 'numeric'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Escape HTML
|
|
||||||
*/
|
|
||||||
function escapeHtml(text) {
|
|
||||||
if (!text) return '';
|
|
||||||
const div = document.createElement('div');
|
|
||||||
div.textContent = text;
|
|
||||||
return div.innerHTML;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Initialize on page load
|
|
||||||
document.addEventListener('DOMContentLoaded', init);
|
|
||||||
|
|
@ -1,433 +0,0 @@
|
||||||
/**
|
|
||||||
* Blog Post Page - Client-Side Logic
|
|
||||||
* Handles fetching and displaying individual blog posts with metadata, sharing, and related posts
|
|
||||||
*/
|
|
||||||
|
|
||||||
let currentPost = null;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Initialize the blog post page
|
|
||||||
*/
|
|
||||||
async function init() {
|
|
||||||
try {
|
|
||||||
// Get slug from URL parameter
|
|
||||||
const urlParams = new URLSearchParams(window.location.search);
|
|
||||||
const slug = urlParams.get('slug');
|
|
||||||
|
|
||||||
if (!slug) {
|
|
||||||
showError('No blog post specified');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
await loadPost(slug);
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error initializing blog post:', error);
|
|
||||||
showError('Failed to load blog post');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Load blog post by slug
|
|
||||||
*/
|
|
||||||
async function loadPost(slug) {
|
|
||||||
try {
|
|
||||||
const response = await fetch(`/api/blog/${slug}`);
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (!data.success) {
|
|
||||||
throw new Error(data.error || 'Post not found');
|
|
||||||
}
|
|
||||||
|
|
||||||
currentPost = data.post;
|
|
||||||
|
|
||||||
// Render post
|
|
||||||
renderPost();
|
|
||||||
|
|
||||||
// Load related posts
|
|
||||||
loadRelatedPosts();
|
|
||||||
|
|
||||||
// Attach event listeners
|
|
||||||
attachEventListeners();
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error loading post:', error);
|
|
||||||
showError(error.message || 'Post not found');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Helper: Safely set element content
|
|
||||||
*/
|
|
||||||
function safeSetContent(elementId, content) {
|
|
||||||
const element = document.getElementById(elementId);
|
|
||||||
if (element) {
|
|
||||||
element.textContent = content;
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Helper: Safely set element attribute
|
|
||||||
*/
|
|
||||||
function safeSetAttribute(elementId, attribute, value) {
|
|
||||||
const element = document.getElementById(elementId);
|
|
||||||
if (element) {
|
|
||||||
element.setAttribute(attribute, value);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render the blog post
|
|
||||||
*/
|
|
||||||
function renderPost() {
|
|
||||||
// Hide loading state
|
|
||||||
safeSetClass('loading-state', 'add', 'hidden');
|
|
||||||
safeSetClass('error-state', 'add', 'hidden');
|
|
||||||
|
|
||||||
// Show post content
|
|
||||||
safeSetClass('post-content', 'remove', 'hidden');
|
|
||||||
|
|
||||||
// Update page title and meta description
|
|
||||||
safeSetContent('page-title', `${currentPost.title} | Tractatus Blog`);
|
|
||||||
safeSetAttribute('page-description', 'content', currentPost.excerpt || currentPost.title);
|
|
||||||
|
|
||||||
// Update social media meta tags
|
|
||||||
updateSocialMetaTags(currentPost);
|
|
||||||
|
|
||||||
// Update breadcrumb
|
|
||||||
safeSetContent('breadcrumb-title', truncate(currentPost.title, 50));
|
|
||||||
|
|
||||||
// Render post header
|
|
||||||
if (currentPost.category) {
|
|
||||||
safeSetContent('post-category', currentPost.category);
|
|
||||||
} else {
|
|
||||||
const categoryEl = document.getElementById('post-category');
|
|
||||||
if (categoryEl) categoryEl.style.display = 'none';
|
|
||||||
}
|
|
||||||
|
|
||||||
safeSetContent('post-title', currentPost.title);
|
|
||||||
|
|
||||||
// Author - handle both flat (author_name) and nested (author.name) structures
|
|
||||||
const authorName = currentPost.author_name || currentPost.author?.name || 'Tractatus Team';
|
|
||||||
safeSetContent('post-author', authorName);
|
|
||||||
|
|
||||||
// Date
|
|
||||||
const publishedDate = new Date(currentPost.published_at);
|
|
||||||
const formattedDate = publishedDate.toLocaleDateString('en-US', {
|
|
||||||
year: 'numeric',
|
|
||||||
month: 'long',
|
|
||||||
day: 'numeric'
|
|
||||||
});
|
|
||||||
safeSetContent('post-date', formattedDate);
|
|
||||||
safeSetAttribute('post-date', 'datetime', currentPost.published_at);
|
|
||||||
|
|
||||||
// Read time
|
|
||||||
const wordCount = currentPost.content ? currentPost.content.split(/\s+/).length : 0;
|
|
||||||
const readTime = Math.max(1, Math.ceil(wordCount / 200));
|
|
||||||
safeSetContent('post-read-time', `${readTime} min read`);
|
|
||||||
|
|
||||||
// Tags
|
|
||||||
if (currentPost.tags && currentPost.tags.length > 0) {
|
|
||||||
const tagsHTML = currentPost.tags.map(tag => `
|
|
||||||
<span class="inline-block bg-gray-100 text-gray-700 text-sm px-3 py-1 rounded-full">
|
|
||||||
${escapeHtml(tag)}
|
|
||||||
</span>
|
|
||||||
`).join('');
|
|
||||||
const tagsEl = document.getElementById('post-tags');
|
|
||||||
if (tagsEl) tagsEl.innerHTML = tagsHTML;
|
|
||||||
safeSetClass('post-tags-container', 'remove', 'hidden');
|
|
||||||
}
|
|
||||||
|
|
||||||
// AI disclosure (if AI-assisted)
|
|
||||||
if (currentPost.ai_assisted || currentPost.metadata?.ai_assisted) {
|
|
||||||
safeSetClass('ai-disclosure', 'remove', 'hidden');
|
|
||||||
}
|
|
||||||
|
|
||||||
// Post body
|
|
||||||
const bodyHTML = currentPost.content_html || convertMarkdownToHTML(currentPost.content);
|
|
||||||
const bodyEl = document.getElementById('post-body');
|
|
||||||
if (bodyEl) bodyEl.innerHTML = bodyHTML;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Helper: Safely add/remove class
|
|
||||||
*/
|
|
||||||
function safeSetClass(elementId, action, className) {
|
|
||||||
const element = document.getElementById(elementId);
|
|
||||||
if (element) {
|
|
||||||
if (action === 'add') {
|
|
||||||
element.classList.add(className);
|
|
||||||
} else if (action === 'remove') {
|
|
||||||
element.classList.remove(className);
|
|
||||||
}
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Load related posts (same category or similar tags)
|
|
||||||
*/
|
|
||||||
async function loadRelatedPosts() {
|
|
||||||
try {
|
|
||||||
// Fetch all published posts
|
|
||||||
const response = await fetch('/api/blog');
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (!data.success) return;
|
|
||||||
|
|
||||||
let allPosts = data.posts || [];
|
|
||||||
|
|
||||||
// Filter out current post
|
|
||||||
allPosts = allPosts.filter(post => post._id !== currentPost._id);
|
|
||||||
|
|
||||||
// Find related posts (same category, or matching tags)
|
|
||||||
let relatedPosts = [];
|
|
||||||
|
|
||||||
// Priority 1: Same category
|
|
||||||
if (currentPost.category) {
|
|
||||||
relatedPosts = allPosts.filter(post => post.category === currentPost.category);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Priority 2: Matching tags (if not enough from same category)
|
|
||||||
if (relatedPosts.length < 3 && currentPost.tags && currentPost.tags.length > 0) {
|
|
||||||
const tagMatches = allPosts.filter(post => {
|
|
||||||
if (!post.tags || post.tags.length === 0) return false;
|
|
||||||
return post.tags.some(tag => currentPost.tags.includes(tag));
|
|
||||||
});
|
|
||||||
relatedPosts = [...new Set([...relatedPosts, ...tagMatches])];
|
|
||||||
}
|
|
||||||
|
|
||||||
// Priority 3: Most recent posts (if still not enough)
|
|
||||||
if (relatedPosts.length < 3) {
|
|
||||||
const recentPosts = allPosts
|
|
||||||
.sort((a, b) => new Date(b.published_at) - new Date(a.published_at))
|
|
||||||
.slice(0, 3);
|
|
||||||
relatedPosts = [...new Set([...relatedPosts, ...recentPosts])];
|
|
||||||
}
|
|
||||||
|
|
||||||
// Limit to 2-3 related posts
|
|
||||||
relatedPosts = relatedPosts.slice(0, 2);
|
|
||||||
|
|
||||||
if (relatedPosts.length > 0) {
|
|
||||||
renderRelatedPosts(relatedPosts);
|
|
||||||
}
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error loading related posts:', error);
|
|
||||||
// Silently fail - related posts are not critical
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render related posts section
|
|
||||||
*/
|
|
||||||
function renderRelatedPosts(posts) {
|
|
||||||
const relatedPostsHTML = posts.map(post => {
|
|
||||||
const publishedDate = new Date(post.published_at);
|
|
||||||
const formattedDate = publishedDate.toLocaleDateString('en-US', {
|
|
||||||
year: 'numeric',
|
|
||||||
month: 'long',
|
|
||||||
day: 'numeric'
|
|
||||||
});
|
|
||||||
|
|
||||||
return `
|
|
||||||
<article class="bg-white rounded-lg shadow-md overflow-hidden hover:shadow-xl transition">
|
|
||||||
<a href="/blog-post.html?slug=${escapeHtml(post.slug)}" class="block">
|
|
||||||
${post.featured_image ? `
|
|
||||||
<div class="aspect-w-16 aspect-h-9 bg-gray-200">
|
|
||||||
<img src="${escapeHtml(post.featured_image)}" alt="${escapeHtml(post.title)}" class="object-cover w-full h-32">
|
|
||||||
</div>
|
|
||||||
` : `
|
|
||||||
<div class="h-32 bg-gradient-to-br from-indigo-400 to-indigo-600 flex items-center justify-center">
|
|
||||||
<svg class="h-12 w-12 text-white opacity-50" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
|
|
||||||
</svg>
|
|
||||||
</div>
|
|
||||||
`}
|
|
||||||
<div class="p-4">
|
|
||||||
${post.category ? `
|
|
||||||
<span class="inline-block bg-indigo-100 text-indigo-800 text-xs font-semibold px-2 py-0.5 rounded mb-2">
|
|
||||||
${escapeHtml(post.category)}
|
|
||||||
</span>
|
|
||||||
` : ''}
|
|
||||||
<h3 class="text-lg font-bold text-gray-900 mb-2 line-clamp-2 hover:text-indigo-600">
|
|
||||||
${escapeHtml(post.title)}
|
|
||||||
</h3>
|
|
||||||
<div class="text-sm text-gray-500">
|
|
||||||
<time datetime="${post.published_at}">${formattedDate}</time>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
</a>
|
|
||||||
</article>
|
|
||||||
`;
|
|
||||||
}).join('');
|
|
||||||
|
|
||||||
document.getElementById('related-posts').innerHTML = relatedPostsHTML;
|
|
||||||
document.getElementById('related-posts-section').classList.remove('hidden');
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Attach event listeners for sharing and interactions
|
|
||||||
*/
|
|
||||||
function attachEventListeners() {
|
|
||||||
// Share on Twitter
|
|
||||||
const shareTwitterBtn = document.getElementById('share-twitter');
|
|
||||||
if (shareTwitterBtn) {
|
|
||||||
shareTwitterBtn.addEventListener('click', () => {
|
|
||||||
const url = encodeURIComponent(window.location.href);
|
|
||||||
const text = encodeURIComponent(currentPost.title);
|
|
||||||
window.open(`https://twitter.com/intent/tweet?url=${url}&text=${text}`, '_blank', 'width=550,height=420');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Share on LinkedIn
|
|
||||||
const shareLinkedInBtn = document.getElementById('share-linkedin');
|
|
||||||
if (shareLinkedInBtn) {
|
|
||||||
shareLinkedInBtn.addEventListener('click', () => {
|
|
||||||
const url = encodeURIComponent(window.location.href);
|
|
||||||
window.open(`https://www.linkedin.com/sharing/share-offsite/?url=${url}`, '_blank', 'width=550,height=420');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Copy link
|
|
||||||
const copyLinkBtn = document.getElementById('copy-link');
|
|
||||||
if (copyLinkBtn) {
|
|
||||||
copyLinkBtn.addEventListener('click', async () => {
|
|
||||||
try {
|
|
||||||
await navigator.clipboard.writeText(window.location.href);
|
|
||||||
// Show temporary success message
|
|
||||||
const originalHTML = copyLinkBtn.innerHTML;
|
|
||||||
copyLinkBtn.innerHTML = `
|
|
||||||
<svg class="h-5 w-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"/>
|
|
||||||
</svg>
|
|
||||||
Copied!
|
|
||||||
`;
|
|
||||||
copyLinkBtn.classList.add('bg-green-600');
|
|
||||||
copyLinkBtn.classList.remove('bg-gray-600');
|
|
||||||
|
|
||||||
setTimeout(() => {
|
|
||||||
copyLinkBtn.innerHTML = originalHTML;
|
|
||||||
copyLinkBtn.classList.remove('bg-green-600');
|
|
||||||
copyLinkBtn.classList.add('bg-gray-600');
|
|
||||||
}, 2000);
|
|
||||||
} catch (err) {
|
|
||||||
console.error('Failed to copy link:', err);
|
|
||||||
// Show error in button
|
|
||||||
const originalHTML = copyLinkBtn.innerHTML;
|
|
||||||
copyLinkBtn.innerHTML = `
|
|
||||||
<svg class="h-5 w-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
|
|
||||||
</svg>
|
|
||||||
Failed
|
|
||||||
`;
|
|
||||||
copyLinkBtn.classList.add('bg-red-600');
|
|
||||||
copyLinkBtn.classList.remove('bg-gray-600');
|
|
||||||
|
|
||||||
setTimeout(() => {
|
|
||||||
copyLinkBtn.innerHTML = originalHTML;
|
|
||||||
copyLinkBtn.classList.remove('bg-red-600');
|
|
||||||
copyLinkBtn.classList.add('bg-gray-600');
|
|
||||||
}, 2000);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Show error state
|
|
||||||
*/
|
|
||||||
function showError(message) {
|
|
||||||
document.getElementById('loading-state').classList.add('hidden');
|
|
||||||
document.getElementById('post-content').classList.add('hidden');
|
|
||||||
|
|
||||||
const errorStateEl = document.getElementById('error-state');
|
|
||||||
errorStateEl.classList.remove('hidden');
|
|
||||||
|
|
||||||
const errorMessageEl = document.getElementById('error-message');
|
|
||||||
if (errorMessageEl) {
|
|
||||||
errorMessageEl.textContent = message;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Convert markdown to HTML (basic implementation - can be enhanced with a library)
|
|
||||||
*/
|
|
||||||
function convertMarkdownToHTML(markdown) {
|
|
||||||
if (!markdown) return '';
|
|
||||||
|
|
||||||
let html = markdown;
|
|
||||||
|
|
||||||
// Headers
|
|
||||||
html = html.replace(/^### (.*$)/gim, '<h3>$1</h3>');
|
|
||||||
html = html.replace(/^## (.*$)/gim, '<h2>$1</h2>');
|
|
||||||
html = html.replace(/^# (.*$)/gim, '<h1>$1</h1>');
|
|
||||||
|
|
||||||
// Bold
|
|
||||||
html = html.replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>');
|
|
||||||
|
|
||||||
// Italic
|
|
||||||
html = html.replace(/\*(.*?)\*/g, '<em>$1</em>');
|
|
||||||
|
|
||||||
// Links
|
|
||||||
html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
|
|
||||||
|
|
||||||
// Paragraphs
|
|
||||||
html = html.replace(/\n\n/g, '</p><p>');
|
|
||||||
html = `<p>${ html }</p>`;
|
|
||||||
|
|
||||||
// Line breaks
|
|
||||||
html = html.replace(/\n/g, '<br>');
|
|
||||||
|
|
||||||
return html;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update social media meta tags for sharing
|
|
||||||
*/
|
|
||||||
function updateSocialMetaTags(post) {
|
|
||||||
const currentUrl = window.location.href;
|
|
||||||
const excerpt = post.excerpt || post.title;
|
|
||||||
const imageUrl = post.featured_image || 'https://agenticgovernance.digital/images/tractatus-icon.svg';
|
|
||||||
const authorName = post.author_name || post.author?.name || 'Tractatus Team';
|
|
||||||
|
|
||||||
// Open Graph tags
|
|
||||||
document.getElementById('og-title').setAttribute('content', post.title);
|
|
||||||
document.getElementById('og-description').setAttribute('content', excerpt);
|
|
||||||
document.getElementById('og-url').setAttribute('content', currentUrl);
|
|
||||||
document.getElementById('og-image').setAttribute('content', imageUrl);
|
|
||||||
|
|
||||||
if (post.published_at) {
|
|
||||||
document.getElementById('article-published-time').setAttribute('content', post.published_at);
|
|
||||||
}
|
|
||||||
document.getElementById('article-author').setAttribute('content', authorName);
|
|
||||||
|
|
||||||
// Twitter Card tags
|
|
||||||
document.getElementById('twitter-title').setAttribute('content', post.title);
|
|
||||||
document.getElementById('twitter-description').setAttribute('content', excerpt);
|
|
||||||
document.getElementById('twitter-image').setAttribute('content', imageUrl);
|
|
||||||
document.getElementById('twitter-image-alt').setAttribute('content', `${post.title} - Tractatus AI Safety Framework`);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Escape HTML to prevent XSS
|
|
||||||
*/
|
|
||||||
function escapeHtml(text) {
|
|
||||||
if (!text) return '';
|
|
||||||
const div = document.createElement('div');
|
|
||||||
div.textContent = text;
|
|
||||||
return div.innerHTML;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Truncate text to specified length
|
|
||||||
*/
|
|
||||||
function truncate(text, maxLength) {
|
|
||||||
if (!text || text.length <= maxLength) return text;
|
|
||||||
return `${text.substring(0, maxLength) }...`;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Initialize on page load
|
|
||||||
document.addEventListener('DOMContentLoaded', init);
|
|
||||||
|
|
@ -1,619 +0,0 @@
|
||||||
/**
|
|
||||||
* Blog Listing Page - Client-Side Logic
|
|
||||||
* Handles fetching, filtering, searching, sorting, and pagination of blog posts
|
|
||||||
*/
|
|
||||||
|
|
||||||
// State management
|
|
||||||
let allPosts = [];
|
|
||||||
let filteredPosts = [];
|
|
||||||
let currentPage = 1;
|
|
||||||
const postsPerPage = 9;
|
|
||||||
|
|
||||||
// Filter state
|
|
||||||
const activeFilters = {
|
|
||||||
search: '',
|
|
||||||
category: '',
|
|
||||||
sort: 'date-desc'
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Initialize the blog page
|
|
||||||
*/
|
|
||||||
async function init() {
|
|
||||||
try {
|
|
||||||
await loadPosts();
|
|
||||||
attachEventListeners();
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error initializing blog:', error);
|
|
||||||
showError('Failed to load blog posts. Please refresh the page.');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Load all published blog posts from API
|
|
||||||
*/
|
|
||||||
async function loadPosts() {
|
|
||||||
try {
|
|
||||||
const response = await fetch('/api/blog');
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (!data.success) {
|
|
||||||
throw new Error(data.error || 'Failed to load posts');
|
|
||||||
}
|
|
||||||
|
|
||||||
allPosts = data.posts || [];
|
|
||||||
filteredPosts = [...allPosts];
|
|
||||||
|
|
||||||
// Apply initial sorting
|
|
||||||
sortPosts();
|
|
||||||
|
|
||||||
// Render initial view
|
|
||||||
renderPosts();
|
|
||||||
updateResultsCount();
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error loading posts:', error);
|
|
||||||
showError('Failed to load blog posts');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render blog posts grid
|
|
||||||
*/
|
|
||||||
function renderPosts() {
|
|
||||||
const gridEl = document.getElementById('blog-grid');
|
|
||||||
const emptyStateEl = document.getElementById('empty-state');
|
|
||||||
|
|
||||||
if (filteredPosts.length === 0) {
|
|
||||||
gridEl.innerHTML = '';
|
|
||||||
emptyStateEl.classList.remove('hidden');
|
|
||||||
document.getElementById('pagination').classList.add('hidden');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
emptyStateEl.classList.add('hidden');
|
|
||||||
|
|
||||||
// Calculate pagination
|
|
||||||
const startIndex = (currentPage - 1) * postsPerPage;
|
|
||||||
const endIndex = startIndex + postsPerPage;
|
|
||||||
const postsToShow = filteredPosts.slice(startIndex, endIndex);
|
|
||||||
|
|
||||||
// Render posts
|
|
||||||
const postsHTML = postsToShow.map(post => renderPostCard(post)).join('');
|
|
||||||
gridEl.innerHTML = postsHTML;
|
|
||||||
|
|
||||||
// Render pagination
|
|
||||||
renderPagination();
|
|
||||||
|
|
||||||
// Scroll to top when changing pages (except initial load)
|
|
||||||
if (currentPage > 1) {
|
|
||||||
window.scrollTo({ top: 0, behavior: 'smooth' });
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render a single post card
|
|
||||||
*/
|
|
||||||
function renderPostCard(post) {
|
|
||||||
const publishedDate = new Date(post.published_at);
|
|
||||||
const formattedDate = publishedDate.toLocaleDateString('en-US', {
|
|
||||||
year: 'numeric',
|
|
||||||
month: 'long',
|
|
||||||
day: 'numeric'
|
|
||||||
});
|
|
||||||
|
|
||||||
// Calculate read time (rough estimate: 200 words per minute)
|
|
||||||
const wordCount = post.content ? post.content.split(/\s+/).length : 0;
|
|
||||||
const readTime = Math.max(1, Math.ceil(wordCount / 200));
|
|
||||||
|
|
||||||
// Truncate excerpt to 150 characters
|
|
||||||
const excerpt = post.excerpt ?
|
|
||||||
(post.excerpt.length > 150 ? `${post.excerpt.substring(0, 150) }...` : post.excerpt) :
|
|
||||||
'Read more...';
|
|
||||||
|
|
||||||
// Get category color
|
|
||||||
const categoryColor = getCategoryColor(post.category);
|
|
||||||
|
|
||||||
return `
|
|
||||||
<article class="bg-white rounded-lg shadow-md overflow-hidden hover:shadow-xl transition-shadow duration-300">
|
|
||||||
<a href="/blog-post.html?slug=${escapeHtml(post.slug)}" class="block">
|
|
||||||
${post.featured_image ? `
|
|
||||||
<div class="aspect-w-16 aspect-h-9 bg-gray-200">
|
|
||||||
<img src="${escapeHtml(post.featured_image)}" alt="${escapeHtml(post.title)}" class="object-cover w-full h-48">
|
|
||||||
</div>
|
|
||||||
` : `
|
|
||||||
<div class="h-48 bg-gradient-to-br ${categoryColor} flex items-center justify-center">
|
|
||||||
<svg class="h-16 w-16 text-white opacity-50" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
|
|
||||||
</svg>
|
|
||||||
</div>
|
|
||||||
`}
|
|
||||||
|
|
||||||
<div class="p-6">
|
|
||||||
<!-- Category Badge -->
|
|
||||||
${post.category ? `
|
|
||||||
<span class="inline-block bg-indigo-100 text-indigo-800 text-xs font-semibold px-2.5 py-0.5 rounded mb-3">
|
|
||||||
${escapeHtml(post.category)}
|
|
||||||
</span>
|
|
||||||
` : ''}
|
|
||||||
|
|
||||||
<!-- Title -->
|
|
||||||
<h2 class="text-xl font-bold text-gray-900 mb-2 line-clamp-2 hover:text-indigo-600 transition">
|
|
||||||
${escapeHtml(post.title)}
|
|
||||||
</h2>
|
|
||||||
|
|
||||||
<!-- Excerpt -->
|
|
||||||
<p class="text-gray-600 mb-4 line-clamp-3">
|
|
||||||
${escapeHtml(excerpt)}
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<!-- Metadata -->
|
|
||||||
<div class="flex items-center text-sm text-gray-500 space-x-4">
|
|
||||||
<div class="flex items-center">
|
|
||||||
<svg class="h-4 w-4 mr-1" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7V3m8 4V3m-9 8h10M5 21h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"/>
|
|
||||||
</svg>
|
|
||||||
<time datetime="${post.published_at}">${formattedDate}</time>
|
|
||||||
</div>
|
|
||||||
<div class="flex items-center">
|
|
||||||
<svg class="h-4 w-4 mr-1" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z"/>
|
|
||||||
</svg>
|
|
||||||
<span>${readTime} min read</span>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Tags -->
|
|
||||||
${post.tags && post.tags.length > 0 ? `
|
|
||||||
<div class="mt-4 flex flex-wrap gap-1">
|
|
||||||
${post.tags.slice(0, 3).map(tag => `
|
|
||||||
<span class="text-xs bg-gray-100 text-gray-600 px-2 py-1 rounded">
|
|
||||||
${escapeHtml(tag)}
|
|
||||||
</span>
|
|
||||||
`).join('')}
|
|
||||||
${post.tags.length > 3 ? `<span class="text-xs text-gray-500">+${post.tags.length - 3} more</span>` : ''}
|
|
||||||
</div>
|
|
||||||
` : ''}
|
|
||||||
</div>
|
|
||||||
</a>
|
|
||||||
</article>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get category color gradient
|
|
||||||
*/
|
|
||||||
function getCategoryColor(category) {
|
|
||||||
const colorMap = {
|
|
||||||
'Framework Updates': 'from-blue-400 to-blue-600',
|
|
||||||
'Case Studies': 'from-purple-400 to-purple-600',
|
|
||||||
'Research': 'from-green-400 to-green-600',
|
|
||||||
'Implementation': 'from-yellow-400 to-yellow-600',
|
|
||||||
'Community': 'from-pink-400 to-pink-600'
|
|
||||||
};
|
|
||||||
return colorMap[category] || 'from-gray-400 to-gray-600';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render pagination controls
|
|
||||||
*/
|
|
||||||
function renderPagination() {
|
|
||||||
const paginationEl = document.getElementById('pagination');
|
|
||||||
const totalPages = Math.ceil(filteredPosts.length / postsPerPage);
|
|
||||||
|
|
||||||
if (totalPages <= 1) {
|
|
||||||
paginationEl.classList.add('hidden');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
paginationEl.classList.remove('hidden');
|
|
||||||
|
|
||||||
const prevBtn = document.getElementById('prev-page');
|
|
||||||
const nextBtn = document.getElementById('next-page');
|
|
||||||
const pageNumbersEl = document.getElementById('page-numbers');
|
|
||||||
|
|
||||||
// Update prev/next buttons
|
|
||||||
prevBtn.disabled = currentPage === 1;
|
|
||||||
nextBtn.disabled = currentPage === totalPages;
|
|
||||||
|
|
||||||
// Render page numbers
|
|
||||||
let pageNumbersHTML = '';
|
|
||||||
const maxVisiblePages = 5;
|
|
||||||
let startPage = Math.max(1, currentPage - Math.floor(maxVisiblePages / 2));
|
|
||||||
const endPage = Math.min(totalPages, startPage + maxVisiblePages - 1);
|
|
||||||
|
|
||||||
// Adjust start if we're near the end
|
|
||||||
if (endPage - startPage < maxVisiblePages - 1) {
|
|
||||||
startPage = Math.max(1, endPage - maxVisiblePages + 1);
|
|
||||||
}
|
|
||||||
|
|
||||||
// First page + ellipsis
|
|
||||||
if (startPage > 1) {
|
|
||||||
pageNumbersHTML += `
|
|
||||||
<button class="page-number px-3 py-1 border border-gray-300 rounded text-sm" data-page="1">1</button>
|
|
||||||
${startPage > 2 ? '<span class="px-2 text-gray-500">...</span>' : ''}
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Visible page numbers
|
|
||||||
for (let i = startPage; i <= endPage; i++) {
|
|
||||||
const isActive = i === currentPage;
|
|
||||||
pageNumbersHTML += `
|
|
||||||
<button class="page-number px-3 py-1 border ${isActive ? 'bg-indigo-600 text-white border-indigo-600' : 'border-gray-300 text-gray-700 hover:bg-gray-50'} rounded text-sm" data-page="${i}">
|
|
||||||
${i}
|
|
||||||
</button>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Ellipsis + last page
|
|
||||||
if (endPage < totalPages) {
|
|
||||||
pageNumbersHTML += `
|
|
||||||
${endPage < totalPages - 1 ? '<span class="px-2 text-gray-500">...</span>' : ''}
|
|
||||||
<button class="page-number px-3 py-1 border border-gray-300 rounded text-sm" data-page="${totalPages}">${totalPages}</button>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
pageNumbersEl.innerHTML = pageNumbersHTML;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Apply filters and search
|
|
||||||
*/
|
|
||||||
function applyFilters() {
|
|
||||||
// Reset to first page when filters change
|
|
||||||
currentPage = 1;
|
|
||||||
|
|
||||||
// Start with all posts
|
|
||||||
filteredPosts = [...allPosts];
|
|
||||||
|
|
||||||
// Apply search
|
|
||||||
if (activeFilters.search) {
|
|
||||||
const searchLower = activeFilters.search.toLowerCase();
|
|
||||||
filteredPosts = filteredPosts.filter(post => {
|
|
||||||
return (
|
|
||||||
post.title.toLowerCase().includes(searchLower) ||
|
|
||||||
(post.content && post.content.toLowerCase().includes(searchLower)) ||
|
|
||||||
(post.excerpt && post.excerpt.toLowerCase().includes(searchLower)) ||
|
|
||||||
(post.tags && post.tags.some(tag => tag.toLowerCase().includes(searchLower)))
|
|
||||||
);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Apply category filter
|
|
||||||
if (activeFilters.category) {
|
|
||||||
filteredPosts = filteredPosts.filter(post => post.category === activeFilters.category);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Sort
|
|
||||||
sortPosts();
|
|
||||||
|
|
||||||
// Update UI
|
|
||||||
renderPosts();
|
|
||||||
updateResultsCount();
|
|
||||||
updateActiveFiltersDisplay();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Sort posts based on active sort option
|
|
||||||
*/
|
|
||||||
function sortPosts() {
|
|
||||||
switch (activeFilters.sort) {
|
|
||||||
case 'date-desc':
|
|
||||||
filteredPosts.sort((a, b) => new Date(b.published_at) - new Date(a.published_at));
|
|
||||||
break;
|
|
||||||
case 'date-asc':
|
|
||||||
filteredPosts.sort((a, b) => new Date(a.published_at) - new Date(b.published_at));
|
|
||||||
break;
|
|
||||||
case 'title-asc':
|
|
||||||
filteredPosts.sort((a, b) => a.title.localeCompare(b.title));
|
|
||||||
break;
|
|
||||||
case 'title-desc':
|
|
||||||
filteredPosts.sort((a, b) => b.title.localeCompare(a.title));
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update results count display
|
|
||||||
*/
|
|
||||||
function updateResultsCount() {
|
|
||||||
const countEl = document.getElementById('post-count');
|
|
||||||
if (countEl) {
|
|
||||||
countEl.textContent = filteredPosts.length;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update active filters display
|
|
||||||
*/
|
|
||||||
function updateActiveFiltersDisplay() {
|
|
||||||
const activeFiltersEl = document.getElementById('active-filters');
|
|
||||||
const filterTagsEl = document.getElementById('filter-tags');
|
|
||||||
|
|
||||||
const hasActiveFilters = activeFilters.search || activeFilters.category;
|
|
||||||
|
|
||||||
if (!hasActiveFilters) {
|
|
||||||
activeFiltersEl.classList.add('hidden');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
activeFiltersEl.classList.remove('hidden');
|
|
||||||
|
|
||||||
let tagsHTML = '';
|
|
||||||
|
|
||||||
if (activeFilters.search) {
|
|
||||||
tagsHTML += `
|
|
||||||
<span class="inline-flex items-center gap-1 px-3 py-1 bg-indigo-100 text-indigo-800 rounded-full text-sm">
|
|
||||||
Search: "${escapeHtml(activeFilters.search)}"
|
|
||||||
<button class="ml-1 hover:text-indigo-900" data-remove-filter="search">
|
|
||||||
<svg class="h-4 w-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
|
|
||||||
</svg>
|
|
||||||
</button>
|
|
||||||
</span>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (activeFilters.category) {
|
|
||||||
tagsHTML += `
|
|
||||||
<span class="inline-flex items-center gap-1 px-3 py-1 bg-indigo-100 text-indigo-800 rounded-full text-sm">
|
|
||||||
Category: ${escapeHtml(activeFilters.category)}
|
|
||||||
<button class="ml-1 hover:text-indigo-900" data-remove-filter="category">
|
|
||||||
<svg class="h-4 w-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
|
|
||||||
</svg>
|
|
||||||
</button>
|
|
||||||
</span>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
filterTagsEl.innerHTML = tagsHTML;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Clear all filters
|
|
||||||
*/
|
|
||||||
function clearFilters() {
|
|
||||||
activeFilters.search = '';
|
|
||||||
activeFilters.category = '';
|
|
||||||
|
|
||||||
// Reset UI elements
|
|
||||||
document.getElementById('search-input').value = '';
|
|
||||||
document.getElementById('category-filter').value = '';
|
|
||||||
|
|
||||||
// Reapply filters
|
|
||||||
applyFilters();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Remove specific filter
|
|
||||||
*/
|
|
||||||
function removeFilter(filterType) {
|
|
||||||
if (filterType === 'search') {
|
|
||||||
activeFilters.search = '';
|
|
||||||
document.getElementById('search-input').value = '';
|
|
||||||
} else if (filterType === 'category') {
|
|
||||||
activeFilters.category = '';
|
|
||||||
document.getElementById('category-filter').value = '';
|
|
||||||
}
|
|
||||||
|
|
||||||
applyFilters();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Attach event listeners
|
|
||||||
*/
|
|
||||||
function attachEventListeners() {
|
|
||||||
// Search input (debounced)
|
|
||||||
const searchInput = document.getElementById('search-input');
|
|
||||||
let searchTimeout;
|
|
||||||
searchInput.addEventListener('input', e => {
|
|
||||||
clearTimeout(searchTimeout);
|
|
||||||
searchTimeout = setTimeout(() => {
|
|
||||||
activeFilters.search = e.target.value.trim();
|
|
||||||
applyFilters();
|
|
||||||
}, 300);
|
|
||||||
});
|
|
||||||
|
|
||||||
// Category filter
|
|
||||||
const categoryFilter = document.getElementById('category-filter');
|
|
||||||
categoryFilter.addEventListener('change', e => {
|
|
||||||
activeFilters.category = e.target.value;
|
|
||||||
applyFilters();
|
|
||||||
});
|
|
||||||
|
|
||||||
// Sort select
|
|
||||||
const sortSelect = document.getElementById('sort-select');
|
|
||||||
sortSelect.addEventListener('change', e => {
|
|
||||||
activeFilters.sort = e.target.value;
|
|
||||||
applyFilters();
|
|
||||||
});
|
|
||||||
|
|
||||||
// Clear filters button
|
|
||||||
const clearFiltersBtn = document.getElementById('clear-filters');
|
|
||||||
clearFiltersBtn.addEventListener('click', clearFilters);
|
|
||||||
|
|
||||||
// Pagination - prev/next buttons
|
|
||||||
const prevBtn = document.getElementById('prev-page');
|
|
||||||
const nextBtn = document.getElementById('next-page');
|
|
||||||
|
|
||||||
prevBtn.addEventListener('click', () => {
|
|
||||||
if (currentPage > 1) {
|
|
||||||
currentPage--;
|
|
||||||
renderPosts();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
nextBtn.addEventListener('click', () => {
|
|
||||||
const totalPages = Math.ceil(filteredPosts.length / postsPerPage);
|
|
||||||
if (currentPage < totalPages) {
|
|
||||||
currentPage++;
|
|
||||||
renderPosts();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Pagination - page numbers (event delegation)
|
|
||||||
const pageNumbersEl = document.getElementById('page-numbers');
|
|
||||||
pageNumbersEl.addEventListener('click', e => {
|
|
||||||
const pageBtn = e.target.closest('.page-number');
|
|
||||||
if (pageBtn) {
|
|
||||||
currentPage = parseInt(pageBtn.dataset.page, 10);
|
|
||||||
renderPosts();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Remove filter tags (event delegation)
|
|
||||||
const filterTagsEl = document.getElementById('filter-tags');
|
|
||||||
filterTagsEl.addEventListener('click', e => {
|
|
||||||
const removeBtn = e.target.closest('[data-remove-filter]');
|
|
||||||
if (removeBtn) {
|
|
||||||
const filterType = removeBtn.dataset.removeFilter;
|
|
||||||
removeFilter(filterType);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Show error message
|
|
||||||
*/
|
|
||||||
function showError(message) {
|
|
||||||
const gridEl = document.getElementById('blog-grid');
|
|
||||||
gridEl.innerHTML = `
|
|
||||||
<div class="col-span-full bg-red-50 border border-red-200 rounded-lg p-6">
|
|
||||||
<div class="flex items-start">
|
|
||||||
<svg class="h-6 w-6 text-red-600 mr-3 mt-0.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
|
|
||||||
</svg>
|
|
||||||
<div>
|
|
||||||
<h3 class="text-lg font-semibold text-red-900 mb-2">Error</h3>
|
|
||||||
<p class="text-red-700">${escapeHtml(message)}</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Escape HTML to prevent XSS
|
|
||||||
*/
|
|
||||||
function escapeHtml(text) {
|
|
||||||
if (!text) return '';
|
|
||||||
const div = document.createElement('div');
|
|
||||||
div.textContent = text;
|
|
||||||
return div.innerHTML;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Newsletter Modal Functionality
|
|
||||||
*/
|
|
||||||
function setupNewsletterModal() {
|
|
||||||
const modal = document.getElementById('newsletter-modal');
|
|
||||||
const openBtn = document.getElementById('open-newsletter-modal');
|
|
||||||
const closeBtn = document.getElementById('close-newsletter-modal');
|
|
||||||
const cancelBtn = document.getElementById('cancel-newsletter');
|
|
||||||
const form = document.getElementById('newsletter-form');
|
|
||||||
const successMsg = document.getElementById('newsletter-success');
|
|
||||||
const errorMsg = document.getElementById('newsletter-error');
|
|
||||||
const errorText = document.getElementById('newsletter-error-message');
|
|
||||||
const submitBtn = document.getElementById('newsletter-submit');
|
|
||||||
|
|
||||||
// Open modal
|
|
||||||
if (openBtn) {
|
|
||||||
openBtn.addEventListener('click', () => {
|
|
||||||
modal.classList.remove('hidden');
|
|
||||||
document.getElementById('newsletter-email').focus();
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Close modal
|
|
||||||
function closeModal() {
|
|
||||||
modal.classList.add('hidden');
|
|
||||||
form.reset();
|
|
||||||
successMsg.classList.add('hidden');
|
|
||||||
errorMsg.classList.add('hidden');
|
|
||||||
}
|
|
||||||
|
|
||||||
if (closeBtn) {
|
|
||||||
closeBtn.addEventListener('click', closeModal);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (cancelBtn) {
|
|
||||||
cancelBtn.addEventListener('click', closeModal);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Close on backdrop click
|
|
||||||
modal.addEventListener('click', (e) => {
|
|
||||||
if (e.target === modal) {
|
|
||||||
closeModal();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Close on Escape key
|
|
||||||
document.addEventListener('keydown', (e) => {
|
|
||||||
if (e.key === 'Escape' && !modal.classList.contains('hidden')) {
|
|
||||||
closeModal();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Handle form submission
|
|
||||||
if (form) {
|
|
||||||
form.addEventListener('submit', async (e) => {
|
|
||||||
e.preventDefault();
|
|
||||||
|
|
||||||
// Reset messages
|
|
||||||
successMsg.classList.add('hidden');
|
|
||||||
errorMsg.classList.add('hidden');
|
|
||||||
|
|
||||||
const email = document.getElementById('newsletter-email').value;
|
|
||||||
const name = document.getElementById('newsletter-name').value;
|
|
||||||
|
|
||||||
// Disable submit button
|
|
||||||
submitBtn.disabled = true;
|
|
||||||
submitBtn.textContent = 'Subscribing...';
|
|
||||||
|
|
||||||
try {
|
|
||||||
const response = await fetch('/api/newsletter/subscribe', {
|
|
||||||
method: 'POST',
|
|
||||||
headers: {
|
|
||||||
'Content-Type': 'application/json'
|
|
||||||
},
|
|
||||||
body: JSON.stringify({
|
|
||||||
email,
|
|
||||||
name: name || null,
|
|
||||||
source: 'blog'
|
|
||||||
})
|
|
||||||
});
|
|
||||||
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (response.ok && data.success) {
|
|
||||||
// Show success message
|
|
||||||
successMsg.classList.remove('hidden');
|
|
||||||
form.reset();
|
|
||||||
|
|
||||||
// Close modal after 2 seconds
|
|
||||||
setTimeout(() => {
|
|
||||||
closeModal();
|
|
||||||
}, 2000);
|
|
||||||
} else {
|
|
||||||
// Show error message
|
|
||||||
errorText.textContent = data.error || 'Failed to subscribe. Please try again.';
|
|
||||||
errorMsg.classList.remove('hidden');
|
|
||||||
}
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Newsletter subscription error:', error);
|
|
||||||
errorText.textContent = 'Network error. Please check your connection and try again.';
|
|
||||||
errorMsg.classList.remove('hidden');
|
|
||||||
} finally {
|
|
||||||
// Re-enable submit button
|
|
||||||
submitBtn.disabled = false;
|
|
||||||
submitBtn.textContent = 'Subscribe';
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Initialize on page load
|
|
||||||
document.addEventListener('DOMContentLoaded', () => {
|
|
||||||
init();
|
|
||||||
setupNewsletterModal();
|
|
||||||
});
|
|
||||||
|
|
@ -1,78 +0,0 @@
|
||||||
/**
|
|
||||||
* Case Submission Form Handler
|
|
||||||
*/
|
|
||||||
|
|
||||||
const form = document.getElementById('case-submission-form');
|
|
||||||
const submitButton = document.getElementById('submit-button');
|
|
||||||
const successMessage = document.getElementById('success-message');
|
|
||||||
const errorMessage = document.getElementById('error-message');
|
|
||||||
|
|
||||||
form.addEventListener('submit', async (e) => {
|
|
||||||
e.preventDefault();
|
|
||||||
|
|
||||||
// Hide previous messages
|
|
||||||
successMessage.style.display = 'none';
|
|
||||||
errorMessage.style.display = 'none';
|
|
||||||
|
|
||||||
// Disable submit button
|
|
||||||
submitButton.disabled = true;
|
|
||||||
submitButton.textContent = 'Submitting...';
|
|
||||||
|
|
||||||
// Collect form data
|
|
||||||
const evidenceText = document.getElementById('case-evidence').value;
|
|
||||||
const evidence = evidenceText
|
|
||||||
? evidenceText.split('\n').filter(line => line.trim())
|
|
||||||
: [];
|
|
||||||
|
|
||||||
const formData = {
|
|
||||||
submitter: {
|
|
||||||
name: document.getElementById('submitter-name').value,
|
|
||||||
email: document.getElementById('submitter-email').value,
|
|
||||||
organization: document.getElementById('submitter-organization').value || null,
|
|
||||||
public: document.getElementById('submitter-public').checked
|
|
||||||
},
|
|
||||||
case_study: {
|
|
||||||
title: document.getElementById('case-title').value,
|
|
||||||
description: document.getElementById('case-description').value,
|
|
||||||
failure_mode: document.getElementById('case-failure-mode').value,
|
|
||||||
tractatus_applicability: document.getElementById('case-tractatus').value,
|
|
||||||
evidence: evidence,
|
|
||||||
attachments: []
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
try {
|
|
||||||
const response = await fetch('/api/cases/submit', {
|
|
||||||
method: 'POST',
|
|
||||||
headers: {
|
|
||||||
'Content-Type': 'application/json'
|
|
||||||
},
|
|
||||||
body: JSON.stringify(formData)
|
|
||||||
});
|
|
||||||
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (response.ok) {
|
|
||||||
// Success
|
|
||||||
successMessage.textContent = data.message || 'Thank you for your submission. We will review it shortly.';
|
|
||||||
successMessage.style.display = 'block';
|
|
||||||
form.reset();
|
|
||||||
window.scrollTo({ top: 0, behavior: 'smooth' });
|
|
||||||
} else {
|
|
||||||
// Error
|
|
||||||
errorMessage.textContent = data.message || 'An error occurred. Please try again.';
|
|
||||||
errorMessage.style.display = 'block';
|
|
||||||
window.scrollTo({ top: 0, behavior: 'smooth' });
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Submit error:', error);
|
|
||||||
errorMessage.textContent = 'Network error. Please check your connection and try again.';
|
|
||||||
errorMessage.style.display = 'block';
|
|
||||||
window.scrollTo({ top: 0, behavior: 'smooth' });
|
|
||||||
} finally {
|
|
||||||
// Re-enable submit button
|
|
||||||
submitButton.disabled = false;
|
|
||||||
submitButton.textContent = 'Submit Case Study';
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
@ -1,60 +0,0 @@
|
||||||
/**
|
|
||||||
* Version Check Script
|
|
||||||
* Tests if browser is using cached JavaScript files
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Get the version from the main docs page
|
|
||||||
fetch('/docs.html?' + Date.now())
|
|
||||||
.then(r => r.text())
|
|
||||||
.then(html => {
|
|
||||||
const match = html.match(/docs-app\.js\?v=(\d+)/);
|
|
||||||
const version = match ? match[1] : 'NOT FOUND';
|
|
||||||
|
|
||||||
const expected = '1759828916';
|
|
||||||
const correct = version === expected;
|
|
||||||
|
|
||||||
// Now fetch the actual JavaScript
|
|
||||||
return fetch('/js/docs-app.js?v=' + version + '&' + Date.now())
|
|
||||||
.then(r => r.text())
|
|
||||||
.then(js => {
|
|
||||||
const hasNewHandler = js.includes('window.location.href=');
|
|
||||||
const hasOldHandler = js.includes('event.stopPropagation()');
|
|
||||||
|
|
||||||
let html = '';
|
|
||||||
|
|
||||||
if (correct && hasNewHandler) {
|
|
||||||
html = `
|
|
||||||
<div class="box good">
|
|
||||||
<h2>✅ Version is CORRECT</h2>
|
|
||||||
<p>JavaScript version: <code>${version}</code></p>
|
|
||||||
<p>Handler includes: <code>window.location.href</code></p>
|
|
||||||
<p><strong>Downloads should work now!</strong></p>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
} else {
|
|
||||||
html = `
|
|
||||||
<div class="box bad">
|
|
||||||
<h2>❌ Version is WRONG</h2>
|
|
||||||
<p>JavaScript version loaded: <code>${version}</code></p>
|
|
||||||
<p>Expected: <code>${expected}</code></p>
|
|
||||||
<p>Has new handler: ${hasNewHandler ? '✅ YES' : '❌ NO'}</p>
|
|
||||||
<p><strong>Your browser is serving cached files!</strong></p>
|
|
||||||
</div>
|
|
||||||
<div class="box">
|
|
||||||
<h3>Cached JavaScript Snippet:</h3>
|
|
||||||
<pre>${js.substring(js.indexOf('onclick='), js.indexOf('onclick=') + 200).replace(/</g, '<').replace(/>/g, '>')}</pre>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
document.getElementById('results').innerHTML = html;
|
|
||||||
});
|
|
||||||
})
|
|
||||||
.catch(err => {
|
|
||||||
document.getElementById('results').innerHTML = `
|
|
||||||
<div class="box bad">
|
|
||||||
<h2>Error</h2>
|
|
||||||
<p>${err.message}</p>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
});
|
|
||||||
|
|
@ -1,307 +0,0 @@
|
||||||
/**
|
|
||||||
* Framework Activity Timeline
|
|
||||||
* Tractatus Framework - Phase 3: Data Visualization
|
|
||||||
*
|
|
||||||
* Visual timeline showing framework component interactions
|
|
||||||
* Color-coded by service
|
|
||||||
*/
|
|
||||||
|
|
||||||
class ActivityTimeline {
|
|
||||||
constructor(containerId) {
|
|
||||||
this.container = document.getElementById(containerId);
|
|
||||||
if (!this.container) {
|
|
||||||
console.error(`[ActivityTimeline] Container #${containerId} not found`);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
this.currentPath = 'fast'; // Default to fast path
|
|
||||||
|
|
||||||
// Define three execution paths with realistic timings
|
|
||||||
this.pathProfiles = {
|
|
||||||
fast: {
|
|
||||||
name: 'Fast Path',
|
|
||||||
description: 'Simple request, all checks pass',
|
|
||||||
totalTime: '65ms',
|
|
||||||
events: [
|
|
||||||
{ time: '0ms', timeMs: 0, service: 'instruction', name: 'InstructionPersistence', action: 'Load cached instructions', color: '#4338ca' },
|
|
||||||
{ time: '5ms', timeMs: 5, service: 'validator', name: 'CrossReferenceValidator', action: 'Quick validation check', color: '#6d28d9' },
|
|
||||||
{ time: '15ms', timeMs: 15, service: 'boundary', name: 'BoundaryEnforcer', action: 'Auto-approved operation', color: '#047857' },
|
|
||||||
{ time: '25ms', timeMs: 25, service: 'pressure', name: 'ContextPressureMonitor', action: 'Normal pressure detected', color: '#b45309' },
|
|
||||||
{ time: '50ms', timeMs: 50, service: 'validator', name: 'CrossReferenceValidator', action: 'Final validation', color: '#6d28d9' },
|
|
||||||
{ time: '65ms', timeMs: 65, service: 'pressure', name: 'ContextPressureMonitor', action: 'Update metrics', color: '#b45309' }
|
|
||||||
]
|
|
||||||
},
|
|
||||||
standard: {
|
|
||||||
name: 'Standard Path',
|
|
||||||
description: 'Needs validation and verification',
|
|
||||||
totalTime: '135ms',
|
|
||||||
events: [
|
|
||||||
{ time: '0ms', timeMs: 0, service: 'instruction', name: 'InstructionPersistence', action: 'Load HIGH persistence instructions', color: '#4338ca' },
|
|
||||||
{ time: '8ms', timeMs: 8, service: 'validator', name: 'CrossReferenceValidator', action: 'Verify against instruction history', color: '#6d28d9' },
|
|
||||||
{ time: '30ms', timeMs: 30, service: 'boundary', name: 'BoundaryEnforcer', action: 'Check approval requirements', color: '#047857' },
|
|
||||||
{ time: '55ms', timeMs: 55, service: 'pressure', name: 'ContextPressureMonitor', action: 'Calculate pressure level', color: '#b45309' },
|
|
||||||
{ time: '95ms', timeMs: 95, service: 'metacognitive', name: 'MetacognitiveVerifier', action: 'Verify operation alignment', color: '#be185d' },
|
|
||||||
{ time: '120ms', timeMs: 120, service: 'validator', name: 'CrossReferenceValidator', action: 'Final validation check', color: '#6d28d9' },
|
|
||||||
{ time: '135ms', timeMs: 135, service: 'pressure', name: 'ContextPressureMonitor', action: 'Update pressure metrics', color: '#b45309' }
|
|
||||||
]
|
|
||||||
},
|
|
||||||
complex: {
|
|
||||||
name: 'Complex Path',
|
|
||||||
description: 'Requires deliberation and consensus',
|
|
||||||
totalTime: '285ms',
|
|
||||||
events: [
|
|
||||||
{ time: '0ms', timeMs: 0, service: 'instruction', name: 'InstructionPersistence', action: 'Load HIGH persistence instructions', color: '#4338ca' },
|
|
||||||
{ time: '8ms', timeMs: 8, service: 'validator', name: 'CrossReferenceValidator', action: 'Verify request against instruction history', color: '#6d28d9' },
|
|
||||||
{ time: '35ms', timeMs: 35, service: 'boundary', name: 'BoundaryEnforcer', action: 'Check if request requires human approval', color: '#047857' },
|
|
||||||
{ time: '60ms', timeMs: 60, service: 'pressure', name: 'ContextPressureMonitor', action: 'Calculate current pressure level', color: '#b45309' },
|
|
||||||
{ time: '105ms', timeMs: 105, service: 'metacognitive', name: 'MetacognitiveVerifier', action: 'Verify operation alignment', color: '#be185d' },
|
|
||||||
{ time: '160ms', timeMs: 160, service: 'deliberation', name: 'PluralisticDeliberation', action: 'Coordinate stakeholder perspectives', color: '#0f766e' },
|
|
||||||
{ time: '255ms', timeMs: 255, service: 'validator', name: 'CrossReferenceValidator', action: 'Final validation check', color: '#6d28d9' },
|
|
||||||
{ time: '285ms', timeMs: 285, service: 'pressure', name: 'ContextPressureMonitor', action: 'Update pressure metrics', color: '#b45309' }
|
|
||||||
]
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
// Initialize with fast path by default
|
|
||||||
this.events = this.pathProfiles[this.currentPath].events;
|
|
||||||
|
|
||||||
this.init();
|
|
||||||
}
|
|
||||||
|
|
||||||
init() {
|
|
||||||
this.render();
|
|
||||||
this.isSimulating = false;
|
|
||||||
console.log('[ActivityTimeline] Initialized');
|
|
||||||
}
|
|
||||||
|
|
||||||
render() {
|
|
||||||
const eventsHTML = this.events.map((event, index) => `
|
|
||||||
<div class="timeline-event flex items-start space-x-4 p-4 bg-white rounded-lg border-2 border-gray-200 hover:shadow-md cursor-pointer transition-all duration-300"
|
|
||||||
data-service="${event.service}"
|
|
||||||
data-event-index="${index}">
|
|
||||||
<div class="flex-shrink-0 w-16 text-right">
|
|
||||||
<span class="text-sm font-semibold text-gray-600 event-time">${event.time}</span>
|
|
||||||
</div>
|
|
||||||
<div class="flex-shrink-0">
|
|
||||||
<div class="w-3 h-3 rounded-full service-dot transition-all duration-300" data-color="${event.color}"></div>
|
|
||||||
</div>
|
|
||||||
<div class="flex-1">
|
|
||||||
<div class="text-sm font-semibold text-gray-900 service-name transition-colors duration-300" data-color="${event.color}">
|
|
||||||
${event.name}
|
|
||||||
</div>
|
|
||||||
<div class="text-xs text-gray-600 mt-1 event-action">${event.action}</div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`).join('');
|
|
||||||
|
|
||||||
const currentProfile = this.pathProfiles[this.currentPath];
|
|
||||||
|
|
||||||
this.container.innerHTML = `
|
|
||||||
<div class="activity-timeline-container">
|
|
||||||
<div class="mb-4">
|
|
||||||
<h2 class="text-lg font-semibold text-gray-900">Governance Flow</h2>
|
|
||||||
<p class="text-xs text-gray-500 mt-1 italic">Estimated timing based on current performance data</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Path Selection -->
|
|
||||||
<div class="mb-4 p-3 bg-gray-50 border border-gray-300 rounded-lg">
|
|
||||||
<div class="text-xs font-semibold text-gray-700 mb-2">Execution Path:</div>
|
|
||||||
<div class="flex flex-col sm:flex-row gap-2">
|
|
||||||
<label class="flex items-center gap-2 cursor-pointer">
|
|
||||||
<input type="radio" name="path" value="fast" ${this.currentPath === 'fast' ? 'checked' : ''} class="path-radio">
|
|
||||||
<span class="text-sm font-medium text-gray-900">Fast</span>
|
|
||||||
<span class="text-xs text-gray-600">(${this.pathProfiles.fast.totalTime})</span>
|
|
||||||
</label>
|
|
||||||
<label class="flex items-center gap-2 cursor-pointer">
|
|
||||||
<input type="radio" name="path" value="standard" ${this.currentPath === 'standard' ? 'checked' : ''} class="path-radio">
|
|
||||||
<span class="text-sm font-medium text-gray-900">Standard</span>
|
|
||||||
<span class="text-xs text-gray-600">(${this.pathProfiles.standard.totalTime})</span>
|
|
||||||
</label>
|
|
||||||
<label class="flex items-center gap-2 cursor-pointer">
|
|
||||||
<input type="radio" name="path" value="complex" ${this.currentPath === 'complex' ? 'checked' : ''} class="path-radio">
|
|
||||||
<span class="text-sm font-medium text-gray-900">Complex</span>
|
|
||||||
<span class="text-xs text-gray-600">(${this.pathProfiles.complex.totalTime})</span>
|
|
||||||
</label>
|
|
||||||
</div>
|
|
||||||
<div class="text-xs text-gray-600 mt-2">${currentProfile.description}</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Timeline Explanation -->
|
|
||||||
<div class="mb-4 p-3 bg-blue-50 border border-blue-200 rounded-lg">
|
|
||||||
<p class="text-sm text-gray-700 leading-relaxed mb-2">
|
|
||||||
This shows the framework's governance components working together to validate and process each request. Each component has a specific role in ensuring safe, values-aligned AI operation.
|
|
||||||
</p>
|
|
||||||
<p class="text-xs text-gray-600 italic">
|
|
||||||
Note: Timing values are estimates based on current performance statistics and may vary in production.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<div class="space-y-3">
|
|
||||||
${eventsHTML}
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<div class="mt-6 text-xs text-gray-500 text-center">
|
|
||||||
Total processing time: ${currentProfile.totalTime} | All services coordinated
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
|
|
||||||
// Apply colors via JavaScript (CSP-compliant)
|
|
||||||
this.applyColors();
|
|
||||||
|
|
||||||
// Attach event listeners to path radio buttons
|
|
||||||
this.attachPathListeners();
|
|
||||||
}
|
|
||||||
|
|
||||||
attachPathListeners() {
|
|
||||||
const radios = this.container.querySelectorAll('.path-radio');
|
|
||||||
radios.forEach(radio => {
|
|
||||||
radio.addEventListener('change', (e) => {
|
|
||||||
this.setPath(e.target.value);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
setPath(pathName) {
|
|
||||||
if (!this.pathProfiles[pathName]) {
|
|
||||||
console.error(`[ActivityTimeline] Unknown path: ${pathName}`);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
console.log(`[ActivityTimeline] Switching to ${pathName} path`);
|
|
||||||
this.currentPath = pathName;
|
|
||||||
this.events = this.pathProfiles[pathName].events;
|
|
||||||
this.render();
|
|
||||||
}
|
|
||||||
|
|
||||||
applyColors() {
|
|
||||||
document.querySelectorAll('.service-dot').forEach(dot => {
|
|
||||||
const color = dot.getAttribute('data-color');
|
|
||||||
dot.style.backgroundColor = color;
|
|
||||||
});
|
|
||||||
|
|
||||||
document.querySelectorAll('.service-name').forEach(name => {
|
|
||||||
const color = name.getAttribute('data-color');
|
|
||||||
name.style.color = color;
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
activateEvent(index) {
|
|
||||||
const eventElement = this.container.querySelector(`[data-event-index="${index}"]`);
|
|
||||||
if (!eventElement) return;
|
|
||||||
|
|
||||||
const event = this.events[index];
|
|
||||||
|
|
||||||
// Highlight the event card
|
|
||||||
eventElement.style.borderColor = event.color;
|
|
||||||
eventElement.style.backgroundColor = `${event.color}10`; // 10% opacity
|
|
||||||
eventElement.style.boxShadow = `0 4px 12px ${event.color}40`;
|
|
||||||
|
|
||||||
// Enlarge and pulse the service dot
|
|
||||||
const dot = eventElement.querySelector('.service-dot');
|
|
||||||
if (dot) {
|
|
||||||
dot.style.width = '12px';
|
|
||||||
dot.style.height = '12px';
|
|
||||||
dot.style.boxShadow = `0 0 8px ${event.color}`;
|
|
||||||
}
|
|
||||||
|
|
||||||
console.log(`[ActivityTimeline] Activated event ${index}: ${event.name}`);
|
|
||||||
}
|
|
||||||
|
|
||||||
deactivateEvent(index) {
|
|
||||||
const eventElement = this.container.querySelector(`[data-event-index="${index}"]`);
|
|
||||||
if (!eventElement) return;
|
|
||||||
|
|
||||||
// Reset to default styling
|
|
||||||
eventElement.style.borderColor = '#e5e7eb';
|
|
||||||
eventElement.style.backgroundColor = '#ffffff';
|
|
||||||
eventElement.style.boxShadow = '';
|
|
||||||
|
|
||||||
// Reset service dot
|
|
||||||
const dot = eventElement.querySelector('.service-dot');
|
|
||||||
if (dot) {
|
|
||||||
dot.style.width = '12px';
|
|
||||||
dot.style.height = '12px';
|
|
||||||
dot.style.boxShadow = '';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async simulateFlow() {
|
|
||||||
if (this.isSimulating) {
|
|
||||||
console.log('[ActivityTimeline] Already simulating, ignoring request');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
this.isSimulating = true;
|
|
||||||
console.log('[ActivityTimeline] Starting governance flow simulation');
|
|
||||||
|
|
||||||
// Reset all events first
|
|
||||||
for (let i = 0; i < this.events.length; i++) {
|
|
||||||
this.deactivateEvent(i);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Simulate each event activation with realistic timing
|
|
||||||
for (let i = 0; i < this.events.length; i++) {
|
|
||||||
const event = this.events[i];
|
|
||||||
const prevEvent = i > 0 ? this.events[i - 1] : null;
|
|
||||||
|
|
||||||
// Calculate actual delay based on event timing (scaled 2x for visibility)
|
|
||||||
const delay = prevEvent ? (event.timeMs - prevEvent.timeMs) * 2 : 0;
|
|
||||||
|
|
||||||
await new Promise(resolve => setTimeout(resolve, delay));
|
|
||||||
|
|
||||||
// Deactivate previous event
|
|
||||||
if (i > 0) {
|
|
||||||
this.deactivateEvent(i - 1);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Activate current event
|
|
||||||
this.activateEvent(i);
|
|
||||||
console.log(`[ActivityTimeline] Event ${i} activated at ${event.time} (delay: ${delay}ms)`);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Keep the last event active for a moment, then deactivate
|
|
||||||
await new Promise(resolve => setTimeout(resolve, 800));
|
|
||||||
this.deactivateEvent(this.events.length - 1);
|
|
||||||
|
|
||||||
this.isSimulating = false;
|
|
||||||
console.log('[ActivityTimeline] Governance flow simulation complete');
|
|
||||||
}
|
|
||||||
|
|
||||||
reset() {
|
|
||||||
console.log('[ActivityTimeline] Resetting timeline');
|
|
||||||
for (let i = 0; i < this.events.length; i++) {
|
|
||||||
this.deactivateEvent(i);
|
|
||||||
}
|
|
||||||
this.isSimulating = false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Auto-initialize if container exists
|
|
||||||
if (typeof window !== 'undefined') {
|
|
||||||
function initActivityTimeline() {
|
|
||||||
console.log('[ActivityTimeline] Attempting to initialize, readyState:', document.readyState);
|
|
||||||
const container = document.getElementById('activity-timeline');
|
|
||||||
if (container) {
|
|
||||||
console.log('[ActivityTimeline] Container found, creating instance');
|
|
||||||
window.activityTimeline = new ActivityTimeline('activity-timeline');
|
|
||||||
} else {
|
|
||||||
console.error('[ActivityTimeline] Container #activity-timeline not found in DOM');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Initialize immediately if DOM is already loaded, otherwise wait for DOMContentLoaded
|
|
||||||
console.log('[ActivityTimeline] Script loaded, readyState:', document.readyState);
|
|
||||||
if (document.readyState === 'loading') {
|
|
||||||
console.log('[ActivityTimeline] Waiting for DOMContentLoaded');
|
|
||||||
document.addEventListener('DOMContentLoaded', initActivityTimeline);
|
|
||||||
} else {
|
|
||||||
console.log('[ActivityTimeline] DOM already loaded, initializing immediately');
|
|
||||||
initActivityTimeline();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Export for module systems
|
|
||||||
if (typeof module !== 'undefined' && module.exports) {
|
|
||||||
module.exports = ActivityTimeline;
|
|
||||||
}
|
|
||||||
|
|
@ -1,179 +0,0 @@
|
||||||
/**
|
|
||||||
* Code Copy Button Component
|
|
||||||
* Tractatus Framework - Phase 3: Interactive Documentation
|
|
||||||
*
|
|
||||||
* Adds "Copy" buttons to all code blocks for easy copying
|
|
||||||
* Shows success feedback on copy
|
|
||||||
*/
|
|
||||||
|
|
||||||
class CodeCopyButtons {
|
|
||||||
constructor() {
|
|
||||||
this.buttonClass = 'code-copy-btn';
|
|
||||||
this.successClass = 'code-copy-success';
|
|
||||||
this.init();
|
|
||||||
}
|
|
||||||
|
|
||||||
init() {
|
|
||||||
// Wait for DOM to be ready
|
|
||||||
if (document.readyState === 'loading') {
|
|
||||||
document.addEventListener('DOMContentLoaded', () => this.addCopyButtons());
|
|
||||||
} else {
|
|
||||||
this.addCopyButtons();
|
|
||||||
}
|
|
||||||
|
|
||||||
console.log('[CodeCopyButtons] Initialized');
|
|
||||||
}
|
|
||||||
|
|
||||||
addCopyButtons() {
|
|
||||||
// Find all code blocks (pre elements)
|
|
||||||
const codeBlocks = document.querySelectorAll('pre');
|
|
||||||
console.log(`[CodeCopyButtons] Found ${codeBlocks.length} code blocks`);
|
|
||||||
|
|
||||||
codeBlocks.forEach((pre, index) => {
|
|
||||||
// Skip if already has a copy button
|
|
||||||
if (pre.querySelector(`.${this.buttonClass}`)) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Make pre relative positioned for absolute button
|
|
||||||
pre.style.position = 'relative';
|
|
||||||
|
|
||||||
// Create copy button
|
|
||||||
const button = this.createCopyButton(pre, index);
|
|
||||||
|
|
||||||
// Add button to pre element
|
|
||||||
pre.appendChild(button);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
createCopyButton(pre, index) {
|
|
||||||
const button = document.createElement('button');
|
|
||||||
button.className = `${this.buttonClass} absolute top-2 right-2 px-3 py-1 text-xs font-medium rounded transition-all duration-200`;
|
|
||||||
button.style.cssText = `
|
|
||||||
background: rgba(255, 255, 255, 0.1);
|
|
||||||
color: #e5e7eb;
|
|
||||||
border: 1px solid rgba(255, 255, 255, 0.2);
|
|
||||||
`;
|
|
||||||
button.textContent = 'Copy';
|
|
||||||
button.setAttribute('aria-label', 'Copy code to clipboard');
|
|
||||||
button.setAttribute('data-code-index', index);
|
|
||||||
|
|
||||||
// Add hover styles via class
|
|
||||||
button.addEventListener('mouseenter', () => {
|
|
||||||
button.style.background = 'rgba(255, 255, 255, 0.2)';
|
|
||||||
});
|
|
||||||
|
|
||||||
button.addEventListener('mouseleave', () => {
|
|
||||||
if (!button.classList.contains(this.successClass)) {
|
|
||||||
button.style.background = 'rgba(255, 255, 255, 0.1)';
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Add click handler
|
|
||||||
button.addEventListener('click', (e) => {
|
|
||||||
e.preventDefault();
|
|
||||||
e.stopPropagation();
|
|
||||||
this.copyCode(pre, button);
|
|
||||||
});
|
|
||||||
|
|
||||||
return button;
|
|
||||||
}
|
|
||||||
|
|
||||||
async copyCode(pre, button) {
|
|
||||||
// Get code content (find code element inside pre)
|
|
||||||
const codeElement = pre.querySelector('code');
|
|
||||||
const code = codeElement ? codeElement.textContent : pre.textContent;
|
|
||||||
|
|
||||||
try {
|
|
||||||
// Use Clipboard API
|
|
||||||
await navigator.clipboard.writeText(code);
|
|
||||||
|
|
||||||
// Show success feedback
|
|
||||||
this.showSuccess(button);
|
|
||||||
|
|
||||||
console.log('[CodeCopyButtons] Code copied to clipboard');
|
|
||||||
} catch (err) {
|
|
||||||
console.error('[CodeCopyButtons] Failed to copy code:', err);
|
|
||||||
|
|
||||||
// Fallback: try using execCommand
|
|
||||||
this.fallbackCopy(code, button);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
fallbackCopy(text, button) {
|
|
||||||
// Create temporary textarea
|
|
||||||
const textarea = document.createElement('textarea');
|
|
||||||
textarea.value = text;
|
|
||||||
textarea.style.position = 'fixed';
|
|
||||||
textarea.style.opacity = '0';
|
|
||||||
document.body.appendChild(textarea);
|
|
||||||
|
|
||||||
try {
|
|
||||||
textarea.select();
|
|
||||||
const successful = document.execCommand('copy');
|
|
||||||
|
|
||||||
if (successful) {
|
|
||||||
this.showSuccess(button);
|
|
||||||
console.log('[CodeCopyButtons] Code copied using fallback method');
|
|
||||||
} else {
|
|
||||||
this.showError(button);
|
|
||||||
}
|
|
||||||
} catch (err) {
|
|
||||||
console.error('[CodeCopyButtons] Fallback copy failed:', err);
|
|
||||||
this.showError(button);
|
|
||||||
} finally {
|
|
||||||
document.body.removeChild(textarea);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
showSuccess(button) {
|
|
||||||
button.classList.add(this.successClass);
|
|
||||||
button.textContent = '✓ Copied!';
|
|
||||||
button.style.background = 'rgba(16, 185, 129, 0.3)'; // Green
|
|
||||||
button.style.borderColor = 'rgba(16, 185, 129, 0.5)';
|
|
||||||
button.style.color = '#d1fae5';
|
|
||||||
|
|
||||||
// Reset after 2 seconds
|
|
||||||
setTimeout(() => {
|
|
||||||
button.classList.remove(this.successClass);
|
|
||||||
button.textContent = 'Copy';
|
|
||||||
button.style.background = 'rgba(255, 255, 255, 0.1)';
|
|
||||||
button.style.borderColor = 'rgba(255, 255, 255, 0.2)';
|
|
||||||
button.style.color = '#e5e7eb';
|
|
||||||
}, 2000);
|
|
||||||
}
|
|
||||||
|
|
||||||
showError(button) {
|
|
||||||
button.textContent = '✗ Failed';
|
|
||||||
button.style.background = 'rgba(239, 68, 68, 0.3)'; // Red
|
|
||||||
button.style.borderColor = 'rgba(239, 68, 68, 0.5)';
|
|
||||||
|
|
||||||
// Reset after 2 seconds
|
|
||||||
setTimeout(() => {
|
|
||||||
button.textContent = 'Copy';
|
|
||||||
button.style.background = 'rgba(255, 255, 255, 0.1)';
|
|
||||||
button.style.borderColor = 'rgba(255, 255, 255, 0.2)';
|
|
||||||
}, 2000);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Public method to refresh buttons (useful for dynamically loaded content)
|
|
||||||
refresh() {
|
|
||||||
this.addCopyButtons();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Auto-initialize when script loads
|
|
||||||
if (typeof window !== 'undefined') {
|
|
||||||
window.codeCopyButtons = new CodeCopyButtons();
|
|
||||||
|
|
||||||
// Listen for custom event from document viewer for dynamic content
|
|
||||||
document.addEventListener('documentLoaded', () => {
|
|
||||||
console.log('[CodeCopyButtons] Document loaded, refreshing buttons');
|
|
||||||
window.codeCopyButtons.refresh();
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Export for module usage
|
|
||||||
if (typeof module !== 'undefined' && module.exports) {
|
|
||||||
module.exports = CodeCopyButtons;
|
|
||||||
}
|
|
||||||
|
|
@ -1,51 +0,0 @@
|
||||||
/**
|
|
||||||
* Coming Soon Overlay
|
|
||||||
* Displays over Koha pages until Stripe is configured
|
|
||||||
*/
|
|
||||||
|
|
||||||
(function() {
|
|
||||||
'use strict';
|
|
||||||
|
|
||||||
// Check if we should show the overlay
|
|
||||||
const shouldShowOverlay = () => {
|
|
||||||
// Only show on Koha pages
|
|
||||||
const isKohaPage = window.location.pathname.includes('/koha');
|
|
||||||
return isKohaPage;
|
|
||||||
};
|
|
||||||
|
|
||||||
// Create and inject overlay
|
|
||||||
if (shouldShowOverlay()) {
|
|
||||||
const overlayHTML = `
|
|
||||||
<div id="coming-soon-overlay" class="coming-soon-overlay">
|
|
||||||
<div class="coming-soon-card">
|
|
||||||
<h1 class="coming-soon-title">
|
|
||||||
Koha Donation System
|
|
||||||
</h1>
|
|
||||||
<p class="coming-soon-subtitle">
|
|
||||||
Coming Soon
|
|
||||||
</p>
|
|
||||||
<div class="coming-soon-info-box">
|
|
||||||
<p class="coming-soon-info-title">
|
|
||||||
<strong>What is Koha?</strong>
|
|
||||||
</p>
|
|
||||||
<p class="coming-soon-info-text">
|
|
||||||
Koha (Māori for "gift") is our upcoming donation system to support the Tractatus Framework.
|
|
||||||
We're currently finalizing payment processing integration and will launch soon.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
<p class="coming-soon-status">
|
|
||||||
Infrastructure deployed and ready. Payment processing activation in progress.
|
|
||||||
</p>
|
|
||||||
<a href="/" class="coming-soon-button">
|
|
||||||
Return to Homepage
|
|
||||||
</a>
|
|
||||||
<p class="coming-soon-footer">
|
|
||||||
Questions? Contact <a href="mailto:support@agenticgovernance.digital">support@agenticgovernance.digital</a>
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
|
|
||||||
document.body.insertAdjacentHTML('beforeend', overlayHTML);
|
|
||||||
}
|
|
||||||
})();
|
|
||||||
|
|
@ -1,85 +0,0 @@
|
||||||
/**
|
|
||||||
* Currency Selector Component
|
|
||||||
* Dropdown for selecting donation currency
|
|
||||||
*/
|
|
||||||
|
|
||||||
(function() {
|
|
||||||
'use strict';
|
|
||||||
|
|
||||||
// Currency selector HTML
|
|
||||||
const selectorHTML = `
|
|
||||||
<div id="currency-selector" class="bg-white shadow rounded-lg p-4 mb-8">
|
|
||||||
<label for="currency-select" class="block text-sm font-medium text-gray-700 mb-2">
|
|
||||||
Select Currency
|
|
||||||
</label>
|
|
||||||
<select
|
|
||||||
id="currency-select"
|
|
||||||
class="w-full md:w-64 px-4 py-2 border-2 border-gray-300 rounded-lg focus:border-blue-600 focus:outline-none text-base"
|
|
||||||
aria-label="Select your preferred currency"
|
|
||||||
>
|
|
||||||
<option value="NZD">🇳🇿 NZD - NZ Dollar</option>
|
|
||||||
<option value="USD">🇺🇸 USD - US Dollar</option>
|
|
||||||
<option value="EUR">🇪🇺 EUR - Euro</option>
|
|
||||||
<option value="GBP">🇬🇧 GBP - British Pound</option>
|
|
||||||
<option value="AUD">🇦🇺 AUD - Australian Dollar</option>
|
|
||||||
<option value="CAD">🇨🇦 CAD - Canadian Dollar</option>
|
|
||||||
<option value="JPY">🇯🇵 JPY - Japanese Yen</option>
|
|
||||||
<option value="CHF">🇨🇭 CHF - Swiss Franc</option>
|
|
||||||
<option value="SGD">🇸🇬 SGD - Singapore Dollar</option>
|
|
||||||
<option value="HKD">🇭🇰 HKD - Hong Kong Dollar</option>
|
|
||||||
</select>
|
|
||||||
<p class="text-xs text-gray-500 mt-2">
|
|
||||||
Prices are automatically converted from NZD. Your selection is saved for future visits.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
|
|
||||||
// Initialize currency selector
|
|
||||||
function initCurrencySelector() {
|
|
||||||
// Find container (should have id="currency-selector-container")
|
|
||||||
const container = document.getElementById('currency-selector-container');
|
|
||||||
if (!container) {
|
|
||||||
console.warn('Currency selector container not found');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Insert selector HTML
|
|
||||||
container.innerHTML = selectorHTML;
|
|
||||||
|
|
||||||
// Get select element
|
|
||||||
const select = document.getElementById('currency-select');
|
|
||||||
|
|
||||||
// Set initial value from detected currency
|
|
||||||
const detectedCurrency = detectUserCurrency();
|
|
||||||
select.value = detectedCurrency;
|
|
||||||
|
|
||||||
// Trigger initial price update
|
|
||||||
if (typeof window.updatePricesForCurrency === 'function') {
|
|
||||||
window.updatePricesForCurrency(detectedCurrency);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Listen for changes
|
|
||||||
select.addEventListener('change', function(e) {
|
|
||||||
const newCurrency = e.target.value;
|
|
||||||
|
|
||||||
// Save preference
|
|
||||||
saveCurrencyPreference(newCurrency);
|
|
||||||
|
|
||||||
// Update prices
|
|
||||||
if (typeof window.updatePricesForCurrency === 'function') {
|
|
||||||
window.updatePricesForCurrency(newCurrency);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Auto-initialize when DOM is ready
|
|
||||||
if (document.readyState === 'loading') {
|
|
||||||
document.addEventListener('DOMContentLoaded', initCurrencySelector);
|
|
||||||
} else {
|
|
||||||
initCurrencySelector();
|
|
||||||
}
|
|
||||||
|
|
||||||
// Expose init function globally
|
|
||||||
window.initCurrencySelector = initCurrencySelector;
|
|
||||||
|
|
||||||
})();
|
|
||||||
|
|
@ -1,422 +0,0 @@
|
||||||
/**
|
|
||||||
* Document Cards Component
|
|
||||||
* Renders document sections as interactive cards
|
|
||||||
*/
|
|
||||||
|
|
||||||
class DocumentCards {
|
|
||||||
constructor(containerId) {
|
|
||||||
this.container = document.getElementById(containerId);
|
|
||||||
this.currentDocument = null;
|
|
||||||
this.modalViewer = new ModalViewer();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render document as card grid
|
|
||||||
*/
|
|
||||||
render(document) {
|
|
||||||
if (!document || !document.sections || document.sections.length === 0) {
|
|
||||||
this.renderTraditionalView(document);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
this.currentDocument = document;
|
|
||||||
|
|
||||||
// Create document header
|
|
||||||
const headerHtml = this.renderHeader(document);
|
|
||||||
|
|
||||||
// Group sections by category
|
|
||||||
const sectionsByCategory = this.groupByCategory(document.sections);
|
|
||||||
|
|
||||||
// Render card grid
|
|
||||||
const cardsHtml = this.renderCardGrid(sectionsByCategory);
|
|
||||||
|
|
||||||
this.container.innerHTML = `
|
|
||||||
${headerHtml}
|
|
||||||
${cardsHtml}
|
|
||||||
`;
|
|
||||||
|
|
||||||
// Add event listeners after a brief delay to ensure DOM is ready
|
|
||||||
setTimeout(() => {
|
|
||||||
this.attachEventListeners();
|
|
||||||
}, 0);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render document header
|
|
||||||
*/
|
|
||||||
renderHeader(document) {
|
|
||||||
const version = document.metadata?.version || '';
|
|
||||||
const dateUpdated = document.metadata?.date_updated
|
|
||||||
? new Date(document.metadata.date_updated).toLocaleDateString('en-US', {
|
|
||||||
year: 'numeric',
|
|
||||||
month: 'short'
|
|
||||||
})
|
|
||||||
: '';
|
|
||||||
|
|
||||||
const versionText = version ? `v${version}` : '';
|
|
||||||
const metaText = [versionText, dateUpdated ? `Updated ${dateUpdated}` : '']
|
|
||||||
.filter(Boolean)
|
|
||||||
.join(' | ');
|
|
||||||
|
|
||||||
const hasToC = document.toc && document.toc.length > 0;
|
|
||||||
|
|
||||||
return `
|
|
||||||
<div class="flex items-center justify-between mb-6 pb-4 border-b border-gray-200">
|
|
||||||
<div>
|
|
||||||
<h1 class="text-3xl font-bold text-gray-900 mb-2">${document.title}</h1>
|
|
||||||
${metaText ? `<p class="text-sm text-gray-500">${metaText}</p>` : ''}
|
|
||||||
${document.sections ? `<p class="text-sm text-gray-600 mt-1">${document.sections.length} sections</p>` : ''}
|
|
||||||
</div>
|
|
||||||
<div class="flex items-center gap-2">
|
|
||||||
${hasToC ? `
|
|
||||||
<button id="toc-button"
|
|
||||||
class="p-2 text-gray-600 hover:text-blue-600 hover:bg-blue-50 rounded transition"
|
|
||||||
title="Table of Contents"
|
|
||||||
aria-label="Show table of contents">
|
|
||||||
<svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h7"/>
|
|
||||||
</svg>
|
|
||||||
</button>
|
|
||||||
` : ''}
|
|
||||||
<a href="/downloads/${document.slug}.pdf"
|
|
||||||
target="_blank"
|
|
||||||
rel="noopener noreferrer"
|
|
||||||
class="p-2 text-gray-600 hover:text-blue-600 hover:bg-blue-50 rounded transition"
|
|
||||||
title="Download PDF"
|
|
||||||
aria-label="Download PDF">
|
|
||||||
<svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 10v6m0 0l-3-3m3 3l3-3m2 8H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
|
|
||||||
</svg>
|
|
||||||
</a>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Group sections by category
|
|
||||||
*/
|
|
||||||
groupByCategory(sections) {
|
|
||||||
const groups = {
|
|
||||||
conceptual: [],
|
|
||||||
practical: [],
|
|
||||||
technical: [],
|
|
||||||
reference: [],
|
|
||||||
critical: []
|
|
||||||
};
|
|
||||||
|
|
||||||
sections.forEach(section => {
|
|
||||||
const category = section.category || 'conceptual';
|
|
||||||
if (groups[category]) {
|
|
||||||
groups[category].push(section);
|
|
||||||
} else {
|
|
||||||
groups.conceptual.push(section);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
return groups;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render card grid
|
|
||||||
*/
|
|
||||||
renderCardGrid(sectionsByCategory) {
|
|
||||||
const categoryConfig = {
|
|
||||||
conceptual: { icon: '📘', label: 'Conceptual', color: 'blue' },
|
|
||||||
practical: { icon: '✨', label: 'Practical', color: 'green' },
|
|
||||||
technical: { icon: '🔧', label: 'Technical', color: 'purple' },
|
|
||||||
reference: { icon: '📋', label: 'Reference', color: 'gray' },
|
|
||||||
critical: { icon: '⚠️', label: 'Critical', color: 'amber' }
|
|
||||||
};
|
|
||||||
|
|
||||||
let html = '<div class="card-grid-container">';
|
|
||||||
|
|
||||||
// Render each category that has sections
|
|
||||||
for (const [category, sections] of Object.entries(sectionsByCategory)) {
|
|
||||||
if (sections.length === 0) continue;
|
|
||||||
|
|
||||||
const config = categoryConfig[category];
|
|
||||||
|
|
||||||
html += `
|
|
||||||
<div class="category-section mb-8">
|
|
||||||
<h2 class="category-header text-lg font-semibold text-gray-700 mb-4 flex items-center">
|
|
||||||
<span class="text-2xl mr-2">${config.icon}</span>
|
|
||||||
${config.label}
|
|
||||||
</h2>
|
|
||||||
<div class="card-grid grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
|
|
||||||
${sections.map(section => this.renderCard(section, config.color)).join('')}
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
html += '</div>';
|
|
||||||
|
|
||||||
return html;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render individual card
|
|
||||||
*/
|
|
||||||
renderCard(section, color) {
|
|
||||||
const levelIcons = {
|
|
||||||
basic: '○',
|
|
||||||
intermediate: '◐',
|
|
||||||
advanced: '●'
|
|
||||||
};
|
|
||||||
|
|
||||||
const levelIcon = levelIcons[section.technicalLevel] || '○';
|
|
||||||
const levelLabel = section.technicalLevel.charAt(0).toUpperCase() + section.technicalLevel.slice(1);
|
|
||||||
|
|
||||||
const borderColor = {
|
|
||||||
blue: 'border-blue-400',
|
|
||||||
green: 'border-green-400',
|
|
||||||
purple: 'border-purple-400',
|
|
||||||
gray: 'border-gray-400',
|
|
||||||
amber: 'border-amber-400'
|
|
||||||
}[color] || 'border-blue-400';
|
|
||||||
|
|
||||||
const hoverColor = {
|
|
||||||
blue: 'hover:border-blue-600 hover:shadow-blue-100',
|
|
||||||
green: 'hover:border-green-600 hover:shadow-green-100',
|
|
||||||
purple: 'hover:border-purple-600 hover:shadow-purple-100',
|
|
||||||
gray: 'hover:border-gray-600 hover:shadow-gray-100',
|
|
||||||
amber: 'hover:border-amber-600 hover:shadow-amber-100'
|
|
||||||
}[color] || 'hover:border-blue-600';
|
|
||||||
|
|
||||||
const bgColor = {
|
|
||||||
blue: 'bg-blue-50',
|
|
||||||
green: 'bg-green-50',
|
|
||||||
purple: 'bg-purple-50',
|
|
||||||
gray: 'bg-gray-50',
|
|
||||||
amber: 'bg-amber-50'
|
|
||||||
}[color] || 'bg-blue-50';
|
|
||||||
|
|
||||||
return `
|
|
||||||
<div class="doc-card ${bgColor} border-2 ${borderColor} rounded-lg p-5 cursor-pointer transition-all duration-200 ${hoverColor} hover:shadow-lg"
|
|
||||||
data-section-slug="${section.slug}">
|
|
||||||
<h3 class="text-lg font-semibold text-gray-900 mb-3">${section.title}</h3>
|
|
||||||
<p class="text-sm text-gray-700 mb-4 line-clamp-3">${section.excerpt}</p>
|
|
||||||
<div class="flex items-center justify-between text-xs text-gray-600">
|
|
||||||
<span>${section.readingTime} min read</span>
|
|
||||||
<span title="${levelLabel}">${levelIcon} ${levelLabel}</span>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Fallback: render traditional view for documents without sections
|
|
||||||
*/
|
|
||||||
renderTraditionalView(document) {
|
|
||||||
if (!document) return;
|
|
||||||
|
|
||||||
this.container.innerHTML = `
|
|
||||||
<div class="prose max-w-none">
|
|
||||||
${document.content_html}
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Attach event listeners to cards
|
|
||||||
*/
|
|
||||||
attachEventListeners() {
|
|
||||||
const cards = this.container.querySelectorAll('.doc-card');
|
|
||||||
|
|
||||||
cards.forEach(card => {
|
|
||||||
card.addEventListener('click', (e) => {
|
|
||||||
e.preventDefault();
|
|
||||||
e.stopPropagation();
|
|
||||||
|
|
||||||
const sectionSlug = card.dataset.sectionSlug;
|
|
||||||
const section = this.currentDocument.sections.find(s => s.slug === sectionSlug);
|
|
||||||
|
|
||||||
if (section) {
|
|
||||||
this.modalViewer.show(section, this.currentDocument.sections);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
// Attach ToC button listener
|
|
||||||
const tocButton = document.getElementById('toc-button');
|
|
||||||
if (tocButton) {
|
|
||||||
tocButton.addEventListener('click', (e) => {
|
|
||||||
e.preventDefault();
|
|
||||||
e.stopPropagation();
|
|
||||||
if (typeof openToCModal === 'function') {
|
|
||||||
openToCModal();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Modal Viewer Component
|
|
||||||
* Displays section content in a modal
|
|
||||||
*/
|
|
||||||
class ModalViewer {
|
|
||||||
constructor() {
|
|
||||||
this.modal = null;
|
|
||||||
this.currentSection = null;
|
|
||||||
this.allSections = [];
|
|
||||||
this.currentIndex = 0;
|
|
||||||
this.createModal();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create modal structure
|
|
||||||
*/
|
|
||||||
createModal() {
|
|
||||||
const modalHtml = `
|
|
||||||
<div id="section-modal">
|
|
||||||
<div class="bg-white rounded-lg shadow-2xl max-w-4xl w-full max-h-[90vh] flex flex-col">
|
|
||||||
<!-- Header -->
|
|
||||||
<div class="flex items-center justify-between p-6 border-b border-gray-200">
|
|
||||||
<h2 id="modal-title" class="text-2xl font-bold text-gray-900">Document</h2>
|
|
||||||
<button id="modal-close" class="text-gray-400 hover:text-gray-600 text-3xl leading-none" aria-label="Close document">×</button>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Content -->
|
|
||||||
<div id="modal-content" class="flex-1 overflow-y-auto p-6 prose max-w-none">
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Footer Navigation -->
|
|
||||||
<div class="flex items-center justify-between p-4 border-t border-gray-200 bg-gray-50">
|
|
||||||
<button id="modal-prev" class="px-4 py-2 text-sm font-medium text-gray-700 bg-white border border-gray-300 rounded-md hover:bg-gray-50 disabled:opacity-50 disabled:cursor-not-allowed">
|
|
||||||
← Previous
|
|
||||||
</button>
|
|
||||||
<span id="modal-progress" class="text-sm text-gray-600"></span>
|
|
||||||
<button id="modal-next" class="px-4 py-2 text-sm font-medium text-white bg-blue-600 border border-transparent rounded-md hover:bg-blue-700 disabled:opacity-50 disabled:cursor-not-allowed">
|
|
||||||
Next →
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
|
|
||||||
document.body.insertAdjacentHTML('beforeend', modalHtml);
|
|
||||||
|
|
||||||
this.modal = document.getElementById('section-modal');
|
|
||||||
this.attachModalListeners();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Show modal with section content
|
|
||||||
*/
|
|
||||||
show(section, allSections) {
|
|
||||||
this.currentSection = section;
|
|
||||||
this.allSections = allSections;
|
|
||||||
this.currentIndex = allSections.findIndex(s => s.slug === section.slug);
|
|
||||||
|
|
||||||
// Update content
|
|
||||||
const titleEl = document.getElementById('modal-title');
|
|
||||||
const contentEl = document.getElementById('modal-content');
|
|
||||||
|
|
||||||
if (!titleEl || !contentEl) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
titleEl.textContent = section.title;
|
|
||||||
|
|
||||||
// Remove duplicate title (H1 or H2) from content (it's already in modal header)
|
|
||||||
let contentHtml = section.content_html;
|
|
||||||
|
|
||||||
// Try removing h1 first, then h2
|
|
||||||
const firstH1Match = contentHtml.match(/<h1[^>]*>.*?<\/h1>/);
|
|
||||||
if (firstH1Match) {
|
|
||||||
contentHtml = contentHtml.replace(firstH1Match[0], '');
|
|
||||||
} else {
|
|
||||||
const firstH2Match = contentHtml.match(/<h2[^>]*>.*?<\/h2>/);
|
|
||||||
if (firstH2Match) {
|
|
||||||
contentHtml = contentHtml.replace(firstH2Match[0], '');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
contentEl.innerHTML = contentHtml;
|
|
||||||
|
|
||||||
// Update navigation
|
|
||||||
this.updateNavigation();
|
|
||||||
|
|
||||||
// Show modal
|
|
||||||
this.modal.style.display = 'flex';
|
|
||||||
document.body.style.overflow = 'hidden';
|
|
||||||
|
|
||||||
// Scroll to top of content
|
|
||||||
contentEl.scrollTop = 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Hide modal
|
|
||||||
*/
|
|
||||||
hide() {
|
|
||||||
this.modal.style.display = 'none';
|
|
||||||
document.body.style.overflow = '';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update navigation buttons
|
|
||||||
*/
|
|
||||||
updateNavigation() {
|
|
||||||
const prevBtn = document.getElementById('modal-prev');
|
|
||||||
const nextBtn = document.getElementById('modal-next');
|
|
||||||
const progress = document.getElementById('modal-progress');
|
|
||||||
|
|
||||||
prevBtn.disabled = this.currentIndex === 0;
|
|
||||||
nextBtn.disabled = this.currentIndex === this.allSections.length - 1;
|
|
||||||
|
|
||||||
progress.textContent = `${this.currentIndex + 1} of ${this.allSections.length}`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Navigate to previous section
|
|
||||||
*/
|
|
||||||
showPrevious() {
|
|
||||||
if (this.currentIndex > 0) {
|
|
||||||
this.show(this.allSections[this.currentIndex - 1], this.allSections);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Navigate to next section
|
|
||||||
*/
|
|
||||||
showNext() {
|
|
||||||
if (this.currentIndex < this.allSections.length - 1) {
|
|
||||||
this.show(this.allSections[this.currentIndex + 1], this.allSections);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Attach modal event listeners
|
|
||||||
*/
|
|
||||||
attachModalListeners() {
|
|
||||||
// Close button
|
|
||||||
document.getElementById('modal-close').addEventListener('click', () => this.hide());
|
|
||||||
|
|
||||||
// Navigation buttons
|
|
||||||
document.getElementById('modal-prev').addEventListener('click', () => this.showPrevious());
|
|
||||||
document.getElementById('modal-next').addEventListener('click', () => this.showNext());
|
|
||||||
|
|
||||||
// Close on background click
|
|
||||||
this.modal.addEventListener('click', (e) => {
|
|
||||||
if (e.target === this.modal) {
|
|
||||||
this.hide();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Keyboard navigation
|
|
||||||
document.addEventListener('keydown', (e) => {
|
|
||||||
// Check if modal is visible using display style instead of hidden class
|
|
||||||
if (this.modal.style.display === 'flex') {
|
|
||||||
if (e.key === 'Escape') {
|
|
||||||
this.hide();
|
|
||||||
} else if (e.key === 'ArrowLeft') {
|
|
||||||
this.showPrevious();
|
|
||||||
} else if (e.key === 'ArrowRight') {
|
|
||||||
this.showNext();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
@ -1,176 +0,0 @@
|
||||||
/**
|
|
||||||
* Document Viewer Component
|
|
||||||
* Displays framework documentation with TOC and navigation
|
|
||||||
*/
|
|
||||||
|
|
||||||
class DocumentViewer {
|
|
||||||
constructor(containerId = 'document-viewer') {
|
|
||||||
this.container = document.getElementById(containerId);
|
|
||||||
this.currentDocument = null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render document
|
|
||||||
*/
|
|
||||||
async render(documentSlug) {
|
|
||||||
if (!this.container) {
|
|
||||||
console.error('Document viewer container not found');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
try {
|
|
||||||
// Show loading state
|
|
||||||
this.showLoading();
|
|
||||||
|
|
||||||
// Fetch document
|
|
||||||
const response = await API.Documents.get(documentSlug);
|
|
||||||
|
|
||||||
if (!response.success) {
|
|
||||||
throw new Error('Document not found');
|
|
||||||
}
|
|
||||||
|
|
||||||
this.currentDocument = response.document;
|
|
||||||
this.showDocument();
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
this.showError(error.message);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Show loading state
|
|
||||||
*/
|
|
||||||
showLoading() {
|
|
||||||
this.container.innerHTML = `
|
|
||||||
<div class="flex items-center justify-center py-20">
|
|
||||||
<div class="text-center">
|
|
||||||
<div class="animate-spin rounded-full h-12 w-12 border-b-2 border-blue-600 mx-auto mb-4"></div>
|
|
||||||
<p class="text-gray-600">Loading document...</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Show document content
|
|
||||||
*/
|
|
||||||
showDocument() {
|
|
||||||
const doc = this.currentDocument;
|
|
||||||
|
|
||||||
this.container.innerHTML = `
|
|
||||||
<div class="max-w-4xl mx-auto px-4 py-8">
|
|
||||||
<!-- Header -->
|
|
||||||
<div class="mb-8">
|
|
||||||
${doc.quadrant ? `
|
|
||||||
<span class="inline-block bg-blue-100 text-blue-800 text-xs px-2 py-1 rounded mb-2">
|
|
||||||
${doc.quadrant}
|
|
||||||
</span>
|
|
||||||
` : ''}
|
|
||||||
<h1 class="text-4xl font-bold text-gray-900 mb-2">${this.escapeHtml(doc.title)}</h1>
|
|
||||||
${doc.metadata?.version ? `
|
|
||||||
<p class="text-sm text-gray-500">Version ${doc.metadata.version}</p>
|
|
||||||
` : ''}
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Table of Contents -->
|
|
||||||
${doc.toc && doc.toc.length > 0 ? this.renderTOC(doc.toc) : ''}
|
|
||||||
|
|
||||||
<!-- Content -->
|
|
||||||
<div class="prose prose-lg max-w-none">
|
|
||||||
${doc.content_html}
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Metadata -->
|
|
||||||
<div class="mt-12 pt-8 border-t border-gray-200">
|
|
||||||
<div class="text-sm text-gray-500">
|
|
||||||
${doc.created_at ? `<p>Created: ${new Date(doc.created_at).toLocaleDateString()}</p>` : ''}
|
|
||||||
${doc.updated_at ? `<p>Updated: ${new Date(doc.updated_at).toLocaleDateString()}</p>` : ''}
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
|
|
||||||
// Add smooth scroll to TOC links
|
|
||||||
this.initializeTOCLinks();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render table of contents
|
|
||||||
*/
|
|
||||||
renderTOC(toc) {
|
|
||||||
return `
|
|
||||||
<div class="bg-gray-50 border border-gray-200 rounded-lg p-6 mb-8">
|
|
||||||
<h2 class="text-lg font-semibold text-gray-900 mb-4">Table of Contents</h2>
|
|
||||||
<nav>
|
|
||||||
<ul class="space-y-2">
|
|
||||||
${toc.map(item => {
|
|
||||||
// Generate Tailwind margin class based on level
|
|
||||||
const marginClass = item.level === 1 ? '' :
|
|
||||||
item.level === 2 ? 'ml-4' :
|
|
||||||
item.level === 3 ? 'ml-8' :
|
|
||||||
item.level === 4 ? 'ml-12' :
|
|
||||||
'ml-16';
|
|
||||||
return `
|
|
||||||
<li class="${marginClass}">
|
|
||||||
<a href="#${item.id}"
|
|
||||||
class="text-blue-600 hover:text-blue-700 hover:underline">
|
|
||||||
${this.escapeHtml(item.text)}
|
|
||||||
</a>
|
|
||||||
</li>
|
|
||||||
`;
|
|
||||||
}).join('')}
|
|
||||||
</ul>
|
|
||||||
</nav>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Initialize TOC links for smooth scrolling
|
|
||||||
*/
|
|
||||||
initializeTOCLinks() {
|
|
||||||
this.container.querySelectorAll('a[href^="#"]').forEach(link => {
|
|
||||||
link.addEventListener('click', (e) => {
|
|
||||||
e.preventDefault();
|
|
||||||
const id = link.getAttribute('href').slice(1);
|
|
||||||
const target = document.getElementById(id);
|
|
||||||
if (target) {
|
|
||||||
target.scrollIntoView({ behavior: 'smooth', block: 'start' });
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Show error state
|
|
||||||
*/
|
|
||||||
showError(message) {
|
|
||||||
this.container.innerHTML = `
|
|
||||||
<div class="max-w-2xl mx-auto px-4 py-20 text-center">
|
|
||||||
<div class="text-red-600 mb-4">
|
|
||||||
<svg class="w-16 h-16 mx-auto" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
|
|
||||||
d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
|
|
||||||
</svg>
|
|
||||||
</div>
|
|
||||||
<h2 class="text-2xl font-bold text-gray-900 mb-2">Document Not Found</h2>
|
|
||||||
<p class="text-gray-600 mb-6">${this.escapeHtml(message)}</p>
|
|
||||||
<a href="/docs" class="text-blue-600 hover:text-blue-700 font-semibold">
|
|
||||||
← Browse all documents
|
|
||||||
</a>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Escape HTML to prevent XSS
|
|
||||||
*/
|
|
||||||
escapeHtml(text) {
|
|
||||||
const div = document.createElement('div');
|
|
||||||
div.textContent = text;
|
|
||||||
return div.innerHTML;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Export as global
|
|
||||||
window.DocumentViewer = DocumentViewer;
|
|
||||||
|
|
@ -1,155 +0,0 @@
|
||||||
/**
|
|
||||||
* Footer Component - i18n-enabled
|
|
||||||
* Shared footer for all Tractatus pages with language persistence
|
|
||||||
*/
|
|
||||||
|
|
||||||
(function() {
|
|
||||||
'use strict';
|
|
||||||
|
|
||||||
class TractatusFooter {
|
|
||||||
constructor() {
|
|
||||||
this.init();
|
|
||||||
}
|
|
||||||
|
|
||||||
init() {
|
|
||||||
// Wait for I18n to be ready before rendering
|
|
||||||
if (window.I18n && window.I18n.translations && Object.keys(window.I18n.translations).length > 0) {
|
|
||||||
this.render();
|
|
||||||
this.attachEventListeners();
|
|
||||||
} else {
|
|
||||||
// If I18n not ready, wait for it
|
|
||||||
const checkI18n = setInterval(() => {
|
|
||||||
if (window.I18n && window.I18n.translations && Object.keys(window.I18n.translations).length > 0) {
|
|
||||||
clearInterval(checkI18n);
|
|
||||||
this.render();
|
|
||||||
this.attachEventListeners();
|
|
||||||
}
|
|
||||||
}, 100);
|
|
||||||
|
|
||||||
// Fallback timeout - render without i18n after 2 seconds
|
|
||||||
setTimeout(() => {
|
|
||||||
clearInterval(checkI18n);
|
|
||||||
if (!document.querySelector('footer[role="contentinfo"]')) {
|
|
||||||
this.render();
|
|
||||||
this.attachEventListeners();
|
|
||||||
}
|
|
||||||
}, 2000);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
render() {
|
|
||||||
const currentYear = new Date().getFullYear();
|
|
||||||
|
|
||||||
// Create footer HTML with data-i18n attributes
|
|
||||||
const footerHTML = `
|
|
||||||
<footer class="bg-gray-900 text-gray-300 mt-16" role="contentinfo">
|
|
||||||
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12">
|
|
||||||
|
|
||||||
<!-- Main Footer Content -->
|
|
||||||
<div class="grid grid-cols-1 md:grid-cols-4 gap-8 mb-8">
|
|
||||||
|
|
||||||
<!-- About -->
|
|
||||||
<div>
|
|
||||||
<h3 class="text-white font-semibold mb-4" data-i18n="footer.about_heading">Tractatus Framework</h3>
|
|
||||||
<p class="text-sm text-gray-400" data-i18n="footer.about_text">
|
|
||||||
Architectural constraints for AI safety that preserve human agency through structural, not aspirational, enforcement.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Documentation -->
|
|
||||||
<div>
|
|
||||||
<h3 class="text-white font-semibold mb-4" data-i18n="footer.documentation_heading">Documentation</h3>
|
|
||||||
<ul class="space-y-2 text-sm">
|
|
||||||
<li><a href="/docs.html" class="hover:text-white transition" data-i18n="footer.documentation_links.framework_docs">Framework Docs</a></li>
|
|
||||||
<li><a href="/about.html" class="hover:text-white transition" data-i18n="footer.documentation_links.about">About</a></li>
|
|
||||||
<li><a href="/about/values.html" class="hover:text-white transition" data-i18n="footer.documentation_links.core_values">Core Values</a></li>
|
|
||||||
<li><a href="/demos/27027-demo.html" class="hover:text-white transition" data-i18n="footer.documentation_links.interactive_demo">Interactive Demo</a></li>
|
|
||||||
</ul>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Support -->
|
|
||||||
<div>
|
|
||||||
<h3 class="text-white font-semibold mb-4" data-i18n="footer.support_heading">Support</h3>
|
|
||||||
<ul class="space-y-2 text-sm">
|
|
||||||
<li><a href="/koha.html" class="hover:text-white transition" data-i18n="footer.support_links.koha">Support (Koha)</a></li>
|
|
||||||
<li><a href="/koha/transparency.html" class="hover:text-white transition" data-i18n="footer.support_links.transparency">Transparency</a></li>
|
|
||||||
<li><a href="/media-inquiry.html" class="hover:text-white transition" data-i18n="footer.support_links.media_inquiries">Media Inquiries</a></li>
|
|
||||||
<li><a href="/case-submission.html" class="hover:text-white transition" data-i18n="footer.support_links.submit_case">Submit Case Study</a></li>
|
|
||||||
</ul>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Legal & Contact -->
|
|
||||||
<div>
|
|
||||||
<h3 class="text-white font-semibold mb-4" data-i18n="footer.legal_heading">Legal</h3>
|
|
||||||
<ul class="space-y-2 text-sm">
|
|
||||||
<li><a href="/privacy.html" class="hover:text-white transition" data-i18n="footer.legal_links.privacy">Privacy Policy</a></li>
|
|
||||||
<li><a href="mailto:hello@agenticgovernance.digital" class="hover:text-white transition" data-i18n="footer.legal_links.contact">Contact Us</a></li>
|
|
||||||
<li><a href="https://github.com/AgenticGovernance/tractatus-framework" class="hover:text-white transition" target="_blank" rel="noopener">GitHub</a></li>
|
|
||||||
</ul>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Divider -->
|
|
||||||
<div class="border-t border-gray-800 pt-8">
|
|
||||||
|
|
||||||
<!-- Te Tiriti Acknowledgement -->
|
|
||||||
<div class="mb-6">
|
|
||||||
<p class="text-sm text-gray-400">
|
|
||||||
<strong class="text-gray-300" data-i18n="footer.te_tiriti_label">Te Tiriti o Waitangi:</strong>
|
|
||||||
<span data-i18n="footer.te_tiriti_text">We acknowledge Te Tiriti o Waitangi and our commitment to partnership, protection, and participation. This project respects Māori data sovereignty (rangatiratanga) and collective guardianship (kaitiakitanga).</span>
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Bottom Row -->
|
|
||||||
<div class="flex flex-col md:flex-row justify-between items-center gap-4 text-sm">
|
|
||||||
<p class="text-gray-400">
|
|
||||||
© ${currentYear} <span data-i18n="footer.copyright">John G Stroh. Licensed under</span> <a href="https://www.apache.org/licenses/LICENSE-2.0" class="text-blue-400 hover:text-blue-300 transition" target="_blank" rel="noopener"><span data-i18n="footer.license">Apache 2.0</span></a>.
|
|
||||||
</p>
|
|
||||||
<p class="text-gray-400" data-i18n="footer.location">
|
|
||||||
Made in Aotearoa New Zealand 🇳🇿
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</footer>
|
|
||||||
`;
|
|
||||||
|
|
||||||
// Insert footer at end of body
|
|
||||||
const existingFooter = document.querySelector('footer[role="contentinfo"]');
|
|
||||||
if (existingFooter) {
|
|
||||||
existingFooter.outerHTML = footerHTML;
|
|
||||||
} else if (document.body) {
|
|
||||||
document.body.insertAdjacentHTML('beforeend', footerHTML);
|
|
||||||
} else {
|
|
||||||
// If body not ready, wait for DOM
|
|
||||||
document.addEventListener('DOMContentLoaded', () => {
|
|
||||||
document.body.insertAdjacentHTML('beforeend', footerHTML);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Apply translations if I18n is available
|
|
||||||
if (window.I18n && window.I18n.applyTranslations) {
|
|
||||||
window.I18n.applyTranslations();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
attachEventListeners() {
|
|
||||||
// Listen for language changes and re-render footer
|
|
||||||
window.addEventListener('languageChanged', (event) => {
|
|
||||||
console.log('[Footer] Language changed to:', event.detail.language);
|
|
||||||
this.render();
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Auto-initialize when DOM is ready
|
|
||||||
if (document.readyState === 'loading') {
|
|
||||||
document.addEventListener('DOMContentLoaded', () => new TractatusFooter());
|
|
||||||
} else {
|
|
||||||
new TractatusFooter();
|
|
||||||
}
|
|
||||||
|
|
||||||
})();
|
|
||||||
|
|
@ -1,85 +0,0 @@
|
||||||
/**
|
|
||||||
* Language Selector Component
|
|
||||||
* Simple icon-based selector for all devices
|
|
||||||
*/
|
|
||||||
|
|
||||||
(function() {
|
|
||||||
const supportedLanguages = [
|
|
||||||
{ code: 'en', name: 'English', flag: '🇬🇧' },
|
|
||||||
{ code: 'de', name: 'Deutsch', flag: '🇩🇪' },
|
|
||||||
{ code: 'fr', name: 'Français', flag: '🇫🇷' },
|
|
||||||
{ code: 'mi', name: 'Te Reo Māori', flag: '🇳🇿', disabled: true, tooltip: 'Planned' }
|
|
||||||
];
|
|
||||||
|
|
||||||
function createLanguageSelector() {
|
|
||||||
const container = document.getElementById('language-selector-container');
|
|
||||||
if (!container) return;
|
|
||||||
|
|
||||||
const currentLang = (window.I18n && window.I18n.currentLang) || 'en';
|
|
||||||
|
|
||||||
const selectorHTML = `
|
|
||||||
<!-- Language icon buttons (all devices) -->
|
|
||||||
<div class="flex gap-1">
|
|
||||||
${supportedLanguages.map(lang => `
|
|
||||||
<button
|
|
||||||
data-lang="${lang.code}"
|
|
||||||
class="language-icon-btn w-11 h-11 flex items-center justify-center rounded-lg border-2 transition-all ${
|
|
||||||
lang.code === currentLang
|
|
||||||
? 'border-blue-600 bg-blue-50'
|
|
||||||
: 'border-gray-300 bg-white hover:border-blue-400 hover:bg-blue-50'
|
|
||||||
} ${lang.disabled ? 'opacity-50 cursor-not-allowed' : 'cursor-pointer'}"
|
|
||||||
aria-label="${lang.disabled ? lang.name + ' (' + lang.tooltip + ')' : 'Switch to ' + lang.name}"
|
|
||||||
title="${lang.name}${lang.disabled ? ' (' + lang.tooltip + ')' : ''}"
|
|
||||||
${lang.disabled ? 'disabled' : ''}
|
|
||||||
>
|
|
||||||
<span class="text-2xl" role="img" aria-label="${lang.name} flag">${lang.flag}</span>
|
|
||||||
</button>
|
|
||||||
`).join('')}
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
|
|
||||||
container.innerHTML = selectorHTML;
|
|
||||||
|
|
||||||
// Add event listeners
|
|
||||||
attachEventListeners(currentLang);
|
|
||||||
}
|
|
||||||
|
|
||||||
function attachEventListeners(currentLang) {
|
|
||||||
// Icon buttons
|
|
||||||
const iconButtons = document.querySelectorAll('.language-icon-btn:not([disabled])');
|
|
||||||
iconButtons.forEach(button => {
|
|
||||||
button.addEventListener('click', function() {
|
|
||||||
const selectedLang = this.getAttribute('data-lang');
|
|
||||||
if (window.I18n) {
|
|
||||||
window.I18n.setLanguage(selectedLang);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Update active state
|
|
||||||
document.querySelectorAll('.language-icon-btn').forEach(btn => {
|
|
||||||
if (!btn.disabled) {
|
|
||||||
btn.classList.remove('border-blue-600', 'bg-blue-50');
|
|
||||||
btn.classList.add('border-gray-300', 'bg-white');
|
|
||||||
}
|
|
||||||
});
|
|
||||||
this.classList.remove('border-gray-300', 'bg-white');
|
|
||||||
this.classList.add('border-blue-600', 'bg-blue-50');
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Initialize when DOM is ready
|
|
||||||
if (document.readyState === 'loading') {
|
|
||||||
document.addEventListener('DOMContentLoaded', createLanguageSelector);
|
|
||||||
} else {
|
|
||||||
createLanguageSelector();
|
|
||||||
}
|
|
||||||
|
|
||||||
// Re-initialize when language changes (to update active state)
|
|
||||||
if (window.I18n) {
|
|
||||||
const originalSetLanguage = window.I18n.setLanguage;
|
|
||||||
window.I18n.setLanguage = function(lang) {
|
|
||||||
originalSetLanguage.call(window.I18n, lang);
|
|
||||||
createLanguageSelector(); // Refresh selector with new active language
|
|
||||||
};
|
|
||||||
}
|
|
||||||
})();
|
|
||||||
|
|
@ -1,219 +0,0 @@
|
||||||
/**
|
|
||||||
* Tractatus Framework - Responsive Navbar Component
|
|
||||||
* Consistent, mobile-friendly navigation across all pages
|
|
||||||
*/
|
|
||||||
|
|
||||||
class TractatusNavbar {
|
|
||||||
constructor() {
|
|
||||||
this.mobileMenuOpen = false;
|
|
||||||
this.init();
|
|
||||||
}
|
|
||||||
|
|
||||||
init() {
|
|
||||||
this.render();
|
|
||||||
this.attachEventListeners();
|
|
||||||
this.setActivePageIndicator();
|
|
||||||
}
|
|
||||||
|
|
||||||
render() {
|
|
||||||
const navHTML = `
|
|
||||||
<nav class="bg-white border-b border-gray-200 sticky top-0 z-50 shadow-sm">
|
|
||||||
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
|
|
||||||
<div class="flex justify-between h-16">
|
|
||||||
|
|
||||||
<!-- Left: Logo + Brand -->
|
|
||||||
<div class="flex items-center">
|
|
||||||
<a href="/"
|
|
||||||
class="flex items-center space-x-3 px-3 py-2 -ml-3 rounded-lg hover:bg-blue-50 transition-all duration-200 group"
|
|
||||||
title="Return to homepage">
|
|
||||||
<img src="/images/tractatus-icon-new.svg" alt="Tractatus Icon" class="w-8 h-8">
|
|
||||||
<span class="text-xl font-bold text-gray-900 group-hover:text-blue-700 transition-colors hidden sm:inline">Tractatus Framework</span>
|
|
||||||
<span class="text-xl font-bold text-gray-900 group-hover:text-blue-700 transition-colors sm:hidden">Tractatus</span>
|
|
||||||
<svg class="w-4 h-4 text-gray-400 opacity-0 group-hover:opacity-100 transition-opacity ml-1 hidden sm:block"
|
|
||||||
fill="none"
|
|
||||||
stroke="currentColor"
|
|
||||||
viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-6 0a1 1 0 001-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 001 1m-6 0h6"/>
|
|
||||||
</svg>
|
|
||||||
</a>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Right: Language Selector + Menu Button -->
|
|
||||||
<div class="flex items-center gap-3">
|
|
||||||
<!-- Language Selector Container -->
|
|
||||||
<div id="language-selector-container"></div>
|
|
||||||
|
|
||||||
<button id="mobile-menu-btn" class="text-gray-600 hover:text-gray-900 focus:outline-none focus:ring-2 focus:ring-blue-500 rounded p-2" aria-label="Toggle menu">
|
|
||||||
<svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16" />
|
|
||||||
</svg>
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Navigation Drawer (overlay, doesn't push content) -->
|
|
||||||
<div id="mobile-menu" class="hidden fixed inset-0 z-[9999]">
|
|
||||||
<!-- Backdrop with blur -->
|
|
||||||
<div id="mobile-menu-backdrop" class="absolute inset-0 bg-gray-900/60 backdrop-blur-sm transition-opacity"></div>
|
|
||||||
|
|
||||||
<!-- Menu Panel (slides from right) -->
|
|
||||||
<div id="mobile-menu-panel" class="absolute right-0 top-0 bottom-0 w-80 max-w-[85vw] bg-white shadow-2xl transform transition-transform duration-300 ease-out">
|
|
||||||
<div class="flex justify-between items-center px-5 h-16 border-b border-gray-200">
|
|
||||||
<div class="flex items-center space-x-2">
|
|
||||||
<img src="/images/tractatus-icon-new.svg" alt="Tractatus Icon" class="w-6 h-6">
|
|
||||||
<span class="font-bold text-gray-900">Navigation</span>
|
|
||||||
</div>
|
|
||||||
<button id="mobile-menu-close-btn" class="text-gray-600 hover:text-gray-900 p-2 rounded hover:bg-gray-100 transition" aria-label="Close menu">
|
|
||||||
<svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
|
|
||||||
</svg>
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
<nav class="p-5 space-y-3">
|
|
||||||
<div class="pb-3 mb-3 border-b border-gray-200">
|
|
||||||
<p class="text-xs font-semibold text-gray-500 uppercase tracking-wider mb-2 px-3">Audiences</p>
|
|
||||||
<a href="/researcher.html" class="block px-3 py-2.5 text-gray-700 hover:bg-blue-50 hover:text-blue-700 rounded-lg transition font-medium">
|
|
||||||
<span class="text-sm">🔬 Researcher</span>
|
|
||||||
</a>
|
|
||||||
<a href="/implementer.html" class="block px-3 py-2.5 text-gray-700 hover:bg-blue-50 hover:text-blue-700 rounded-lg transition font-medium">
|
|
||||||
<span class="text-sm">⚙️ Implementer</span>
|
|
||||||
</a>
|
|
||||||
<a href="/leader.html" class="block px-3 py-2.5 text-gray-700 hover:bg-blue-50 hover:text-blue-700 rounded-lg transition font-medium">
|
|
||||||
<span class="text-sm">💼 Leader</span>
|
|
||||||
</a>
|
|
||||||
</div>
|
|
||||||
<a href="/docs.html" class="block px-3 py-2.5 text-gray-700 hover:bg-blue-50 hover:text-blue-700 rounded-lg transition">
|
|
||||||
<span class="text-sm font-semibold">📚 Documentation</span>
|
|
||||||
</a>
|
|
||||||
<a href="/blog.html" class="block px-3 py-2.5 text-gray-700 hover:bg-blue-50 hover:text-blue-700 rounded-lg transition">
|
|
||||||
<span class="text-sm font-semibold">📝 Blog</span>
|
|
||||||
</a>
|
|
||||||
<a href="/faq.html" class="block px-3 py-2.5 text-gray-700 hover:bg-blue-50 hover:text-blue-700 rounded-lg transition">
|
|
||||||
<span class="text-sm font-semibold">❓ FAQ</span>
|
|
||||||
</a>
|
|
||||||
<a href="/about.html" class="block px-3 py-2.5 text-gray-700 hover:bg-blue-50 hover:text-blue-700 rounded-lg transition">
|
|
||||||
<span class="text-sm font-semibold">ℹ️ About</span>
|
|
||||||
</a>
|
|
||||||
<a href="/koha.html" class="block px-3 py-2.5 text-gray-700 hover:bg-blue-50 hover:text-blue-700 rounded-lg transition">
|
|
||||||
<span class="text-sm font-semibold">🤝 Support (Koha)</span>
|
|
||||||
</a>
|
|
||||||
</nav>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
</nav>
|
|
||||||
`;
|
|
||||||
|
|
||||||
// Always insert navbar at the very beginning of body
|
|
||||||
// Check if there's already a tractatus navbar (to avoid duplicates)
|
|
||||||
const existingNavbar = document.querySelector('nav.bg-white.border-b.border-gray-200.sticky');
|
|
||||||
if (existingNavbar) {
|
|
||||||
existingNavbar.outerHTML = navHTML;
|
|
||||||
} else {
|
|
||||||
const placeholder = document.getElementById('navbar-placeholder');
|
|
||||||
if (placeholder) {
|
|
||||||
placeholder.outerHTML = navHTML;
|
|
||||||
} else {
|
|
||||||
document.body.insertAdjacentHTML('afterbegin', navHTML);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
attachEventListeners() {
|
|
||||||
// Mobile Menu (Navigation Drawer)
|
|
||||||
const mobileMenuBtn = document.getElementById('mobile-menu-btn');
|
|
||||||
const mobileMenuCloseBtn = document.getElementById('mobile-menu-close-btn');
|
|
||||||
const mobileMenu = document.getElementById('mobile-menu');
|
|
||||||
const mobileMenuPanel = document.getElementById('mobile-menu-panel');
|
|
||||||
const mobileMenuBackdrop = document.getElementById('mobile-menu-backdrop');
|
|
||||||
|
|
||||||
const toggleMobileMenu = () => {
|
|
||||||
this.mobileMenuOpen = !this.mobileMenuOpen;
|
|
||||||
|
|
||||||
if (this.mobileMenuOpen) {
|
|
||||||
// Open: Show menu and slide panel in from right
|
|
||||||
mobileMenu.classList.remove('hidden');
|
|
||||||
// Use setTimeout to ensure display change happens before animation
|
|
||||||
setTimeout(() => {
|
|
||||||
mobileMenuPanel.classList.remove('translate-x-full');
|
|
||||||
mobileMenuPanel.classList.add('translate-x-0');
|
|
||||||
}, 10);
|
|
||||||
document.body.style.overflow = 'hidden'; // Prevent scrolling when menu is open
|
|
||||||
} else {
|
|
||||||
// Close: Slide panel out to right
|
|
||||||
mobileMenuPanel.classList.remove('translate-x-0');
|
|
||||||
mobileMenuPanel.classList.add('translate-x-full');
|
|
||||||
// Hide menu after animation completes (300ms)
|
|
||||||
setTimeout(() => {
|
|
||||||
mobileMenu.classList.add('hidden');
|
|
||||||
}, 300);
|
|
||||||
document.body.style.overflow = '';
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
// Initialize panel in hidden state (off-screen to the right)
|
|
||||||
if (mobileMenuPanel) {
|
|
||||||
mobileMenuPanel.classList.add('translate-x-full');
|
|
||||||
}
|
|
||||||
|
|
||||||
if (mobileMenuBtn) {
|
|
||||||
mobileMenuBtn.addEventListener('click', toggleMobileMenu);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (mobileMenuCloseBtn) {
|
|
||||||
mobileMenuCloseBtn.addEventListener('click', toggleMobileMenu);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (mobileMenuBackdrop) {
|
|
||||||
mobileMenuBackdrop.addEventListener('click', toggleMobileMenu);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Close mobile menu on navigation
|
|
||||||
const mobileLinks = document.querySelectorAll('#mobile-menu a');
|
|
||||||
mobileLinks.forEach(link => {
|
|
||||||
link.addEventListener('click', () => {
|
|
||||||
if (this.mobileMenuOpen) {
|
|
||||||
toggleMobileMenu();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
setActivePageIndicator() {
|
|
||||||
// Get current page path
|
|
||||||
const currentPath = window.location.pathname;
|
|
||||||
|
|
||||||
// Normalize paths (handle both /page.html and /page)
|
|
||||||
const normalizePath = (path) => {
|
|
||||||
if (path === '/' || path === '/index.html') return '/';
|
|
||||||
return path.replace('.html', '').replace(/\/$/, '');
|
|
||||||
};
|
|
||||||
|
|
||||||
const normalizedCurrent = normalizePath(currentPath);
|
|
||||||
|
|
||||||
// Find all navigation links in mobile menu
|
|
||||||
const mobileLinks = document.querySelectorAll('#mobile-menu a');
|
|
||||||
|
|
||||||
mobileLinks.forEach(link => {
|
|
||||||
const linkPath = link.getAttribute('href');
|
|
||||||
const normalizedLink = normalizePath(linkPath);
|
|
||||||
|
|
||||||
if (normalizedLink === normalizedCurrent) {
|
|
||||||
// Add active styling with brand colors
|
|
||||||
link.classList.add('border-l-4', 'bg-sky-50');
|
|
||||||
link.style.borderLeftColor = 'var(--tractatus-core-end)';
|
|
||||||
link.style.color = 'var(--tractatus-core-end)';
|
|
||||||
link.classList.remove('text-gray-700');
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Auto-initialize when DOM is ready
|
|
||||||
if (document.readyState === 'loading') {
|
|
||||||
document.addEventListener('DOMContentLoaded', () => new TractatusNavbar());
|
|
||||||
} else {
|
|
||||||
new TractatusNavbar();
|
|
||||||
}
|
|
||||||
|
|
@ -1,268 +0,0 @@
|
||||||
/**
|
|
||||||
* Table of Contents Component
|
|
||||||
* Tractatus Framework - Phase 3: Interactive Documentation
|
|
||||||
*
|
|
||||||
* Creates sticky TOC sidebar on desktop, collapsible on mobile
|
|
||||||
* Highlights current section on scroll
|
|
||||||
* Smooth scroll to sections
|
|
||||||
*/
|
|
||||||
|
|
||||||
class TableOfContents {
|
|
||||||
constructor(options = {}) {
|
|
||||||
this.contentSelector = options.contentSelector || '#document-viewer';
|
|
||||||
this.tocSelector = options.tocSelector || '#table-of-contents';
|
|
||||||
this.headingSelector = options.headingSelector || 'h1, h2, h3';
|
|
||||||
this.activeClass = 'toc-active';
|
|
||||||
this.collapsedClass = 'toc-collapsed';
|
|
||||||
|
|
||||||
this.headings = [];
|
|
||||||
this.tocLinks = [];
|
|
||||||
this.currentActiveIndex = -1;
|
|
||||||
|
|
||||||
this.init();
|
|
||||||
}
|
|
||||||
|
|
||||||
init() {
|
|
||||||
// Wait for DOM to be ready
|
|
||||||
if (document.readyState === 'loading') {
|
|
||||||
document.addEventListener('DOMContentLoaded', () => this.build());
|
|
||||||
} else {
|
|
||||||
this.build();
|
|
||||||
}
|
|
||||||
|
|
||||||
console.log('[TOC] Initialized');
|
|
||||||
}
|
|
||||||
|
|
||||||
build() {
|
|
||||||
const tocContainer = document.querySelector(this.tocSelector);
|
|
||||||
if (!tocContainer) {
|
|
||||||
console.warn('[TOC] TOC container not found:', this.tocSelector);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
const content = document.querySelector(this.contentSelector);
|
|
||||||
if (!content) {
|
|
||||||
console.warn('[TOC] Content container not found:', this.contentSelector);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Find all headings in content
|
|
||||||
this.headings = Array.from(content.querySelectorAll(this.headingSelector));
|
|
||||||
|
|
||||||
if (this.headings.length === 0) {
|
|
||||||
console.log('[TOC] No headings found, hiding TOC');
|
|
||||||
tocContainer.style.display = 'none';
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
console.log(`[TOC] Found ${this.headings.length} headings`);
|
|
||||||
|
|
||||||
// Generate IDs for headings if they don't have them
|
|
||||||
this.headings.forEach((heading, index) => {
|
|
||||||
if (!heading.id) {
|
|
||||||
heading.id = `toc-heading-${index}`;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Build TOC HTML
|
|
||||||
const tocHTML = this.buildTOCHTML();
|
|
||||||
tocContainer.innerHTML = tocHTML;
|
|
||||||
|
|
||||||
// Store TOC links
|
|
||||||
this.tocLinks = Array.from(tocContainer.querySelectorAll('a'));
|
|
||||||
|
|
||||||
// Add scroll spy
|
|
||||||
this.initScrollSpy();
|
|
||||||
|
|
||||||
// Add smooth scroll
|
|
||||||
this.initSmoothScroll();
|
|
||||||
|
|
||||||
// Add mobile toggle functionality
|
|
||||||
this.initMobileToggle();
|
|
||||||
}
|
|
||||||
|
|
||||||
buildTOCHTML() {
|
|
||||||
let html = '<nav class="toc-nav" aria-label="Table of Contents">';
|
|
||||||
html += '<div class="toc-header flex items-center justify-between mb-4 md:mb-6">';
|
|
||||||
html += '<h2 class="text-sm font-semibold text-gray-900 uppercase">On This Page</h2>';
|
|
||||||
html += '<button id="toc-toggle" class="md:hidden p-2 text-gray-600 hover:text-gray-900" aria-label="Toggle table of contents">';
|
|
||||||
html += '<svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">';
|
|
||||||
html += '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"/>';
|
|
||||||
html += '</svg>';
|
|
||||||
html += '</button>';
|
|
||||||
html += '</div>';
|
|
||||||
html += '<ul class="toc-list space-y-2" id="toc-list">';
|
|
||||||
|
|
||||||
this.headings.forEach((heading) => {
|
|
||||||
const level = parseInt(heading.tagName.substring(1)); // h1 -> 1, h2 -> 2, etc.
|
|
||||||
const text = heading.textContent.trim();
|
|
||||||
const id = heading.id;
|
|
||||||
|
|
||||||
// Different indentation for different levels
|
|
||||||
const indent = level === 1 ? '' : level === 2 ? 'ml-3' : 'ml-6';
|
|
||||||
const fontSize = level === 1 ? 'text-sm' : level === 2 ? 'text-sm' : 'text-xs';
|
|
||||||
const fontWeight = level === 1 ? 'font-semibold' : level === 2 ? 'font-medium' : 'font-normal';
|
|
||||||
|
|
||||||
html += `<li class="${indent}">`;
|
|
||||||
html += `<a href="#${id}" class="toc-link block py-1 ${fontSize} ${fontWeight} text-gray-700 hover:text-blue-600 transition-colors border-l-2 border-transparent hover:border-blue-600 pl-2" data-target="${id}">`;
|
|
||||||
html += text;
|
|
||||||
html += '</a>';
|
|
||||||
html += '</li>';
|
|
||||||
});
|
|
||||||
|
|
||||||
html += '</ul>';
|
|
||||||
html += '</nav>';
|
|
||||||
|
|
||||||
return html;
|
|
||||||
}
|
|
||||||
|
|
||||||
initScrollSpy() {
|
|
||||||
// Use Intersection Observer for better performance
|
|
||||||
const observerOptions = {
|
|
||||||
rootMargin: '-20% 0px -35% 0px',
|
|
||||||
threshold: 0
|
|
||||||
};
|
|
||||||
|
|
||||||
const observer = new IntersectionObserver((entries) => {
|
|
||||||
entries.forEach(entry => {
|
|
||||||
if (entry.isIntersecting) {
|
|
||||||
const id = entry.target.id;
|
|
||||||
this.setActiveLink(id);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}, observerOptions);
|
|
||||||
|
|
||||||
// Observe all headings
|
|
||||||
this.headings.forEach(heading => {
|
|
||||||
observer.observe(heading);
|
|
||||||
});
|
|
||||||
|
|
||||||
console.log('[TOC] Scroll spy initialized');
|
|
||||||
}
|
|
||||||
|
|
||||||
setActiveLink(targetId) {
|
|
||||||
// Remove active class from all links
|
|
||||||
this.tocLinks.forEach(link => {
|
|
||||||
link.classList.remove(this.activeClass);
|
|
||||||
link.classList.remove('border-blue-600', 'text-blue-600', 'font-semibold');
|
|
||||||
link.classList.add('border-transparent', 'text-gray-700');
|
|
||||||
});
|
|
||||||
|
|
||||||
// Add active class to current link
|
|
||||||
const activeLink = this.tocLinks.find(link => link.dataset.target === targetId);
|
|
||||||
if (activeLink) {
|
|
||||||
activeLink.classList.add(this.activeClass);
|
|
||||||
activeLink.classList.remove('border-transparent', 'text-gray-700');
|
|
||||||
activeLink.classList.add('border-blue-600', 'text-blue-600', 'font-semibold');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
initSmoothScroll() {
|
|
||||||
this.tocLinks.forEach(link => {
|
|
||||||
link.addEventListener('click', (e) => {
|
|
||||||
e.preventDefault();
|
|
||||||
const targetId = link.dataset.target;
|
|
||||||
const targetElement = document.getElementById(targetId);
|
|
||||||
|
|
||||||
if (targetElement) {
|
|
||||||
// Smooth scroll to target
|
|
||||||
targetElement.scrollIntoView({
|
|
||||||
behavior: 'smooth',
|
|
||||||
block: 'start'
|
|
||||||
});
|
|
||||||
|
|
||||||
// Update URL hash without jumping
|
|
||||||
if (history.pushState) {
|
|
||||||
history.pushState(null, null, `#${targetId}`);
|
|
||||||
} else {
|
|
||||||
window.location.hash = targetId;
|
|
||||||
}
|
|
||||||
|
|
||||||
// On mobile, collapse TOC after clicking
|
|
||||||
if (window.innerWidth < 768) {
|
|
||||||
this.collapseTOC();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
console.log('[TOC] Smooth scroll initialized');
|
|
||||||
}
|
|
||||||
|
|
||||||
initMobileToggle() {
|
|
||||||
const toggleButton = document.getElementById('toc-toggle');
|
|
||||||
const tocList = document.getElementById('toc-list');
|
|
||||||
|
|
||||||
if (!toggleButton || !tocList) return;
|
|
||||||
|
|
||||||
toggleButton.addEventListener('click', () => {
|
|
||||||
const isCollapsed = tocList.classList.contains('hidden');
|
|
||||||
|
|
||||||
if (isCollapsed) {
|
|
||||||
this.expandTOC();
|
|
||||||
} else {
|
|
||||||
this.collapseTOC();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Start collapsed on mobile
|
|
||||||
if (window.innerWidth < 768) {
|
|
||||||
this.collapseTOC();
|
|
||||||
}
|
|
||||||
|
|
||||||
console.log('[TOC] Mobile toggle initialized');
|
|
||||||
}
|
|
||||||
|
|
||||||
collapseTOC() {
|
|
||||||
const tocList = document.getElementById('toc-list');
|
|
||||||
const toggleButton = document.getElementById('toc-toggle');
|
|
||||||
|
|
||||||
if (tocList) {
|
|
||||||
tocList.classList.add('hidden');
|
|
||||||
}
|
|
||||||
|
|
||||||
if (toggleButton) {
|
|
||||||
const svg = toggleButton.querySelector('svg');
|
|
||||||
if (svg) {
|
|
||||||
svg.style.transform = 'rotate(0deg)';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
expandTOC() {
|
|
||||||
const tocList = document.getElementById('toc-list');
|
|
||||||
const toggleButton = document.getElementById('toc-toggle');
|
|
||||||
|
|
||||||
if (tocList) {
|
|
||||||
tocList.classList.remove('hidden');
|
|
||||||
}
|
|
||||||
|
|
||||||
if (toggleButton) {
|
|
||||||
const svg = toggleButton.querySelector('svg');
|
|
||||||
if (svg) {
|
|
||||||
svg.style.transform = 'rotate(180deg)';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Public method to rebuild TOC (useful for dynamically loaded content)
|
|
||||||
rebuild() {
|
|
||||||
this.build();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Auto-initialize when script loads (if TOC container exists)
|
|
||||||
if (typeof window !== 'undefined') {
|
|
||||||
window.tocInstance = new TableOfContents();
|
|
||||||
|
|
||||||
// Listen for custom event from document viewer for dynamic content
|
|
||||||
document.addEventListener('documentLoaded', () => {
|
|
||||||
console.log('[TOC] Document loaded, rebuilding TOC');
|
|
||||||
window.tocInstance.rebuild();
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Export for module usage
|
|
||||||
if (typeof module !== 'undefined' && module.exports) {
|
|
||||||
module.exports = TableOfContents;
|
|
||||||
}
|
|
||||||
|
|
@ -1,625 +0,0 @@
|
||||||
let documents = [];
|
|
||||||
let currentDocument = null;
|
|
||||||
let documentCards = null;
|
|
||||||
|
|
||||||
// Initialize card-based viewer
|
|
||||||
if (typeof DocumentCards !== 'undefined') {
|
|
||||||
documentCards = new DocumentCards('document-content');
|
|
||||||
}
|
|
||||||
|
|
||||||
// Document categorization - Granular categories for better organization
|
|
||||||
const CATEGORIES = {
|
|
||||||
'getting-started': {
|
|
||||||
label: '🚀 Getting Started',
|
|
||||||
icon: '🚀',
|
|
||||||
description: 'Introduction, core concepts, and quick start guides',
|
|
||||||
order: 1,
|
|
||||||
color: 'blue',
|
|
||||||
bgColor: 'bg-blue-50',
|
|
||||||
borderColor: 'border-l-4 border-blue-500',
|
|
||||||
textColor: 'text-blue-700',
|
|
||||||
collapsed: false
|
|
||||||
},
|
|
||||||
'technical-reference': {
|
|
||||||
label: '🔌 Technical Reference',
|
|
||||||
icon: '🔌',
|
|
||||||
description: 'API docs, implementation guides, code examples',
|
|
||||||
order: 2,
|
|
||||||
color: 'green',
|
|
||||||
bgColor: 'bg-green-50',
|
|
||||||
borderColor: 'border-l-4 border-green-500',
|
|
||||||
textColor: 'text-green-700',
|
|
||||||
collapsed: true
|
|
||||||
},
|
|
||||||
'research-theory': {
|
|
||||||
label: '🔬 Theory & Research',
|
|
||||||
icon: '🔬',
|
|
||||||
description: 'Research papers, theoretical foundations, academic content',
|
|
||||||
order: 3,
|
|
||||||
color: 'purple',
|
|
||||||
bgColor: 'bg-purple-50',
|
|
||||||
borderColor: 'border-l-4 border-purple-500',
|
|
||||||
textColor: 'text-purple-700',
|
|
||||||
collapsed: true
|
|
||||||
},
|
|
||||||
'advanced-topics': {
|
|
||||||
label: '🎓 Advanced Topics',
|
|
||||||
icon: '🎓',
|
|
||||||
description: 'Value pluralism, deep dives, comparative analysis',
|
|
||||||
order: 4,
|
|
||||||
color: 'teal',
|
|
||||||
bgColor: 'bg-teal-50',
|
|
||||||
borderColor: 'border-l-4 border-teal-500',
|
|
||||||
textColor: 'text-teal-700',
|
|
||||||
collapsed: true
|
|
||||||
},
|
|
||||||
'case-studies': {
|
|
||||||
label: '📊 Case Studies',
|
|
||||||
icon: '📊',
|
|
||||||
description: 'Real-world examples, failure modes, success stories',
|
|
||||||
order: 5,
|
|
||||||
color: 'amber',
|
|
||||||
bgColor: 'bg-amber-50',
|
|
||||||
borderColor: 'border-l-4 border-amber-500',
|
|
||||||
textColor: 'text-amber-700',
|
|
||||||
collapsed: true
|
|
||||||
},
|
|
||||||
'business-leadership': {
|
|
||||||
label: '💼 Business & Leadership',
|
|
||||||
icon: '💼',
|
|
||||||
description: 'Business cases, executive briefs, ROI analysis',
|
|
||||||
order: 6,
|
|
||||||
color: 'pink',
|
|
||||||
bgColor: 'bg-pink-50',
|
|
||||||
borderColor: 'border-l-4 border-pink-500',
|
|
||||||
textColor: 'text-pink-700',
|
|
||||||
collapsed: true
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
// Documents to hide (internal/confidential)
|
|
||||||
const HIDDEN_DOCS = [
|
|
||||||
'security-audit-report',
|
|
||||||
'koha-production-deployment',
|
|
||||||
'koha-stripe-payment',
|
|
||||||
'appendix-e-contact',
|
|
||||||
'cover-letter'
|
|
||||||
];
|
|
||||||
|
|
||||||
// Categorize a document using database category field
|
|
||||||
// New granular category system for better document organization
|
|
||||||
function categorizeDocument(doc) {
|
|
||||||
const slug = doc.slug.toLowerCase();
|
|
||||||
|
|
||||||
// Skip hidden documents
|
|
||||||
if (HIDDEN_DOCS.some(hidden => slug.includes(hidden))) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Use category from database
|
|
||||||
const category = doc.category || 'downloads-resources';
|
|
||||||
|
|
||||||
// Validate category exists in CATEGORIES constant
|
|
||||||
if (CATEGORIES[category]) {
|
|
||||||
return category;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Fallback to downloads-resources for uncategorized
|
|
||||||
console.warn(`Document "${doc.title}" has invalid category "${category}", using fallback`);
|
|
||||||
return 'downloads-resources';
|
|
||||||
}
|
|
||||||
|
|
||||||
// Group documents by category
|
|
||||||
function groupDocuments(docs) {
|
|
||||||
const grouped = {};
|
|
||||||
|
|
||||||
// Initialize all categories
|
|
||||||
Object.keys(CATEGORIES).forEach(key => {
|
|
||||||
grouped[key] = [];
|
|
||||||
});
|
|
||||||
|
|
||||||
// Categorize each document (already sorted by order from API)
|
|
||||||
docs.forEach(doc => {
|
|
||||||
const category = categorizeDocument(doc);
|
|
||||||
if (category && grouped[category]) {
|
|
||||||
grouped[category].push(doc);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
return grouped;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Render document link with download button
|
|
||||||
function renderDocLink(doc, isHighlighted = false) {
|
|
||||||
const highlightClass = isHighlighted ? 'text-blue-700 bg-blue-50 border border-blue-200' : '';
|
|
||||||
|
|
||||||
// Determine if PDF download is available and get PDF path
|
|
||||||
// First check if document has explicit download_formats.pdf
|
|
||||||
let pdfPath = null;
|
|
||||||
let hasPDF = false;
|
|
||||||
|
|
||||||
if (doc.download_formats && doc.download_formats.pdf) {
|
|
||||||
pdfPath = doc.download_formats.pdf;
|
|
||||||
hasPDF = true;
|
|
||||||
} else if (!doc.slug.includes('api-reference-complete') &&
|
|
||||||
!doc.slug.includes('openapi-specification') &&
|
|
||||||
!doc.slug.includes('api-javascript-examples') &&
|
|
||||||
!doc.slug.includes('api-python-examples') &&
|
|
||||||
!doc.slug.includes('technical-architecture-diagram')) {
|
|
||||||
// Fallback to default /downloads/ path for documents that typically have PDFs
|
|
||||||
pdfPath = `/downloads/${doc.slug}.pdf`;
|
|
||||||
hasPDF = true;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Add download button styling
|
|
||||||
const paddingClass = hasPDF ? 'pr-10' : 'pr-3';
|
|
||||||
|
|
||||||
return `
|
|
||||||
<div class="relative mb-1">
|
|
||||||
<button class="doc-link w-full text-left px-3 py-2 ${paddingClass} rounded text-sm hover:bg-blue-50 transition ${highlightClass}"
|
|
||||||
data-slug="${doc.slug}">
|
|
||||||
<div class="font-medium text-gray-900">${doc.title}</div>
|
|
||||||
</button>
|
|
||||||
${hasPDF ? `
|
|
||||||
<a href="${pdfPath}"
|
|
||||||
target="_blank"
|
|
||||||
rel="noopener noreferrer"
|
|
||||||
class="doc-download-link"
|
|
||||||
title="Download PDF (opens in new tab)">
|
|
||||||
<svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 10v6m0 0l-3-3m3 3l3-3m2 8H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
|
|
||||||
</svg>
|
|
||||||
</a>
|
|
||||||
` : ''}
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Load document list
|
|
||||||
async function loadDocuments() {
|
|
||||||
try {
|
|
||||||
// Fetch public documents
|
|
||||||
const response = await fetch('/api/documents');
|
|
||||||
const data = await response.json();
|
|
||||||
documents = data.documents || [];
|
|
||||||
|
|
||||||
// Fetch archived documents
|
|
||||||
const archivedResponse = await fetch('/api/documents/archived');
|
|
||||||
const archivedData = await archivedResponse.json();
|
|
||||||
const archivedDocuments = archivedData.documents || [];
|
|
||||||
|
|
||||||
const listEl = document.getElementById('document-list');
|
|
||||||
if (documents.length === 0 && archivedDocuments.length === 0) {
|
|
||||||
listEl.innerHTML = '<div class="text-sm text-gray-500">No documents available</div>';
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Group documents by category
|
|
||||||
const grouped = groupDocuments(documents);
|
|
||||||
|
|
||||||
let html = '';
|
|
||||||
|
|
||||||
// Render categories in order
|
|
||||||
const sortedCategories = Object.entries(CATEGORIES)
|
|
||||||
.sort((a, b) => a[1].order - b[1].order);
|
|
||||||
|
|
||||||
sortedCategories.forEach(([categoryId, category]) => {
|
|
||||||
const docs = grouped[categoryId] || [];
|
|
||||||
if (docs.length === 0) return;
|
|
||||||
|
|
||||||
const isCollapsed = category.collapsed || false;
|
|
||||||
|
|
||||||
// Category header
|
|
||||||
html += `
|
|
||||||
<div class="category-section mb-4" data-category="${categoryId}">
|
|
||||||
<button class="category-toggle w-full flex items-center justify-between px-3 py-3 text-sm font-bold ${category.textColor} ${category.bgColor} ${category.borderColor} rounded-r hover:shadow-md transition-all"
|
|
||||||
data-category="${categoryId}"
|
|
||||||
data-collapsed="${isCollapsed}">
|
|
||||||
<span class="flex items-center gap-2">
|
|
||||||
<span class="category-icon">${category.icon}</span>
|
|
||||||
<span>${category.label.replace(category.icon, '').trim()}</span>
|
|
||||||
</span>
|
|
||||||
<svg class="category-arrow w-5 h-5 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"/>
|
|
||||||
</svg>
|
|
||||||
</button>
|
|
||||||
<div class="category-docs mt-2 pl-2" data-category="${categoryId}" data-collapsed="${isCollapsed}">
|
|
||||||
`;
|
|
||||||
|
|
||||||
// Render documents in category
|
|
||||||
docs.forEach(doc => {
|
|
||||||
// Highlight the first document in Getting Started category
|
|
||||||
const isHighlighted = categoryId === 'getting-started' && doc.order === 1;
|
|
||||||
html += renderDocLink(doc, isHighlighted);
|
|
||||||
});
|
|
||||||
|
|
||||||
html += `
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
});
|
|
||||||
|
|
||||||
// Add Archives section if there are archived documents
|
|
||||||
if (archivedDocuments.length > 0) {
|
|
||||||
html += `
|
|
||||||
<div class="category-section mb-4 mt-8" data-category="archives">
|
|
||||||
<button class="category-toggle w-full flex items-center justify-between px-3 py-3 text-sm font-bold text-gray-600 bg-gray-50 border-l-4 border-gray-400 rounded-r hover:shadow-md transition-all"
|
|
||||||
data-category="archives"
|
|
||||||
data-collapsed="true">
|
|
||||||
<span class="flex items-center gap-2">
|
|
||||||
<span class="category-icon">📦</span>
|
|
||||||
<span>Archives</span>
|
|
||||||
<span class="text-xs font-normal text-gray-500">(${archivedDocuments.length} documents)</span>
|
|
||||||
</span>
|
|
||||||
<svg class="category-arrow w-5 h-5 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"/>
|
|
||||||
</svg>
|
|
||||||
</button>
|
|
||||||
<div class="category-docs mt-2 pl-2" data-category="archives" data-collapsed="true">
|
|
||||||
`;
|
|
||||||
|
|
||||||
// Render archived documents
|
|
||||||
archivedDocuments.forEach(doc => {
|
|
||||||
html += renderDocLink(doc, false);
|
|
||||||
// Add archive note if available
|
|
||||||
if (doc.archiveNote) {
|
|
||||||
html += `<div class="text-xs text-gray-500 italic pl-6 mb-2">${doc.archiveNote}</div>`;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
html += `
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
listEl.innerHTML = html;
|
|
||||||
|
|
||||||
// Apply collapsed state to categories (CSP-compliant - no inline styles)
|
|
||||||
listEl.querySelectorAll('.category-docs[data-collapsed="true"]').forEach(docsEl => {
|
|
||||||
docsEl.style.display = 'none';
|
|
||||||
});
|
|
||||||
listEl.querySelectorAll('.category-toggle[data-collapsed="true"] .category-arrow').forEach(arrowEl => {
|
|
||||||
arrowEl.style.transform = 'rotate(-90deg)';
|
|
||||||
});
|
|
||||||
|
|
||||||
// Add event delegation for document links
|
|
||||||
listEl.addEventListener('click', function(e) {
|
|
||||||
// Check for download link first (prevent document load when clicking download)
|
|
||||||
const downloadLink = e.target.closest('.doc-download-link');
|
|
||||||
if (downloadLink) {
|
|
||||||
e.stopPropagation();
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
const button = e.target.closest('.doc-link');
|
|
||||||
if (button && button.dataset.slug) {
|
|
||||||
e.preventDefault();
|
|
||||||
loadDocument(button.dataset.slug);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Category toggle
|
|
||||||
const toggle = e.target.closest('.category-toggle');
|
|
||||||
if (toggle) {
|
|
||||||
const categoryId = toggle.dataset.category;
|
|
||||||
const docsEl = listEl.querySelector(`.category-docs[data-category="${categoryId}"]`);
|
|
||||||
const arrowEl = toggle.querySelector('.category-arrow');
|
|
||||||
|
|
||||||
if (docsEl.style.display === 'none') {
|
|
||||||
docsEl.style.display = 'block';
|
|
||||||
arrowEl.style.transform = 'rotate(0deg)';
|
|
||||||
} else {
|
|
||||||
docsEl.style.display = 'none';
|
|
||||||
arrowEl.style.transform = 'rotate(-90deg)';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Check for URL parameter to auto-load document or category
|
|
||||||
const urlParams = new URLSearchParams(window.location.search);
|
|
||||||
const docParam = urlParams.get('doc');
|
|
||||||
const categoryParam = urlParams.get('category');
|
|
||||||
|
|
||||||
// Priority 1: Load specific document by slug if provided
|
|
||||||
if (docParam) {
|
|
||||||
const doc = documents.find(d => d.slug === docParam);
|
|
||||||
if (doc) {
|
|
||||||
// Find and expand the category containing this document
|
|
||||||
const docCategory = categorizeDocument(doc);
|
|
||||||
if (docCategory) {
|
|
||||||
const categoryDocsEl = listEl.querySelector(`.category-docs[data-category="${docCategory}"]`);
|
|
||||||
const categoryArrowEl = listEl.querySelector(`.category-toggle[data-category="${docCategory}"] .category-arrow`);
|
|
||||||
|
|
||||||
if (categoryDocsEl) {
|
|
||||||
categoryDocsEl.style.display = 'block';
|
|
||||||
if (categoryArrowEl) {
|
|
||||||
categoryArrowEl.style.transform = 'rotate(0deg)';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Load the requested document
|
|
||||||
loadDocument(docParam);
|
|
||||||
} else {
|
|
||||||
console.warn(`Document with slug "${docParam}" not found`);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// Priority 2: Load category if provided but no specific document
|
|
||||||
else if (categoryParam && grouped[categoryParam] && grouped[categoryParam].length > 0) {
|
|
||||||
// Expand the specified category
|
|
||||||
const categoryDocsEl = listEl.querySelector(`.category-docs[data-category="${categoryParam}"]`);
|
|
||||||
const categoryArrowEl = listEl.querySelector(`.category-toggle[data-category="${categoryParam}"] .category-arrow`);
|
|
||||||
|
|
||||||
if (categoryDocsEl) {
|
|
||||||
categoryDocsEl.style.display = 'block';
|
|
||||||
if (categoryArrowEl) {
|
|
||||||
categoryArrowEl.style.transform = 'rotate(0deg)';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Load first document in the category
|
|
||||||
const firstDoc = grouped[categoryParam][0];
|
|
||||||
if (firstDoc) {
|
|
||||||
loadDocument(firstDoc.slug);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// Priority 3: Default behavior
|
|
||||||
else {
|
|
||||||
// Default: Auto-load first document in "Getting Started" category (order: 1)
|
|
||||||
const gettingStartedDocs = grouped['getting-started'] || [];
|
|
||||||
if (gettingStartedDocs.length > 0) {
|
|
||||||
// Load the first document (order: 1) if available
|
|
||||||
const firstDoc = gettingStartedDocs.find(d => d.order === 1);
|
|
||||||
if (firstDoc) {
|
|
||||||
loadDocument(firstDoc.slug);
|
|
||||||
} else {
|
|
||||||
loadDocument(gettingStartedDocs[0].slug);
|
|
||||||
}
|
|
||||||
} else if (documents.length > 0) {
|
|
||||||
// Fallback to first available document in any category
|
|
||||||
const firstCategory = sortedCategories.find(([catId]) => grouped[catId] && grouped[catId].length > 0);
|
|
||||||
if (firstCategory) {
|
|
||||||
loadDocument(grouped[firstCategory[0]][0].slug);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error loading documents:', error);
|
|
||||||
document.getElementById('document-list').innerHTML =
|
|
||||||
'<div class="text-sm text-red-600">Error loading documents</div>';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Load specific document
|
|
||||||
let isLoading = false;
|
|
||||||
|
|
||||||
async function loadDocument(slug) {
|
|
||||||
// Prevent multiple simultaneous loads
|
|
||||||
if (isLoading) return;
|
|
||||||
|
|
||||||
try {
|
|
||||||
isLoading = true;
|
|
||||||
|
|
||||||
// Show loading state
|
|
||||||
const contentEl = document.getElementById('document-content');
|
|
||||||
contentEl.innerHTML = `
|
|
||||||
<div class="text-center py-12">
|
|
||||||
<svg class="animate-spin h-8 w-8 text-blue-600 mx-auto mb-4" fill="none" viewBox="0 0 24 24">
|
|
||||||
<circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
|
|
||||||
<path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path>
|
|
||||||
</svg>
|
|
||||||
<p class="text-gray-600">Loading document...</p>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
|
|
||||||
const response = await fetch(`/api/documents/${slug}`);
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (!data.success) {
|
|
||||||
throw new Error(data.error || 'Failed to load document');
|
|
||||||
}
|
|
||||||
|
|
||||||
currentDocument = data.document;
|
|
||||||
|
|
||||||
// Update active state
|
|
||||||
document.querySelectorAll('.doc-link').forEach(el => {
|
|
||||||
if (el.dataset.slug === slug) {
|
|
||||||
el.classList.add('bg-blue-100', 'text-blue-900');
|
|
||||||
} else {
|
|
||||||
el.classList.remove('bg-blue-100', 'text-blue-900');
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Render with card-based viewer if available and document has sections
|
|
||||||
if (documentCards && currentDocument.sections && currentDocument.sections.length > 0) {
|
|
||||||
documentCards.render(currentDocument);
|
|
||||||
} else {
|
|
||||||
// Fallback to traditional view with header
|
|
||||||
const hasToC = currentDocument.toc && currentDocument.toc.length > 0;
|
|
||||||
|
|
||||||
// Check if PDF is available and get PDF path
|
|
||||||
let pdfPath = null;
|
|
||||||
let hasPDF = false;
|
|
||||||
|
|
||||||
if (currentDocument.download_formats && currentDocument.download_formats.pdf) {
|
|
||||||
pdfPath = currentDocument.download_formats.pdf;
|
|
||||||
hasPDF = true;
|
|
||||||
} else if (!currentDocument.slug.includes('api-reference-complete') &&
|
|
||||||
!currentDocument.slug.includes('openapi-specification') &&
|
|
||||||
!currentDocument.slug.includes('api-javascript-examples') &&
|
|
||||||
!currentDocument.slug.includes('api-python-examples') &&
|
|
||||||
!currentDocument.slug.includes('technical-architecture-diagram')) {
|
|
||||||
pdfPath = `/downloads/${currentDocument.slug}.pdf`;
|
|
||||||
hasPDF = true;
|
|
||||||
}
|
|
||||||
|
|
||||||
let headerHTML = `
|
|
||||||
<div class="flex items-center justify-between mb-6 pb-4 border-b border-gray-200">
|
|
||||||
<h1 class="text-3xl font-bold text-gray-900">${currentDocument.title}</h1>
|
|
||||||
<div class="flex items-center gap-2">
|
|
||||||
${hasToC ? `
|
|
||||||
<button id="toc-button"
|
|
||||||
class="p-2 text-gray-600 hover:text-blue-600 hover:bg-blue-50 rounded transition"
|
|
||||||
title="Table of Contents"
|
|
||||||
aria-label="Show table of contents">
|
|
||||||
<svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h7"/>
|
|
||||||
</svg>
|
|
||||||
</button>
|
|
||||||
` : ''}
|
|
||||||
${hasPDF ? `
|
|
||||||
<a href="${pdfPath}"
|
|
||||||
target="_blank"
|
|
||||||
rel="noopener noreferrer"
|
|
||||||
class="p-2 text-gray-600 hover:text-blue-600 hover:bg-blue-50 rounded transition"
|
|
||||||
title="Download PDF"
|
|
||||||
aria-label="Download PDF">
|
|
||||||
<svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 10v6m0 0l-3-3m3 3l3-3m2 8H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
|
|
||||||
</svg>
|
|
||||||
</a>
|
|
||||||
` : ''}
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
|
|
||||||
// Remove duplicate title H1 from content (it's already in header)
|
|
||||||
let contentHtml = currentDocument.content_html;
|
|
||||||
const firstH1Match = contentHtml.match(/<h1[^>]*>.*?<\/h1>/);
|
|
||||||
if (firstH1Match) {
|
|
||||||
contentHtml = contentHtml.replace(firstH1Match[0], '');
|
|
||||||
}
|
|
||||||
|
|
||||||
contentEl.innerHTML = headerHTML + `
|
|
||||||
<div class="prose max-w-none">
|
|
||||||
${contentHtml}
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Add ToC button event listener (works for both card and traditional views)
|
|
||||||
setTimeout(() => {
|
|
||||||
const tocButton = document.getElementById('toc-button');
|
|
||||||
if (tocButton) {
|
|
||||||
tocButton.addEventListener('click', () => openToCModal());
|
|
||||||
}
|
|
||||||
}, 100);
|
|
||||||
|
|
||||||
// Mobile navigation: Add document-active class to show document view
|
|
||||||
document.body.classList.add('document-active');
|
|
||||||
|
|
||||||
// Scroll to top
|
|
||||||
window.scrollTo({ top: 0, behavior: 'smooth' });
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error loading document:', error);
|
|
||||||
document.getElementById('document-content').innerHTML = `
|
|
||||||
<div class="text-center py-12">
|
|
||||||
<svg class="h-12 w-12 text-red-400 mx-auto mb-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
|
|
||||||
</svg>
|
|
||||||
<h3 class="text-lg font-medium text-gray-900 mb-2">Error loading document</h3>
|
|
||||||
<p class="text-sm text-gray-600">${error.message}</p>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
} finally {
|
|
||||||
isLoading = false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Open ToC modal
|
|
||||||
function openToCModal() {
|
|
||||||
if (!currentDocument || !currentDocument.toc || currentDocument.toc.length === 0) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
const modal = document.getElementById('toc-modal');
|
|
||||||
if (!modal) return;
|
|
||||||
|
|
||||||
// Render ToC content
|
|
||||||
const tocContent = document.getElementById('toc-modal-content');
|
|
||||||
|
|
||||||
const tocHTML = currentDocument.toc
|
|
||||||
.filter(item => item.level <= 3) // Only show H1, H2, H3
|
|
||||||
.map(item => {
|
|
||||||
return `
|
|
||||||
<a href="#${item.slug}"
|
|
||||||
class="block py-2 px-3 text-gray-700 hover:bg-blue-50 hover:text-blue-700 rounded transition toc-link toc-indent-${item.level}"
|
|
||||||
data-slug="${item.slug}">
|
|
||||||
${item.title}
|
|
||||||
</a>
|
|
||||||
`;
|
|
||||||
}).join('');
|
|
||||||
|
|
||||||
tocContent.innerHTML = tocHTML;
|
|
||||||
|
|
||||||
// Show modal
|
|
||||||
modal.classList.add('show');
|
|
||||||
|
|
||||||
// Prevent body scroll and reset modal content scroll
|
|
||||||
document.body.style.overflow = 'hidden';
|
|
||||||
tocContent.scrollTop = 0;
|
|
||||||
|
|
||||||
// Add event listeners to ToC links
|
|
||||||
tocContent.querySelectorAll('.toc-link').forEach(link => {
|
|
||||||
link.addEventListener('click', (e) => {
|
|
||||||
e.preventDefault();
|
|
||||||
const targetId = link.getAttribute('href').substring(1);
|
|
||||||
const targetEl = document.getElementById(targetId);
|
|
||||||
if (targetEl) {
|
|
||||||
closeToCModal();
|
|
||||||
setTimeout(() => {
|
|
||||||
targetEl.scrollIntoView({ behavior: 'smooth', block: 'start' });
|
|
||||||
}, 200);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Close ToC modal
|
|
||||||
function closeToCModal() {
|
|
||||||
const modal = document.getElementById('toc-modal');
|
|
||||||
if (modal) {
|
|
||||||
modal.classList.remove('show');
|
|
||||||
document.body.style.overflow = '';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Initialize
|
|
||||||
loadDocuments();
|
|
||||||
|
|
||||||
// Add ESC key listener for closing modal
|
|
||||||
document.addEventListener('keydown', (e) => {
|
|
||||||
if (e.key === 'Escape') {
|
|
||||||
closeToCModal();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Add close button listener for ToC modal (script loads after DOM, so elements exist)
|
|
||||||
const closeButton = document.getElementById('toc-close-button');
|
|
||||||
if (closeButton) {
|
|
||||||
closeButton.addEventListener('click', closeToCModal);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Click outside modal to close
|
|
||||||
const modal = document.getElementById('toc-modal');
|
|
||||||
if (modal) {
|
|
||||||
modal.addEventListener('click', function(e) {
|
|
||||||
if (e.target === this) {
|
|
||||||
closeToCModal();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Mobile navigation: Back to documents button
|
|
||||||
const backButton = document.getElementById('back-to-docs-btn');
|
|
||||||
if (backButton) {
|
|
||||||
backButton.addEventListener('click', function() {
|
|
||||||
// Remove document-active class to show sidebar
|
|
||||||
document.body.classList.remove('document-active');
|
|
||||||
|
|
||||||
// Scroll to top
|
|
||||||
window.scrollTo({ top: 0, behavior: 'smooth' });
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
@ -1,650 +0,0 @@
|
||||||
/**
|
|
||||||
* Docs Search Enhancement Module
|
|
||||||
* Provides faceted search, filters, history, and keyboard navigation
|
|
||||||
* CSP Compliant - No inline scripts or event handlers
|
|
||||||
*/
|
|
||||||
|
|
||||||
(function() {
|
|
||||||
'use strict';
|
|
||||||
|
|
||||||
// Configuration
|
|
||||||
const CONFIG = {
|
|
||||||
DEBOUNCE_DELAY: 300,
|
|
||||||
MAX_SEARCH_HISTORY: 10,
|
|
||||||
SEARCH_HISTORY_KEY: 'tractatus_search_history',
|
|
||||||
MIN_QUERY_LENGTH: 2
|
|
||||||
};
|
|
||||||
|
|
||||||
// State
|
|
||||||
let searchTimeout = null;
|
|
||||||
let currentFilters = {
|
|
||||||
query: '',
|
|
||||||
quadrant: '',
|
|
||||||
persistence: '',
|
|
||||||
audience: ''
|
|
||||||
};
|
|
||||||
let searchHistory = [];
|
|
||||||
let selectedResultIndex = -1;
|
|
||||||
let searchResults = [];
|
|
||||||
|
|
||||||
// DOM Elements
|
|
||||||
const elements = {
|
|
||||||
searchInput: null,
|
|
||||||
quadrantFilter: null,
|
|
||||||
persistenceFilter: null,
|
|
||||||
audienceFilter: null,
|
|
||||||
clearFiltersBtn: null,
|
|
||||||
searchTipsBtn: null,
|
|
||||||
searchTipsModal: null,
|
|
||||||
searchTipsCloseBtn: null,
|
|
||||||
searchResultsPanel: null,
|
|
||||||
searchResultsList: null,
|
|
||||||
closeSearchResults: null,
|
|
||||||
searchResultsSummary: null,
|
|
||||||
searchResultsCount: null,
|
|
||||||
searchHistoryContainer: null,
|
|
||||||
searchHistory: null,
|
|
||||||
searchModal: null,
|
|
||||||
openSearchModalBtn: null,
|
|
||||||
searchModalCloseBtn: null,
|
|
||||||
searchResultsModal: null,
|
|
||||||
searchResultsListModal: null
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Initialize the search enhancement module
|
|
||||||
*/
|
|
||||||
function init() {
|
|
||||||
// Get DOM elements
|
|
||||||
elements.searchInput = document.getElementById('docs-search-input');
|
|
||||||
elements.quadrantFilter = document.getElementById('filter-quadrant');
|
|
||||||
elements.persistenceFilter = document.getElementById('filter-persistence');
|
|
||||||
elements.audienceFilter = document.getElementById('filter-audience');
|
|
||||||
elements.clearFiltersBtn = document.getElementById('clear-filters-btn');
|
|
||||||
elements.searchTipsBtn = document.getElementById('search-tips-btn');
|
|
||||||
elements.searchTipsModal = document.getElementById('search-tips-modal');
|
|
||||||
elements.searchTipsCloseBtn = document.getElementById('search-tips-close-btn');
|
|
||||||
elements.searchResultsPanel = document.getElementById('search-results-panel');
|
|
||||||
elements.searchResultsList = document.getElementById('search-results-list');
|
|
||||||
elements.closeSearchResults = document.getElementById('close-search-results');
|
|
||||||
elements.searchResultsSummary = document.getElementById('search-results-summary');
|
|
||||||
elements.searchResultsCount = document.getElementById('search-results-count');
|
|
||||||
elements.searchHistoryContainer = document.getElementById('search-history-container');
|
|
||||||
elements.searchHistory = document.getElementById('search-history');
|
|
||||||
elements.searchModal = document.getElementById('search-modal');
|
|
||||||
elements.openSearchModalBtn = document.getElementById('open-search-modal-btn');
|
|
||||||
elements.searchModalCloseBtn = document.getElementById('search-modal-close-btn');
|
|
||||||
elements.searchResultsModal = document.getElementById('search-results-modal');
|
|
||||||
elements.searchResultsListModal = document.getElementById('search-results-list-modal');
|
|
||||||
|
|
||||||
// Check if essential elements exist
|
|
||||||
if (!elements.searchInput || !elements.searchModal) {
|
|
||||||
console.warn('Search elements not found - search enhancement disabled');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Load search history from localStorage
|
|
||||||
loadSearchHistory();
|
|
||||||
|
|
||||||
// Attach event listeners
|
|
||||||
attachEventListeners();
|
|
||||||
|
|
||||||
// Display search history if available
|
|
||||||
renderSearchHistory();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Attach event listeners (CSP compliant - no inline handlers)
|
|
||||||
*/
|
|
||||||
function attachEventListeners() {
|
|
||||||
// Search modal open/close
|
|
||||||
if (elements.openSearchModalBtn) {
|
|
||||||
elements.openSearchModalBtn.addEventListener('click', openSearchModal);
|
|
||||||
}
|
|
||||||
if (elements.searchModalCloseBtn) {
|
|
||||||
elements.searchModalCloseBtn.addEventListener('click', closeSearchModal);
|
|
||||||
}
|
|
||||||
if (elements.searchModal) {
|
|
||||||
elements.searchModal.addEventListener('click', function(e) {
|
|
||||||
if (e.target === elements.searchModal) {
|
|
||||||
closeSearchModal();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Search input - debounced
|
|
||||||
if (elements.searchInput) {
|
|
||||||
elements.searchInput.addEventListener('input', handleSearchInput);
|
|
||||||
elements.searchInput.addEventListener('keydown', handleSearchKeydown);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Filter dropdowns
|
|
||||||
if (elements.quadrantFilter) {
|
|
||||||
elements.quadrantFilter.addEventListener('change', handleFilterChange);
|
|
||||||
}
|
|
||||||
if (elements.persistenceFilter) {
|
|
||||||
elements.persistenceFilter.addEventListener('change', handleFilterChange);
|
|
||||||
}
|
|
||||||
if (elements.audienceFilter) {
|
|
||||||
elements.audienceFilter.addEventListener('change', handleFilterChange);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Clear filters button
|
|
||||||
if (elements.clearFiltersBtn) {
|
|
||||||
elements.clearFiltersBtn.addEventListener('click', clearFilters);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Search tips button
|
|
||||||
if (elements.searchTipsBtn) {
|
|
||||||
elements.searchTipsBtn.addEventListener('click', openSearchTipsModal);
|
|
||||||
}
|
|
||||||
if (elements.searchTipsCloseBtn) {
|
|
||||||
elements.searchTipsCloseBtn.addEventListener('click', closeSearchTipsModal);
|
|
||||||
}
|
|
||||||
if (elements.searchTipsModal) {
|
|
||||||
elements.searchTipsModal.addEventListener('click', function(e) {
|
|
||||||
if (e.target === elements.searchTipsModal) {
|
|
||||||
closeSearchTipsModal();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Close search results
|
|
||||||
if (elements.closeSearchResults) {
|
|
||||||
elements.closeSearchResults.addEventListener('click', closeSearchResultsPanel);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Global keyboard shortcuts
|
|
||||||
document.addEventListener('keydown', handleGlobalKeydown);
|
|
||||||
|
|
||||||
// Escape key to close modals
|
|
||||||
document.addEventListener('keydown', function(e) {
|
|
||||||
if (e.key === 'Escape') {
|
|
||||||
closeSearchTipsModal();
|
|
||||||
closeSearchModal();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle search input with debounce
|
|
||||||
*/
|
|
||||||
function handleSearchInput(e) {
|
|
||||||
const query = e.target.value.trim();
|
|
||||||
|
|
||||||
// Clear previous timeout
|
|
||||||
if (searchTimeout) {
|
|
||||||
clearTimeout(searchTimeout);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Debounce search
|
|
||||||
searchTimeout = setTimeout(() => {
|
|
||||||
currentFilters.query = query;
|
|
||||||
performSearch();
|
|
||||||
}, CONFIG.DEBOUNCE_DELAY);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle keyboard navigation in search input
|
|
||||||
*/
|
|
||||||
function handleSearchKeydown(e) {
|
|
||||||
if (e.key === 'Enter') {
|
|
||||||
e.preventDefault();
|
|
||||||
const query = e.target.value.trim();
|
|
||||||
if (query) {
|
|
||||||
currentFilters.query = query;
|
|
||||||
performSearch();
|
|
||||||
}
|
|
||||||
} else if (e.key === 'Escape') {
|
|
||||||
closeSearchResultsPanel();
|
|
||||||
closeSearchModal();
|
|
||||||
e.target.blur();
|
|
||||||
} else if (e.key === 'ArrowDown') {
|
|
||||||
e.preventDefault();
|
|
||||||
navigateResults('down');
|
|
||||||
} else if (e.key === 'ArrowUp') {
|
|
||||||
e.preventDefault();
|
|
||||||
navigateResults('up');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle filter changes
|
|
||||||
*/
|
|
||||||
function handleFilterChange() {
|
|
||||||
currentFilters.quadrant = elements.quadrantFilter ? elements.quadrantFilter.value : '';
|
|
||||||
currentFilters.persistence = elements.persistenceFilter ? elements.persistenceFilter.value : '';
|
|
||||||
currentFilters.audience = elements.audienceFilter ? elements.audienceFilter.value : '';
|
|
||||||
|
|
||||||
performSearch();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Clear all filters
|
|
||||||
*/
|
|
||||||
function clearFilters() {
|
|
||||||
if (elements.searchInput) elements.searchInput.value = '';
|
|
||||||
if (elements.quadrantFilter) elements.quadrantFilter.value = '';
|
|
||||||
if (elements.persistenceFilter) elements.persistenceFilter.value = '';
|
|
||||||
if (elements.audienceFilter) elements.audienceFilter.value = '';
|
|
||||||
|
|
||||||
currentFilters = {
|
|
||||||
query: '',
|
|
||||||
quadrant: '',
|
|
||||||
persistence: '',
|
|
||||||
audience: ''
|
|
||||||
};
|
|
||||||
|
|
||||||
closeSearchResultsPanel();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Perform search with current filters
|
|
||||||
*/
|
|
||||||
async function performSearch() {
|
|
||||||
const { query, quadrant, persistence, audience } = currentFilters;
|
|
||||||
|
|
||||||
// If no query and no filters, don't search
|
|
||||||
if (!query && !quadrant && !persistence && !audience) {
|
|
||||||
closeSearchResultsPanel();
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Build query params
|
|
||||||
const params = new URLSearchParams();
|
|
||||||
if (query) params.append('q', query);
|
|
||||||
if (quadrant) params.append('quadrant', quadrant);
|
|
||||||
if (persistence) params.append('persistence', persistence);
|
|
||||||
if (audience) params.append('audience', audience);
|
|
||||||
|
|
||||||
try {
|
|
||||||
const startTime = performance.now();
|
|
||||||
const response = await fetch(`/api/documents/search?${params.toString()}`);
|
|
||||||
const endTime = performance.now();
|
|
||||||
const duration = Math.round(endTime - startTime);
|
|
||||||
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (data.success) {
|
|
||||||
searchResults = data.documents || [];
|
|
||||||
renderSearchResults(data, duration);
|
|
||||||
|
|
||||||
// Save to search history if query exists
|
|
||||||
if (query) {
|
|
||||||
addToSearchHistory(query);
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
showError('Search failed. Please try again.');
|
|
||||||
}
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Search error:', error);
|
|
||||||
showError('Search failed. Please check your connection.');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render search results
|
|
||||||
*/
|
|
||||||
function renderSearchResults(data, duration) {
|
|
||||||
// Use modal list if available, otherwise fall back to panel list
|
|
||||||
const targetList = elements.searchResultsListModal || elements.searchResultsList;
|
|
||||||
const targetContainer = elements.searchResultsModal || elements.searchResultsPanel;
|
|
||||||
|
|
||||||
if (!targetList) return;
|
|
||||||
|
|
||||||
const { documents, count, total, filters } = data;
|
|
||||||
|
|
||||||
// Show results container
|
|
||||||
if (targetContainer) {
|
|
||||||
targetContainer.classList.remove('hidden');
|
|
||||||
}
|
|
||||||
|
|
||||||
// Update summary
|
|
||||||
if (elements.searchResultsSummary && elements.searchResultsCount) {
|
|
||||||
elements.searchResultsSummary.classList.remove('hidden');
|
|
||||||
|
|
||||||
let summaryText = `Found ${total} document${total !== 1 ? 's' : ''}`;
|
|
||||||
if (duration) {
|
|
||||||
summaryText += ` (${duration}ms)`;
|
|
||||||
}
|
|
||||||
|
|
||||||
const activeFilters = [];
|
|
||||||
if (filters.quadrant) activeFilters.push(`Quadrant: ${filters.quadrant}`);
|
|
||||||
if (filters.persistence) activeFilters.push(`Persistence: ${filters.persistence}`);
|
|
||||||
if (filters.audience) activeFilters.push(`Audience: ${filters.audience}`);
|
|
||||||
|
|
||||||
if (activeFilters.length > 0) {
|
|
||||||
summaryText += ` • Filters: ${activeFilters.join(', ')}`;
|
|
||||||
}
|
|
||||||
|
|
||||||
elements.searchResultsCount.textContent = summaryText;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Render results
|
|
||||||
if (documents.length === 0) {
|
|
||||||
targetList.innerHTML = `
|
|
||||||
<div class="text-center py-8 text-gray-500">
|
|
||||||
<svg class="w-12 h-12 mx-auto mb-4 text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"/>
|
|
||||||
</svg>
|
|
||||||
<p class="text-lg font-medium">No documents found</p>
|
|
||||||
<p class="text-sm mt-2">Try adjusting your search terms or filters</p>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
const resultsHTML = documents.map((doc, index) => {
|
|
||||||
const badges = [];
|
|
||||||
if (doc.quadrant) badges.push(`<span class="px-2 py-1 bg-blue-100 text-blue-700 rounded text-xs font-medium">${doc.quadrant}</span>`);
|
|
||||||
if (doc.persistence) badges.push(`<span class="px-2 py-1 bg-green-100 text-green-700 rounded text-xs font-medium">${doc.persistence}</span>`);
|
|
||||||
if (doc.audience) badges.push(`<span class="px-2 py-1 bg-purple-100 text-purple-700 rounded text-xs font-medium">${doc.audience}</span>`);
|
|
||||||
|
|
||||||
// Highlight query terms in title (simple highlighting)
|
|
||||||
let highlightedTitle = doc.title;
|
|
||||||
if (currentFilters.query) {
|
|
||||||
const regex = new RegExp(`(${escapeRegex(currentFilters.query)})`, 'gi');
|
|
||||||
highlightedTitle = doc.title.replace(regex, '<mark class="bg-yellow-200">$1</mark>');
|
|
||||||
}
|
|
||||||
|
|
||||||
return `
|
|
||||||
<div class="search-result-item p-4 border border-gray-200 rounded-lg hover:border-blue-500 hover:shadow-md transition cursor-pointer ${index === selectedResultIndex ? 'border-blue-500 bg-blue-50' : ''}"
|
|
||||||
data-slug="${doc.slug}"
|
|
||||||
data-index="${index}">
|
|
||||||
<div class="flex items-start justify-between gap-4">
|
|
||||||
<div class="flex-1">
|
|
||||||
<h3 class="text-lg font-semibold text-gray-900 mb-2">${highlightedTitle}</h3>
|
|
||||||
<div class="flex flex-wrap gap-2 mb-3">
|
|
||||||
${badges.join('')}
|
|
||||||
</div>
|
|
||||||
<p class="text-sm text-gray-600 line-clamp-2">${doc.metadata?.description || 'Framework documentation'}</p>
|
|
||||||
</div>
|
|
||||||
<a href="/downloads/${doc.slug}.pdf"
|
|
||||||
class="flex-shrink-0 p-2 text-blue-600 hover:text-blue-700 hover:bg-blue-50 rounded transition"
|
|
||||||
title="Download PDF"
|
|
||||||
aria-label="Download PDF">
|
|
||||||
<svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 10v6m0 0l-3-3m3 3l3-3m2 8H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
|
|
||||||
</svg>
|
|
||||||
</a>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}).join('');
|
|
||||||
|
|
||||||
targetList.innerHTML = resultsHTML;
|
|
||||||
|
|
||||||
// Attach click handlers to results
|
|
||||||
document.querySelectorAll('.search-result-item').forEach(item => {
|
|
||||||
item.addEventListener('click', function(e) {
|
|
||||||
// Don't navigate if clicking download link
|
|
||||||
if (e.target.closest('a[href*="/downloads/"]')) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
const slug = this.dataset.slug;
|
|
||||||
if (slug && typeof loadDocument === 'function') {
|
|
||||||
loadDocument(slug);
|
|
||||||
closeSearchResultsPanel();
|
|
||||||
closeSearchModal();
|
|
||||||
window.scrollTo({ top: 0, behavior: 'smooth' });
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
// Reset selected index
|
|
||||||
selectedResultIndex = -1;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Navigate search results with keyboard
|
|
||||||
*/
|
|
||||||
function navigateResults(direction) {
|
|
||||||
if (searchResults.length === 0) return;
|
|
||||||
|
|
||||||
if (direction === 'down') {
|
|
||||||
selectedResultIndex = Math.min(selectedResultIndex + 1, searchResults.length - 1);
|
|
||||||
} else if (direction === 'up') {
|
|
||||||
selectedResultIndex = Math.max(selectedResultIndex - 1, -1);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Re-render to show selection
|
|
||||||
if (searchResults.length > 0) {
|
|
||||||
const items = document.querySelectorAll('.search-result-item');
|
|
||||||
items.forEach((item, index) => {
|
|
||||||
if (index === selectedResultIndex) {
|
|
||||||
item.classList.add('border-blue-500', 'bg-blue-50');
|
|
||||||
item.scrollIntoView({ behavior: 'smooth', block: 'nearest' });
|
|
||||||
} else {
|
|
||||||
item.classList.remove('border-blue-500', 'bg-blue-50');
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// If Enter key pressed on selected result
|
|
||||||
if (selectedResultIndex >= 0) {
|
|
||||||
const selectedSlug = searchResults[selectedResultIndex].slug;
|
|
||||||
// Store for Enter key handler
|
|
||||||
document.addEventListener('keydown', function enterHandler(e) {
|
|
||||||
if (e.key === 'Enter' && selectedResultIndex >= 0) {
|
|
||||||
if (typeof loadDocument === 'function') {
|
|
||||||
loadDocument(selectedSlug);
|
|
||||||
closeSearchResultsPanel();
|
|
||||||
}
|
|
||||||
document.removeEventListener('keydown', enterHandler);
|
|
||||||
}
|
|
||||||
}, { once: true });
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Close search results panel
|
|
||||||
*/
|
|
||||||
function closeSearchResultsPanel() {
|
|
||||||
if (elements.searchResultsPanel) {
|
|
||||||
elements.searchResultsPanel.classList.add('hidden');
|
|
||||||
}
|
|
||||||
if (elements.searchResultsSummary) {
|
|
||||||
elements.searchResultsSummary.classList.add('hidden');
|
|
||||||
}
|
|
||||||
selectedResultIndex = -1;
|
|
||||||
searchResults = [];
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Show error message
|
|
||||||
*/
|
|
||||||
function showError(message) {
|
|
||||||
if (elements.searchResultsList) {
|
|
||||||
elements.searchResultsList.innerHTML = `
|
|
||||||
<div class="text-center py-8 text-red-500">
|
|
||||||
<svg class="w-12 h-12 mx-auto mb-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
|
|
||||||
</svg>
|
|
||||||
<p class="text-lg font-medium">${message}</p>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Open search tips modal
|
|
||||||
*/
|
|
||||||
function openSearchTipsModal() {
|
|
||||||
if (elements.searchTipsModal) {
|
|
||||||
elements.searchTipsModal.classList.remove('hidden');
|
|
||||||
elements.searchTipsModal.classList.add('flex');
|
|
||||||
document.body.style.overflow = 'hidden';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Close search tips modal
|
|
||||||
*/
|
|
||||||
function closeSearchTipsModal() {
|
|
||||||
if (elements.searchTipsModal) {
|
|
||||||
elements.searchTipsModal.classList.add('hidden');
|
|
||||||
elements.searchTipsModal.classList.remove('flex');
|
|
||||||
document.body.style.overflow = '';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Open search modal
|
|
||||||
*/
|
|
||||||
function openSearchModal() {
|
|
||||||
if (elements.searchModal) {
|
|
||||||
elements.searchModal.classList.remove('hidden');
|
|
||||||
elements.searchModal.classList.add('show');
|
|
||||||
document.body.style.overflow = 'hidden';
|
|
||||||
|
|
||||||
// Focus search input after modal opens
|
|
||||||
setTimeout(() => {
|
|
||||||
if (elements.searchInput) {
|
|
||||||
elements.searchInput.focus();
|
|
||||||
}
|
|
||||||
}, 100);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Close search modal
|
|
||||||
*/
|
|
||||||
function closeSearchModal() {
|
|
||||||
if (elements.searchModal) {
|
|
||||||
elements.searchModal.classList.remove('show');
|
|
||||||
elements.searchModal.classList.add('hidden');
|
|
||||||
document.body.style.overflow = '';
|
|
||||||
|
|
||||||
// Clear search when closing
|
|
||||||
clearFilters();
|
|
||||||
|
|
||||||
// Hide results
|
|
||||||
if (elements.searchResultsModal) {
|
|
||||||
elements.searchResultsModal.classList.add('hidden');
|
|
||||||
}
|
|
||||||
if (elements.searchResultsSummary) {
|
|
||||||
elements.searchResultsSummary.classList.add('hidden');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle global keyboard shortcuts
|
|
||||||
*/
|
|
||||||
function handleGlobalKeydown(e) {
|
|
||||||
// Ctrl+K or Cmd+K to open search modal
|
|
||||||
if ((e.ctrlKey || e.metaKey) && e.key === 'k') {
|
|
||||||
e.preventDefault();
|
|
||||||
openSearchModal();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Load search history from localStorage
|
|
||||||
*/
|
|
||||||
function loadSearchHistory() {
|
|
||||||
try {
|
|
||||||
const stored = localStorage.getItem(CONFIG.SEARCH_HISTORY_KEY);
|
|
||||||
if (stored) {
|
|
||||||
searchHistory = JSON.parse(stored);
|
|
||||||
}
|
|
||||||
} catch (error) {
|
|
||||||
console.warn('Failed to load search history:', error);
|
|
||||||
searchHistory = [];
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Save search history to localStorage
|
|
||||||
*/
|
|
||||||
function saveSearchHistory() {
|
|
||||||
try {
|
|
||||||
localStorage.setItem(CONFIG.SEARCH_HISTORY_KEY, JSON.stringify(searchHistory));
|
|
||||||
} catch (error) {
|
|
||||||
console.warn('Failed to save search history:', error);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Add query to search history
|
|
||||||
*/
|
|
||||||
function addToSearchHistory(query) {
|
|
||||||
if (!query || query.length < CONFIG.MIN_QUERY_LENGTH) return;
|
|
||||||
|
|
||||||
// Remove duplicates
|
|
||||||
searchHistory = searchHistory.filter(item => item !== query);
|
|
||||||
|
|
||||||
// Add to beginning
|
|
||||||
searchHistory.unshift(query);
|
|
||||||
|
|
||||||
// Limit size
|
|
||||||
if (searchHistory.length > CONFIG.MAX_SEARCH_HISTORY) {
|
|
||||||
searchHistory = searchHistory.slice(0, CONFIG.MAX_SEARCH_HISTORY);
|
|
||||||
}
|
|
||||||
|
|
||||||
saveSearchHistory();
|
|
||||||
renderSearchHistory();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Render search history
|
|
||||||
*/
|
|
||||||
function renderSearchHistory() {
|
|
||||||
if (!elements.searchHistory || !elements.searchHistoryContainer) return;
|
|
||||||
|
|
||||||
if (searchHistory.length === 0) {
|
|
||||||
elements.searchHistoryContainer.classList.add('hidden');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
elements.searchHistoryContainer.classList.remove('hidden');
|
|
||||||
|
|
||||||
const historyHTML = searchHistory.slice(0, 5).map(query => {
|
|
||||||
return `
|
|
||||||
<button class="search-history-item px-3 py-1.5 text-sm bg-white border border-gray-300 rounded-full hover:bg-gray-50 hover:border-gray-400 transition"
|
|
||||||
data-query="${escapeHtml(query)}">
|
|
||||||
${escapeHtml(query)}
|
|
||||||
</button>
|
|
||||||
`;
|
|
||||||
}).join('');
|
|
||||||
|
|
||||||
elements.searchHistory.innerHTML = historyHTML;
|
|
||||||
|
|
||||||
// Attach click handlers
|
|
||||||
document.querySelectorAll('.search-history-item').forEach(item => {
|
|
||||||
item.addEventListener('click', function() {
|
|
||||||
const query = this.dataset.query;
|
|
||||||
if (elements.searchInput) {
|
|
||||||
elements.searchInput.value = query;
|
|
||||||
currentFilters.query = query;
|
|
||||||
performSearch();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Escape HTML to prevent XSS
|
|
||||||
*/
|
|
||||||
function escapeHtml(text) {
|
|
||||||
const div = document.createElement('div');
|
|
||||||
div.textContent = text;
|
|
||||||
return div.innerHTML;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Escape regex special characters
|
|
||||||
*/
|
|
||||||
function escapeRegex(text) {
|
|
||||||
return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
||||||
}
|
|
||||||
|
|
||||||
// Initialize when DOM is ready
|
|
||||||
if (document.readyState === 'loading') {
|
|
||||||
document.addEventListener('DOMContentLoaded', init);
|
|
||||||
} else {
|
|
||||||
init();
|
|
||||||
}
|
|
||||||
|
|
||||||
})();
|
|
||||||
|
|
@ -1,35 +0,0 @@
|
||||||
// Initialize document viewer
|
|
||||||
const viewer = new DocumentViewer('document-viewer');
|
|
||||||
|
|
||||||
// Load navigation
|
|
||||||
async function loadNavigation() {
|
|
||||||
try {
|
|
||||||
const response = await API.Documents.list({ limit: 50 });
|
|
||||||
const nav = document.getElementById('doc-navigation');
|
|
||||||
|
|
||||||
if (response.success && response.documents) {
|
|
||||||
nav.innerHTML = response.documents.map(doc => `
|
|
||||||
<a href="/docs/${doc.slug}"
|
|
||||||
data-route="/docs/${doc.slug}"
|
|
||||||
class="block px-3 py-2 text-sm text-gray-700 hover:bg-gray-100 rounded-md">
|
|
||||||
${doc.title}
|
|
||||||
</a>
|
|
||||||
`).join('');
|
|
||||||
}
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Failed to load navigation:', error);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Setup routing
|
|
||||||
router
|
|
||||||
.on('/docs-viewer.html', async () => {
|
|
||||||
// Show default document
|
|
||||||
await viewer.render('introduction-to-the-tractatus-framework');
|
|
||||||
})
|
|
||||||
.on('/docs/:slug', async (params) => {
|
|
||||||
await viewer.render(params.slug);
|
|
||||||
});
|
|
||||||
|
|
||||||
// Initialize
|
|
||||||
loadNavigation();
|
|
||||||
3352
public/js/faq.js
3352
public/js/faq.js
File diff suppressed because it is too large
Load diff
|
|
@ -1,225 +0,0 @@
|
||||||
/**
|
|
||||||
* Simple i18n system for Tractatus
|
|
||||||
* Supports: en (English), de (German), fr (French), mi (Te Reo Māori - coming soon)
|
|
||||||
*/
|
|
||||||
|
|
||||||
const I18n = {
|
|
||||||
currentLang: 'en',
|
|
||||||
translations: {},
|
|
||||||
supportedLanguages: ['en', 'de', 'fr'],
|
|
||||||
|
|
||||||
async init() {
|
|
||||||
// 1. Detect language preference
|
|
||||||
this.currentLang = this.detectLanguage();
|
|
||||||
|
|
||||||
// 2. Load translations
|
|
||||||
await this.loadTranslations(this.currentLang);
|
|
||||||
|
|
||||||
// 3. Apply to page
|
|
||||||
this.applyTranslations();
|
|
||||||
|
|
||||||
// 4. Update language selector if present
|
|
||||||
this.updateLanguageSelector();
|
|
||||||
|
|
||||||
console.log(`[i18n] Initialized with language: ${this.currentLang}`);
|
|
||||||
},
|
|
||||||
|
|
||||||
detectLanguage() {
|
|
||||||
// Priority order:
|
|
||||||
// 1. User's manual selection (localStorage) - allows override via flag clicks
|
|
||||||
// 2. Browser's language setting (automatic detection)
|
|
||||||
// 3. Default to English (fallback)
|
|
||||||
|
|
||||||
// 1. Check localStorage first (user override)
|
|
||||||
const saved = localStorage.getItem('tractatus-lang');
|
|
||||||
if (saved && this.supportedLanguages.includes(saved)) {
|
|
||||||
console.log(`[i18n] Language detected from user preference: ${saved}`);
|
|
||||||
return saved;
|
|
||||||
}
|
|
||||||
|
|
||||||
// 2. Check browser language (automatic detection)
|
|
||||||
const browserLang = (navigator.language || navigator.userLanguage).split('-')[0];
|
|
||||||
if (this.supportedLanguages.includes(browserLang)) {
|
|
||||||
console.log(`[i18n] Language detected from browser: ${browserLang} (from ${navigator.language})`);
|
|
||||||
return browserLang;
|
|
||||||
}
|
|
||||||
|
|
||||||
// 3. Default to English
|
|
||||||
console.log(`[i18n] Language defaulted to: en (browser language '${navigator.language}' not supported)`);
|
|
||||||
return 'en';
|
|
||||||
},
|
|
||||||
|
|
||||||
detectPageName() {
|
|
||||||
// Try to get page name from data attribute first
|
|
||||||
const pageAttr = document.documentElement.getAttribute('data-page');
|
|
||||||
if (pageAttr) {
|
|
||||||
return pageAttr;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Detect from URL path
|
|
||||||
const path = window.location.pathname;
|
|
||||||
|
|
||||||
// Map paths to translation file names
|
|
||||||
const pageMap = {
|
|
||||||
'/': 'homepage',
|
|
||||||
'/index.html': 'homepage',
|
|
||||||
'/researcher.html': 'researcher',
|
|
||||||
'/leader.html': 'leader',
|
|
||||||
'/implementer.html': 'implementer',
|
|
||||||
'/about.html': 'about',
|
|
||||||
'/about/values.html': 'values',
|
|
||||||
'/about/values': 'values',
|
|
||||||
'/faq.html': 'faq',
|
|
||||||
'/koha.html': 'koha',
|
|
||||||
'/koha/transparency.html': 'transparency',
|
|
||||||
'/koha/transparency': 'transparency',
|
|
||||||
'/privacy.html': 'privacy',
|
|
||||||
'/privacy': 'privacy'
|
|
||||||
};
|
|
||||||
|
|
||||||
return pageMap[path] || 'homepage';
|
|
||||||
},
|
|
||||||
|
|
||||||
async loadTranslations(lang) {
|
|
||||||
try {
|
|
||||||
// Always load common translations (footer, navbar, etc.)
|
|
||||||
const commonResponse = await fetch(`/locales/${lang}/common.json`);
|
|
||||||
let commonTranslations = {};
|
|
||||||
if (commonResponse.ok) {
|
|
||||||
commonTranslations = await commonResponse.json();
|
|
||||||
}
|
|
||||||
|
|
||||||
// Load page-specific translations
|
|
||||||
const pageName = this.detectPageName();
|
|
||||||
const pageResponse = await fetch(`/locales/${lang}/${pageName}.json`);
|
|
||||||
let pageTranslations = {};
|
|
||||||
if (pageResponse.ok) {
|
|
||||||
pageTranslations = await pageResponse.json();
|
|
||||||
} else if (pageName !== 'homepage') {
|
|
||||||
// If page-specific translations don't exist, that's okay for some pages
|
|
||||||
console.warn(`[i18n] No translations found for ${lang}/${pageName}, using common only`);
|
|
||||||
} else {
|
|
||||||
throw new Error(`Failed to load translations for ${lang}/${pageName}`);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Merge common and page-specific translations (page-specific takes precedence)
|
|
||||||
this.translations = { ...commonTranslations, ...pageTranslations };
|
|
||||||
console.log(`[i18n] Loaded translations: common + ${pageName}`);
|
|
||||||
} catch (error) {
|
|
||||||
console.error(`[i18n] Error loading translations:`, error);
|
|
||||||
// Fallback to English if loading fails
|
|
||||||
if (lang !== 'en') {
|
|
||||||
this.currentLang = 'en';
|
|
||||||
await this.loadTranslations('en');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
|
|
||||||
t(key) {
|
|
||||||
const keys = key.split('.');
|
|
||||||
let value = this.translations;
|
|
||||||
|
|
||||||
for (const k of keys) {
|
|
||||||
if (value && typeof value === 'object') {
|
|
||||||
value = value[k];
|
|
||||||
} else {
|
|
||||||
return key; // Return key if translation not found
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return value || key;
|
|
||||||
},
|
|
||||||
|
|
||||||
applyTranslations() {
|
|
||||||
// Find all elements with data-i18n attribute
|
|
||||||
// Using innerHTML to preserve formatting like <em>, <strong>, <a> tags in translations
|
|
||||||
document.querySelectorAll('[data-i18n]').forEach(el => {
|
|
||||||
const key = el.dataset.i18n;
|
|
||||||
const translation = this.t(key);
|
|
||||||
|
|
||||||
if (typeof translation === 'string') {
|
|
||||||
el.innerHTML = translation;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Handle data-i18n-html for HTML content (kept for backward compatibility)
|
|
||||||
document.querySelectorAll('[data-i18n-html]').forEach(el => {
|
|
||||||
const key = el.dataset.i18nHtml;
|
|
||||||
const translation = this.t(key);
|
|
||||||
|
|
||||||
if (typeof translation === 'string') {
|
|
||||||
el.innerHTML = translation;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Handle data-i18n-placeholder for input placeholders
|
|
||||||
document.querySelectorAll('[data-i18n-placeholder]').forEach(el => {
|
|
||||||
const key = el.dataset.i18nPlaceholder;
|
|
||||||
const translation = this.t(key);
|
|
||||||
|
|
||||||
if (typeof translation === 'string') {
|
|
||||||
el.placeholder = translation;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
},
|
|
||||||
|
|
||||||
async setLanguage(lang) {
|
|
||||||
if (!this.supportedLanguages.includes(lang)) {
|
|
||||||
console.error(`[i18n] Unsupported language: ${lang}`);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Save preference (overrides browser language detection)
|
|
||||||
localStorage.setItem('tractatus-lang', lang);
|
|
||||||
console.log(`[i18n] User manually selected language: ${lang} (saved to localStorage)`);
|
|
||||||
|
|
||||||
// Update current language
|
|
||||||
this.currentLang = lang;
|
|
||||||
|
|
||||||
// Reload translations
|
|
||||||
await this.loadTranslations(lang);
|
|
||||||
|
|
||||||
// Reapply to page
|
|
||||||
this.applyTranslations();
|
|
||||||
|
|
||||||
// Update selector
|
|
||||||
this.updateLanguageSelector();
|
|
||||||
|
|
||||||
// Update HTML lang attribute
|
|
||||||
document.documentElement.lang = lang;
|
|
||||||
|
|
||||||
// Dispatch event for language change
|
|
||||||
window.dispatchEvent(new CustomEvent('languageChanged', {
|
|
||||||
detail: { language: lang }
|
|
||||||
}));
|
|
||||||
|
|
||||||
console.log(`[i18n] Language changed to: ${lang} (will persist across pages)`);
|
|
||||||
},
|
|
||||||
|
|
||||||
updateLanguageSelector() {
|
|
||||||
const selector = document.getElementById('language-selector');
|
|
||||||
if (selector) {
|
|
||||||
selector.value = this.currentLang;
|
|
||||||
}
|
|
||||||
},
|
|
||||||
|
|
||||||
getLanguageName(code) {
|
|
||||||
const names = {
|
|
||||||
'en': 'English',
|
|
||||||
'de': 'Deutsch',
|
|
||||||
'fr': 'Français',
|
|
||||||
'mi': 'Te Reo Māori'
|
|
||||||
};
|
|
||||||
return names[code] || code;
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
// Auto-initialize when DOM is ready
|
|
||||||
if (document.readyState === 'loading') {
|
|
||||||
document.addEventListener('DOMContentLoaded', () => I18n.init());
|
|
||||||
} else {
|
|
||||||
I18n.init();
|
|
||||||
}
|
|
||||||
|
|
||||||
// Make available globally
|
|
||||||
window.I18n = I18n;
|
|
||||||
|
|
@ -1,415 +0,0 @@
|
||||||
/**
|
|
||||||
* Koha Donation System
|
|
||||||
* Handles donation form functionality with CSP compliance
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Form state
|
|
||||||
let selectedFrequency = 'monthly';
|
|
||||||
let selectedTier = '15';
|
|
||||||
let selectedAmount = 1500; // in cents (NZD)
|
|
||||||
let currentCurrency = typeof detectUserCurrency === 'function' ? detectUserCurrency() : 'NZD';
|
|
||||||
|
|
||||||
document.addEventListener('DOMContentLoaded', function() {
|
|
||||||
// Initialize event listeners
|
|
||||||
initializeFrequencyButtons();
|
|
||||||
initializeTierCards();
|
|
||||||
initializePublicAcknowledgement();
|
|
||||||
initializeDonationForm();
|
|
||||||
});
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Initialize frequency selection buttons
|
|
||||||
*/
|
|
||||||
function initializeFrequencyButtons() {
|
|
||||||
const monthlyBtn = document.getElementById('freq-monthly');
|
|
||||||
const onetimeBtn = document.getElementById('freq-onetime');
|
|
||||||
|
|
||||||
if (monthlyBtn) {
|
|
||||||
monthlyBtn.addEventListener('click', function() {
|
|
||||||
selectFrequency('monthly');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
if (onetimeBtn) {
|
|
||||||
onetimeBtn.addEventListener('click', function() {
|
|
||||||
selectFrequency('one_time');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Initialize tier card click handlers
|
|
||||||
*/
|
|
||||||
function initializeTierCards() {
|
|
||||||
const tierCards = document.querySelectorAll('[data-tier]');
|
|
||||||
|
|
||||||
tierCards.forEach(card => {
|
|
||||||
card.addEventListener('click', function() {
|
|
||||||
const tier = this.dataset.tier;
|
|
||||||
const amount = parseInt(this.dataset.amount);
|
|
||||||
selectTier(tier, amount);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Initialize public acknowledgement checkbox
|
|
||||||
*/
|
|
||||||
function initializePublicAcknowledgement() {
|
|
||||||
const checkbox = document.getElementById('public-acknowledgement');
|
|
||||||
|
|
||||||
if (checkbox) {
|
|
||||||
checkbox.addEventListener('change', togglePublicName);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Initialize donation form submission
|
|
||||||
*/
|
|
||||||
function initializeDonationForm() {
|
|
||||||
const form = document.getElementById('donation-form');
|
|
||||||
|
|
||||||
if (form) {
|
|
||||||
form.addEventListener('submit', handleFormSubmit);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update prices when currency changes
|
|
||||||
*/
|
|
||||||
window.updatePricesForCurrency = function(currency) {
|
|
||||||
currentCurrency = currency;
|
|
||||||
|
|
||||||
if (typeof getTierPrices !== 'function' || typeof formatCurrency !== 'function') {
|
|
||||||
console.warn('Currency utilities not loaded');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
const prices = getTierPrices(currency);
|
|
||||||
|
|
||||||
// Update tier card prices
|
|
||||||
const tierCards = document.querySelectorAll('.tier-card');
|
|
||||||
if (tierCards[0]) {
|
|
||||||
const priceEl = tierCards[0].querySelector('.text-4xl');
|
|
||||||
const currencyEl = tierCards[0].querySelector('.text-sm.text-gray-500');
|
|
||||||
if (priceEl) priceEl.textContent = formatCurrency(prices.tier_5, currency).replace(/\.\d+$/, '');
|
|
||||||
if (currencyEl) currencyEl.textContent = `${currency} / month`;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (tierCards[1]) {
|
|
||||||
const priceEl = tierCards[1].querySelector('.text-4xl');
|
|
||||||
const currencyEl = tierCards[1].querySelector('.text-sm.text-gray-500');
|
|
||||||
if (priceEl) priceEl.textContent = formatCurrency(prices.tier_15, currency).replace(/\.\d+$/, '');
|
|
||||||
if (currencyEl) currencyEl.textContent = `${currency} / month`;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (tierCards[2]) {
|
|
||||||
const priceEl = tierCards[2].querySelector('.text-4xl');
|
|
||||||
const currencyEl = tierCards[2].querySelector('.text-sm.text-gray-500');
|
|
||||||
if (priceEl) priceEl.textContent = formatCurrency(prices.tier_50, currency).replace(/\.\d+$/, '');
|
|
||||||
if (currencyEl) currencyEl.textContent = `${currency} / month`;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Update custom amount placeholder
|
|
||||||
const amountInput = document.getElementById('amount-input');
|
|
||||||
if (amountInput) {
|
|
||||||
amountInput.placeholder = 'Enter amount';
|
|
||||||
const amountCurrencyLabel = amountInput.nextElementSibling;
|
|
||||||
if (amountCurrencyLabel) {
|
|
||||||
amountCurrencyLabel.textContent = currency;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Update help text
|
|
||||||
const amountHelp = document.getElementById('amount-help');
|
|
||||||
if (amountHelp && typeof formatCurrency === 'function') {
|
|
||||||
amountHelp.textContent = `Minimum donation: ${formatCurrency(100, currency)}`;
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Select donation frequency (monthly or one-time)
|
|
||||||
*/
|
|
||||||
function selectFrequency(freq) {
|
|
||||||
selectedFrequency = freq;
|
|
||||||
|
|
||||||
// Update button styles
|
|
||||||
const monthlyBtn = document.getElementById('freq-monthly');
|
|
||||||
const onetimeBtn = document.getElementById('freq-onetime');
|
|
||||||
|
|
||||||
if (freq === 'monthly') {
|
|
||||||
monthlyBtn.className = 'flex-1 py-3 px-6 border-2 border-blue-600 bg-blue-600 text-white rounded-lg font-semibold hover:bg-blue-700 transition';
|
|
||||||
onetimeBtn.className = 'flex-1 py-3 px-6 border-2 border-gray-300 bg-white text-gray-700 rounded-lg font-semibold hover:border-blue-600 transition';
|
|
||||||
|
|
||||||
// Show tier selection, hide custom amount
|
|
||||||
const tierSelection = document.getElementById('tier-selection');
|
|
||||||
const customAmount = document.getElementById('custom-amount');
|
|
||||||
if (tierSelection) tierSelection.classList.remove('hidden');
|
|
||||||
if (customAmount) customAmount.classList.add('hidden');
|
|
||||||
} else {
|
|
||||||
monthlyBtn.className = 'flex-1 py-3 px-6 border-2 border-gray-300 bg-white text-gray-700 rounded-lg font-semibold hover:border-blue-600 transition';
|
|
||||||
onetimeBtn.className = 'flex-1 py-3 px-6 border-2 border-blue-600 bg-blue-600 text-white rounded-lg font-semibold hover:bg-blue-700 transition';
|
|
||||||
|
|
||||||
// Hide tier selection, show custom amount
|
|
||||||
const tierSelection = document.getElementById('tier-selection');
|
|
||||||
const customAmount = document.getElementById('custom-amount');
|
|
||||||
if (tierSelection) tierSelection.classList.add('hidden');
|
|
||||||
if (customAmount) customAmount.classList.remove('hidden');
|
|
||||||
|
|
||||||
const amountInput = document.getElementById('amount-input');
|
|
||||||
if (amountInput) amountInput.focus();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Select tier amount
|
|
||||||
*/
|
|
||||||
function selectTier(tier, amountNZDCents) {
|
|
||||||
selectedTier = tier;
|
|
||||||
|
|
||||||
// Calculate amount in current currency
|
|
||||||
if (typeof getTierPrices === 'function') {
|
|
||||||
const prices = getTierPrices(currentCurrency);
|
|
||||||
selectedAmount = prices[`tier_${tier}`];
|
|
||||||
} else {
|
|
||||||
selectedAmount = amountNZDCents;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Update card styles
|
|
||||||
const cards = document.querySelectorAll('.tier-card');
|
|
||||||
cards.forEach(card => {
|
|
||||||
card.classList.remove('selected');
|
|
||||||
});
|
|
||||||
|
|
||||||
// Add selected class to clicked card
|
|
||||||
const selectedCard = document.querySelector(`[data-tier="${tier}"]`);
|
|
||||||
if (selectedCard) {
|
|
||||||
selectedCard.classList.add('selected');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Toggle public name field visibility
|
|
||||||
*/
|
|
||||||
function togglePublicName() {
|
|
||||||
const checkbox = document.getElementById('public-acknowledgement');
|
|
||||||
const nameField = document.getElementById('public-name-field');
|
|
||||||
|
|
||||||
if (checkbox && nameField) {
|
|
||||||
if (checkbox.checked) {
|
|
||||||
nameField.classList.remove('hidden');
|
|
||||||
const publicNameInput = document.getElementById('public-name');
|
|
||||||
if (publicNameInput) publicNameInput.focus();
|
|
||||||
} else {
|
|
||||||
nameField.classList.add('hidden');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle form submission
|
|
||||||
*/
|
|
||||||
async function handleFormSubmit(e) {
|
|
||||||
e.preventDefault();
|
|
||||||
|
|
||||||
const submitBtn = e.target.querySelector('button[type="submit"]');
|
|
||||||
submitBtn.disabled = true;
|
|
||||||
submitBtn.textContent = 'Processing...';
|
|
||||||
|
|
||||||
try {
|
|
||||||
// Get form data
|
|
||||||
const donorName = document.getElementById('donor-name').value.trim() || 'Anonymous';
|
|
||||||
const donorEmail = document.getElementById('donor-email').value.trim();
|
|
||||||
const donorCountry = document.getElementById('donor-country').value.trim();
|
|
||||||
const publicAck = document.getElementById('public-acknowledgement').checked;
|
|
||||||
const publicName = document.getElementById('public-name').value.trim();
|
|
||||||
|
|
||||||
// Validate email
|
|
||||||
if (!donorEmail) {
|
|
||||||
alert('Please enter your email address.');
|
|
||||||
submitBtn.disabled = false;
|
|
||||||
submitBtn.textContent = 'Proceed to Secure Payment';
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Get amount
|
|
||||||
let amount;
|
|
||||||
if (selectedFrequency === 'monthly') {
|
|
||||||
amount = selectedAmount;
|
|
||||||
} else {
|
|
||||||
const customAmount = parseFloat(document.getElementById('amount-input').value);
|
|
||||||
if (!customAmount || customAmount < 1) {
|
|
||||||
const minAmount = typeof formatCurrency === 'function'
|
|
||||||
? formatCurrency(100, currentCurrency)
|
|
||||||
: `${currentCurrency} 1.00`;
|
|
||||||
alert(`Please enter a donation amount of at least ${minAmount}.`);
|
|
||||||
submitBtn.disabled = false;
|
|
||||||
submitBtn.textContent = 'Proceed to Secure Payment';
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
amount = Math.round(customAmount * 100); // Convert to cents
|
|
||||||
}
|
|
||||||
|
|
||||||
// Create checkout session
|
|
||||||
const response = await fetch('/api/koha/checkout', {
|
|
||||||
method: 'POST',
|
|
||||||
headers: {
|
|
||||||
'Content-Type': 'application/json'
|
|
||||||
},
|
|
||||||
body: JSON.stringify({
|
|
||||||
amount: amount,
|
|
||||||
currency: currentCurrency,
|
|
||||||
frequency: selectedFrequency,
|
|
||||||
tier: selectedFrequency === 'monthly' ? selectedTier : 'custom',
|
|
||||||
donor: {
|
|
||||||
name: donorName,
|
|
||||||
email: donorEmail,
|
|
||||||
country: donorCountry
|
|
||||||
},
|
|
||||||
public_acknowledgement: publicAck,
|
|
||||||
public_name: publicAck ? (publicName || donorName) : null
|
|
||||||
})
|
|
||||||
});
|
|
||||||
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (data.success && data.data.checkoutUrl) {
|
|
||||||
// Redirect to Stripe Checkout
|
|
||||||
window.location.href = data.data.checkoutUrl;
|
|
||||||
} else {
|
|
||||||
throw new Error(data.error || 'Failed to create checkout session');
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Donation error:', error);
|
|
||||||
alert('An error occurred while processing your donation. Please try again or contact support.');
|
|
||||||
submitBtn.disabled = false;
|
|
||||||
submitBtn.textContent = 'Proceed to Secure Payment';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Initialize manage subscription functionality
|
|
||||||
*/
|
|
||||||
document.addEventListener('DOMContentLoaded', function() {
|
|
||||||
const manageBtn = document.getElementById('manage-subscription-btn');
|
|
||||||
const emailInput = document.getElementById('manage-email');
|
|
||||||
|
|
||||||
if (manageBtn && emailInput) {
|
|
||||||
manageBtn.addEventListener('click', handleManageSubscription);
|
|
||||||
emailInput.addEventListener('keypress', function(e) {
|
|
||||||
if (e.key === 'Enter') {
|
|
||||||
e.preventDefault();
|
|
||||||
handleManageSubscription();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle manage subscription button click
|
|
||||||
*/
|
|
||||||
async function handleManageSubscription() {
|
|
||||||
const emailInput = document.getElementById('manage-email');
|
|
||||||
const manageBtn = document.getElementById('manage-subscription-btn');
|
|
||||||
const errorDiv = document.getElementById('manage-error');
|
|
||||||
const loadingDiv = document.getElementById('manage-loading');
|
|
||||||
|
|
||||||
const email = emailInput.value.trim();
|
|
||||||
|
|
||||||
// Validate email
|
|
||||||
if (!email) {
|
|
||||||
showManageError('Please enter your email address.');
|
|
||||||
emailInput.focus();
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!isValidEmail(email)) {
|
|
||||||
showManageError('Please enter a valid email address.');
|
|
||||||
emailInput.focus();
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Hide error, show loading
|
|
||||||
hideManageError();
|
|
||||||
showManageLoading();
|
|
||||||
manageBtn.disabled = true;
|
|
||||||
|
|
||||||
try {
|
|
||||||
const response = await fetch('/api/koha/portal', {
|
|
||||||
method: 'POST',
|
|
||||||
headers: {
|
|
||||||
'Content-Type': 'application/json'
|
|
||||||
},
|
|
||||||
body: JSON.stringify({ email })
|
|
||||||
});
|
|
||||||
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (data.success && data.data.url) {
|
|
||||||
// Redirect to Stripe Customer Portal
|
|
||||||
window.location.href = data.data.url;
|
|
||||||
} else if (response.status === 404) {
|
|
||||||
showManageError('No subscription found for this email address. Please check your email and try again.');
|
|
||||||
manageBtn.disabled = false;
|
|
||||||
hideManageLoading();
|
|
||||||
} else {
|
|
||||||
throw new Error(data.error || 'Failed to access subscription portal');
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Manage subscription error:', error);
|
|
||||||
showManageError('An error occurred. Please try again or contact support@agenticgovernance.digital');
|
|
||||||
manageBtn.disabled = false;
|
|
||||||
hideManageLoading();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Validate email format
|
|
||||||
*/
|
|
||||||
function isValidEmail(email) {
|
|
||||||
const re = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
|
|
||||||
return re.test(email);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Show error message
|
|
||||||
*/
|
|
||||||
function showManageError(message) {
|
|
||||||
const errorDiv = document.getElementById('manage-error');
|
|
||||||
if (errorDiv) {
|
|
||||||
errorDiv.textContent = message;
|
|
||||||
errorDiv.classList.remove('hidden');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Hide error message
|
|
||||||
*/
|
|
||||||
function hideManageError() {
|
|
||||||
const errorDiv = document.getElementById('manage-error');
|
|
||||||
if (errorDiv) {
|
|
||||||
errorDiv.classList.add('hidden');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Show loading indicator
|
|
||||||
*/
|
|
||||||
function showManageLoading() {
|
|
||||||
const loadingDiv = document.getElementById('manage-loading');
|
|
||||||
if (loadingDiv) {
|
|
||||||
loadingDiv.classList.remove('hidden');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Hide loading indicator
|
|
||||||
*/
|
|
||||||
function hideManageLoading() {
|
|
||||||
const loadingDiv = document.getElementById('manage-loading');
|
|
||||||
if (loadingDiv) {
|
|
||||||
loadingDiv.classList.add('hidden');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
@ -1,54 +0,0 @@
|
||||||
/**
|
|
||||||
* Koha Success Page - Donation Verification
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Get session ID from URL
|
|
||||||
const urlParams = new URLSearchParams(window.location.search);
|
|
||||||
const sessionId = urlParams.get('session_id');
|
|
||||||
|
|
||||||
// Verify donation
|
|
||||||
async function verifyDonation() {
|
|
||||||
if (!sessionId) {
|
|
||||||
// No session ID - just show success message
|
|
||||||
document.getElementById('loading-content').classList.add('hidden');
|
|
||||||
document.getElementById('success-content').classList.remove('hidden');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
try {
|
|
||||||
const response = await fetch(`/api/koha/verify/${sessionId}`);
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (data.success && data.data.isSuccessful) {
|
|
||||||
// Show success content
|
|
||||||
document.getElementById('loading-content').classList.add('hidden');
|
|
||||||
document.getElementById('success-content').classList.remove('hidden');
|
|
||||||
|
|
||||||
// Update details
|
|
||||||
document.getElementById('amount').textContent = `$${data.data.amount.toFixed(2)} ${data.data.currency.toUpperCase()}`;
|
|
||||||
|
|
||||||
const frequencyText = data.data.frequency === 'monthly' ? 'Monthly Donation' : 'One-Time Donation';
|
|
||||||
document.getElementById('frequency').textContent = frequencyText;
|
|
||||||
|
|
||||||
// Show monthly section if applicable
|
|
||||||
if (data.data.frequency === 'monthly') {
|
|
||||||
document.getElementById('monthly-section').classList.remove('hidden');
|
|
||||||
}
|
|
||||||
|
|
||||||
} else {
|
|
||||||
throw new Error('Donation not successful');
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Verification error:', error);
|
|
||||||
document.getElementById('loading-content').classList.add('hidden');
|
|
||||||
document.getElementById('error-content').classList.remove('hidden');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Verify on page load
|
|
||||||
if (sessionId) {
|
|
||||||
document.getElementById('success-content').classList.add('hidden');
|
|
||||||
document.getElementById('loading-content').classList.remove('hidden');
|
|
||||||
verifyDonation();
|
|
||||||
}
|
|
||||||
|
|
@ -1,280 +0,0 @@
|
||||||
/**
|
|
||||||
* Koha Transparency Dashboard
|
|
||||||
* Real-time donation metrics with privacy-preserving analytics
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Chart instances (global for updates)
|
|
||||||
let allocationChart = null;
|
|
||||||
let trendChart = null;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Load and display transparency metrics
|
|
||||||
*/
|
|
||||||
async function loadMetrics() {
|
|
||||||
try {
|
|
||||||
const response = await fetch('/api/koha/transparency');
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (data.success && data.data) {
|
|
||||||
const metrics = data.data;
|
|
||||||
|
|
||||||
// Update stats
|
|
||||||
updateStats(metrics);
|
|
||||||
|
|
||||||
// Update allocation chart
|
|
||||||
updateAllocationChart(metrics);
|
|
||||||
|
|
||||||
// Update progress bars (legacy display)
|
|
||||||
animateProgressBars();
|
|
||||||
|
|
||||||
// Display recent donors
|
|
||||||
displayRecentDonors(metrics.recent_donors || []);
|
|
||||||
|
|
||||||
// Update last updated time
|
|
||||||
updateLastUpdated(metrics.last_updated);
|
|
||||||
|
|
||||||
} else {
|
|
||||||
throw new Error('Failed to load metrics');
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error loading transparency metrics:', error);
|
|
||||||
document.getElementById('recent-donors').innerHTML = `
|
|
||||||
<div class="text-center py-8 text-red-600">
|
|
||||||
Failed to load transparency data. Please try again later.
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update stats display
|
|
||||||
*/
|
|
||||||
function updateStats(metrics) {
|
|
||||||
document.getElementById('total-received').textContent = `$${metrics.total_received.toFixed(2)}`;
|
|
||||||
document.getElementById('monthly-supporters').textContent = metrics.monthly_supporters;
|
|
||||||
document.getElementById('monthly-revenue').textContent = `$${metrics.monthly_recurring_revenue.toFixed(2)}`;
|
|
||||||
document.getElementById('onetime-count').textContent = metrics.one_time_donations || 0;
|
|
||||||
|
|
||||||
// Calculate average
|
|
||||||
const totalCount = metrics.monthly_supporters + (metrics.one_time_donations || 0);
|
|
||||||
const avgDonation = totalCount > 0 ? metrics.total_received / totalCount : 0;
|
|
||||||
document.getElementById('average-donation').textContent = `$${avgDonation.toFixed(2)}`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update allocation pie chart
|
|
||||||
*/
|
|
||||||
function updateAllocationChart(metrics) {
|
|
||||||
const ctx = document.getElementById('allocation-chart');
|
|
||||||
if (!ctx) return;
|
|
||||||
|
|
||||||
const allocation = metrics.allocation || {
|
|
||||||
development: 0.4,
|
|
||||||
hosting: 0.3,
|
|
||||||
research: 0.2,
|
|
||||||
community: 0.1
|
|
||||||
};
|
|
||||||
|
|
||||||
const data = {
|
|
||||||
labels: ['Development (40%)', 'Hosting & Infrastructure (30%)', 'Research (20%)', 'Community (10%)'],
|
|
||||||
datasets: [{
|
|
||||||
data: [
|
|
||||||
allocation.development * 100,
|
|
||||||
allocation.hosting * 100,
|
|
||||||
allocation.research * 100,
|
|
||||||
allocation.community * 100
|
|
||||||
],
|
|
||||||
backgroundColor: [
|
|
||||||
'#3B82F6', // blue-600
|
|
||||||
'#10B981', // green-600
|
|
||||||
'#A855F7', // purple-600
|
|
||||||
'#F59E0B' // orange-600
|
|
||||||
],
|
|
||||||
borderWidth: 2,
|
|
||||||
borderColor: '#FFFFFF'
|
|
||||||
}]
|
|
||||||
};
|
|
||||||
|
|
||||||
const config = {
|
|
||||||
type: 'doughnut',
|
|
||||||
data: data,
|
|
||||||
options: {
|
|
||||||
responsive: true,
|
|
||||||
maintainAspectRatio: true,
|
|
||||||
plugins: {
|
|
||||||
legend: {
|
|
||||||
position: 'bottom',
|
|
||||||
labels: {
|
|
||||||
padding: 15,
|
|
||||||
font: {
|
|
||||||
size: 12
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
tooltip: {
|
|
||||||
callbacks: {
|
|
||||||
label: function(context) {
|
|
||||||
const label = context.label || '';
|
|
||||||
const value = context.parsed;
|
|
||||||
return `${label}: ${value.toFixed(1)}%`;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
if (allocationChart) {
|
|
||||||
allocationChart.data = data;
|
|
||||||
allocationChart.update();
|
|
||||||
} else {
|
|
||||||
allocationChart = new Chart(ctx, config);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Animate progress bars (legacy display)
|
|
||||||
*/
|
|
||||||
function animateProgressBars() {
|
|
||||||
setTimeout(() => {
|
|
||||||
document.querySelectorAll('.progress-bar').forEach(bar => {
|
|
||||||
const width = bar.getAttribute('data-width');
|
|
||||||
bar.style.width = width + '%';
|
|
||||||
});
|
|
||||||
}, 100);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Display recent donors
|
|
||||||
*/
|
|
||||||
function displayRecentDonors(donors) {
|
|
||||||
const donorsContainer = document.getElementById('recent-donors');
|
|
||||||
const noDonorsMessage = document.getElementById('no-donors');
|
|
||||||
|
|
||||||
if (donors.length > 0) {
|
|
||||||
const donorsHtml = donors.map(donor => {
|
|
||||||
const date = new Date(donor.date);
|
|
||||||
const dateStr = date.toLocaleDateString('en-NZ', { year: 'numeric', month: 'short' });
|
|
||||||
const freqBadge = donor.frequency === 'monthly'
|
|
||||||
? '<span class="inline-block bg-blue-100 text-blue-800 text-xs px-2 py-1 rounded">Monthly</span>'
|
|
||||||
: '<span class="inline-block bg-green-100 text-green-800 text-xs px-2 py-1 rounded">One-time</span>';
|
|
||||||
|
|
||||||
// Format currency display
|
|
||||||
const currency = (donor.currency || 'nzd').toUpperCase();
|
|
||||||
const amountDisplay = `$${donor.amount.toFixed(2)} ${currency}`;
|
|
||||||
|
|
||||||
// Show NZD equivalent if different currency
|
|
||||||
const nzdEquivalent = currency !== 'NZD'
|
|
||||||
? `<div class="text-xs text-gray-500">≈ $${donor.amount_nzd.toFixed(2)} NZD</div>`
|
|
||||||
: '';
|
|
||||||
|
|
||||||
return `
|
|
||||||
<div class="flex items-center justify-between py-3 border-b border-gray-200 last:border-0">
|
|
||||||
<div class="flex items-center gap-3">
|
|
||||||
<div class="w-10 h-10 bg-blue-100 rounded-full flex items-center justify-center">
|
|
||||||
<span class="text-blue-600 font-semibold">${donor.name.charAt(0).toUpperCase()}</span>
|
|
||||||
</div>
|
|
||||||
<div>
|
|
||||||
<div class="font-medium text-gray-900">${donor.name}</div>
|
|
||||||
<div class="text-sm text-gray-500">${dateStr}</div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="text-right">
|
|
||||||
<div class="font-semibold text-gray-900">${amountDisplay}</div>
|
|
||||||
${nzdEquivalent}
|
|
||||||
${freqBadge}
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}).join('');
|
|
||||||
|
|
||||||
donorsContainer.innerHTML = donorsHtml;
|
|
||||||
donorsContainer.style.display = 'block';
|
|
||||||
if (noDonorsMessage) noDonorsMessage.style.display = 'none';
|
|
||||||
} else {
|
|
||||||
donorsContainer.style.display = 'none';
|
|
||||||
if (noDonorsMessage) noDonorsMessage.style.display = 'block';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update last updated timestamp
|
|
||||||
*/
|
|
||||||
function updateLastUpdated(timestamp) {
|
|
||||||
const lastUpdated = new Date(timestamp);
|
|
||||||
const elem = document.getElementById('last-updated');
|
|
||||||
if (elem) {
|
|
||||||
elem.textContent = `Last updated: ${lastUpdated.toLocaleString()}`;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Export transparency data as CSV
|
|
||||||
*/
|
|
||||||
async function exportCSV() {
|
|
||||||
try {
|
|
||||||
const response = await fetch('/api/koha/transparency');
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (!data.success || !data.data) {
|
|
||||||
throw new Error('Failed to load metrics for export');
|
|
||||||
}
|
|
||||||
|
|
||||||
const metrics = data.data;
|
|
||||||
|
|
||||||
// Build CSV content
|
|
||||||
let csv = 'Tractatus Koha Transparency Report\\n';
|
|
||||||
csv += `Generated: ${new Date().toISOString()}\\n\\n`;
|
|
||||||
|
|
||||||
csv += 'Metric,Value\\n';
|
|
||||||
csv += `Total Received,${metrics.total_received}\\n`;
|
|
||||||
csv += `Monthly Supporters,${metrics.monthly_supporters}\\n`;
|
|
||||||
csv += `One-Time Donations,${metrics.one_time_donations || 0}\\n`;
|
|
||||||
csv += `Monthly Recurring Revenue,${metrics.monthly_recurring_revenue}\\n\\n`;
|
|
||||||
|
|
||||||
csv += 'Allocation Category,Percentage\\n';
|
|
||||||
csv += `Development,${(metrics.allocation.development * 100).toFixed(1)}%\\n`;
|
|
||||||
csv += `Hosting & Infrastructure,${(metrics.allocation.hosting * 100).toFixed(1)}%\\n`;
|
|
||||||
csv += `Research,${(metrics.allocation.research * 100).toFixed(1)}%\\n`;
|
|
||||||
csv += `Community,${(metrics.allocation.community * 100).toFixed(1)}%\\n\\n`;
|
|
||||||
|
|
||||||
if (metrics.recent_donors && metrics.recent_donors.length > 0) {
|
|
||||||
csv += 'Recent Public Supporters\\n';
|
|
||||||
csv += 'Name,Date,Amount,Currency,Frequency\\n';
|
|
||||||
metrics.recent_donors.forEach(donor => {
|
|
||||||
csv += `"${donor.name}",${donor.date},${donor.amount},${donor.currency || 'NZD'},${donor.frequency}\\n`;
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Create download
|
|
||||||
const blob = new Blob([csv], { type: 'text/csv' });
|
|
||||||
const url = window.URL.createObjectURL(blob);
|
|
||||||
const a = document.createElement('a');
|
|
||||||
a.href = url;
|
|
||||||
a.download = `tractatus-transparency-${new Date().toISOString().split('T')[0]}.csv`;
|
|
||||||
document.body.appendChild(a);
|
|
||||||
a.click();
|
|
||||||
document.body.removeChild(a);
|
|
||||||
window.URL.revokeObjectURL(url);
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error exporting CSV:', error);
|
|
||||||
alert('Failed to export transparency data. Please try again.');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Initialize on page load
|
|
||||||
document.addEventListener('DOMContentLoaded', () => {
|
|
||||||
// Load metrics
|
|
||||||
loadMetrics();
|
|
||||||
|
|
||||||
// Refresh every 5 minutes
|
|
||||||
setInterval(loadMetrics, 5 * 60 * 1000);
|
|
||||||
|
|
||||||
// Setup CSV export button
|
|
||||||
const exportBtn = document.getElementById('export-csv');
|
|
||||||
if (exportBtn) {
|
|
||||||
exportBtn.addEventListener('click', exportCSV);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
@ -1,30 +0,0 @@
|
||||||
/**
|
|
||||||
* Leader Page - Accordion Functionality
|
|
||||||
* Handles expandable/collapsible sections for leadership content
|
|
||||||
*/
|
|
||||||
|
|
||||||
document.addEventListener('DOMContentLoaded', function() {
|
|
||||||
// Get all accordion buttons
|
|
||||||
const accordionButtons = document.querySelectorAll('[data-accordion]');
|
|
||||||
|
|
||||||
accordionButtons.forEach(button => {
|
|
||||||
button.addEventListener('click', function() {
|
|
||||||
const accordionId = this.dataset.accordion;
|
|
||||||
toggleAccordion(accordionId);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Toggle accordion section open/closed
|
|
||||||
* @param {string} id - Accordion section ID
|
|
||||||
*/
|
|
||||||
function toggleAccordion(id) {
|
|
||||||
const content = document.getElementById(id + '-content');
|
|
||||||
const icon = document.getElementById(id + '-icon');
|
|
||||||
|
|
||||||
if (content && icon) {
|
|
||||||
content.classList.toggle('active');
|
|
||||||
icon.classList.toggle('active');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
@ -1,71 +0,0 @@
|
||||||
/**
|
|
||||||
* Media Inquiry Form Handler
|
|
||||||
*/
|
|
||||||
|
|
||||||
const form = document.getElementById('media-inquiry-form');
|
|
||||||
const submitButton = document.getElementById('submit-button');
|
|
||||||
const successMessage = document.getElementById('success-message');
|
|
||||||
const errorMessage = document.getElementById('error-message');
|
|
||||||
|
|
||||||
form.addEventListener('submit', async (e) => {
|
|
||||||
e.preventDefault();
|
|
||||||
|
|
||||||
// Hide previous messages
|
|
||||||
successMessage.style.display = 'none';
|
|
||||||
errorMessage.style.display = 'none';
|
|
||||||
|
|
||||||
// Disable submit button
|
|
||||||
submitButton.disabled = true;
|
|
||||||
submitButton.textContent = 'Submitting...';
|
|
||||||
|
|
||||||
// Collect form data
|
|
||||||
const formData = {
|
|
||||||
contact: {
|
|
||||||
name: document.getElementById('contact-name').value,
|
|
||||||
email: document.getElementById('contact-email').value,
|
|
||||||
outlet: document.getElementById('contact-outlet').value,
|
|
||||||
phone: document.getElementById('contact-phone').value || null
|
|
||||||
},
|
|
||||||
inquiry: {
|
|
||||||
subject: document.getElementById('inquiry-subject').value,
|
|
||||||
message: document.getElementById('inquiry-message').value,
|
|
||||||
deadline: document.getElementById('inquiry-deadline').value || null,
|
|
||||||
topic_areas: []
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
try {
|
|
||||||
const response = await fetch('/api/media/inquiries', {
|
|
||||||
method: 'POST',
|
|
||||||
headers: {
|
|
||||||
'Content-Type': 'application/json'
|
|
||||||
},
|
|
||||||
body: JSON.stringify(formData)
|
|
||||||
});
|
|
||||||
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (response.ok) {
|
|
||||||
// Success
|
|
||||||
successMessage.textContent = data.message || 'Thank you for your inquiry. We will review and respond shortly.';
|
|
||||||
successMessage.style.display = 'block';
|
|
||||||
form.reset();
|
|
||||||
window.scrollTo({ top: 0, behavior: 'smooth' });
|
|
||||||
} else {
|
|
||||||
// Error
|
|
||||||
errorMessage.textContent = data.message || 'An error occurred. Please try again.';
|
|
||||||
errorMessage.style.display = 'block';
|
|
||||||
window.scrollTo({ top: 0, behavior: 'smooth' });
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Submit error:', error);
|
|
||||||
errorMessage.textContent = 'Network error. Please check your connection and try again.';
|
|
||||||
errorMessage.style.display = 'block';
|
|
||||||
window.scrollTo({ top: 0, behavior: 'smooth' });
|
|
||||||
} finally {
|
|
||||||
// Re-enable submit button
|
|
||||||
submitButton.disabled = false;
|
|
||||||
submitButton.textContent = 'Submit Inquiry';
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
@ -1,82 +0,0 @@
|
||||||
/**
|
|
||||||
* Media Triage Transparency - Public Statistics Display
|
|
||||||
* Demonstrates AI governance in practice with measurable transparency
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Fetch and display triage statistics
|
|
||||||
async function loadTriageStats() {
|
|
||||||
const loadingState = document.getElementById('loading-state');
|
|
||||||
const statsContent = document.getElementById('stats-content');
|
|
||||||
|
|
||||||
try {
|
|
||||||
const response = await fetch('/api/media/triage-stats');
|
|
||||||
const data = await response.json();
|
|
||||||
|
|
||||||
if (!data.success) {
|
|
||||||
throw new Error('Failed to load statistics');
|
|
||||||
}
|
|
||||||
|
|
||||||
const stats = data.statistics;
|
|
||||||
|
|
||||||
// Hide loading, show content
|
|
||||||
loadingState.classList.add('hidden');
|
|
||||||
statsContent.classList.remove('hidden');
|
|
||||||
|
|
||||||
// Update key metrics
|
|
||||||
document.getElementById('stat-total').textContent = stats.total_triaged || 0;
|
|
||||||
document.getElementById('stat-values').textContent = stats.involves_values_count || 0;
|
|
||||||
|
|
||||||
// Update urgency distribution
|
|
||||||
const totalUrgency = stats.by_urgency.high + stats.by_urgency.medium + stats.by_urgency.low || 1;
|
|
||||||
|
|
||||||
const highPct = Math.round((stats.by_urgency.high / totalUrgency) * 100);
|
|
||||||
const mediumPct = Math.round((stats.by_urgency.medium / totalUrgency) * 100);
|
|
||||||
const lowPct = Math.round((stats.by_urgency.low / totalUrgency) * 100);
|
|
||||||
|
|
||||||
document.getElementById('urgency-high-count').textContent = `${stats.by_urgency.high} inquiries (${highPct}%)`;
|
|
||||||
document.getElementById('urgency-high-bar').style.width = `${highPct}%`;
|
|
||||||
|
|
||||||
document.getElementById('urgency-medium-count').textContent = `${stats.by_urgency.medium} inquiries (${mediumPct}%)`;
|
|
||||||
document.getElementById('urgency-medium-bar').style.width = `${mediumPct}%`;
|
|
||||||
|
|
||||||
document.getElementById('urgency-low-count').textContent = `${stats.by_urgency.low} inquiries (${lowPct}%)`;
|
|
||||||
document.getElementById('urgency-low-bar').style.width = `${lowPct}%`;
|
|
||||||
|
|
||||||
// Update sensitivity distribution
|
|
||||||
const totalSensitivity = stats.by_sensitivity.high + stats.by_sensitivity.medium + stats.by_sensitivity.low || 1;
|
|
||||||
|
|
||||||
const sensHighPct = Math.round((stats.by_sensitivity.high / totalSensitivity) * 100);
|
|
||||||
const sensMediumPct = Math.round((stats.by_sensitivity.medium / totalSensitivity) * 100);
|
|
||||||
const sensLowPct = Math.round((stats.by_sensitivity.low / totalSensitivity) * 100);
|
|
||||||
|
|
||||||
document.getElementById('sensitivity-high-count').textContent = `${stats.by_sensitivity.high} inquiries (${sensHighPct}%)`;
|
|
||||||
document.getElementById('sensitivity-high-bar').style.width = `${sensHighPct}%`;
|
|
||||||
|
|
||||||
document.getElementById('sensitivity-medium-count').textContent = `${stats.by_sensitivity.medium} inquiries (${sensMediumPct}%)`;
|
|
||||||
document.getElementById('sensitivity-medium-bar').style.width = `${sensMediumPct}%`;
|
|
||||||
|
|
||||||
document.getElementById('sensitivity-low-count').textContent = `${stats.by_sensitivity.low} inquiries (${sensLowPct}%)`;
|
|
||||||
document.getElementById('sensitivity-low-bar').style.width = `${sensLowPct}%`;
|
|
||||||
|
|
||||||
// Update framework compliance metrics
|
|
||||||
document.getElementById('boundary-enforcements').textContent = stats.boundary_enforcements || 0;
|
|
||||||
document.getElementById('avg-response-time').textContent = stats.avg_response_time_hours || 0;
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Failed to load triage statistics:', error);
|
|
||||||
|
|
||||||
// Show error message
|
|
||||||
loadingState.innerHTML = `
|
|
||||||
<div class="bg-red-50 border border-red-200 rounded-lg p-6 text-center">
|
|
||||||
<svg class="mx-auto h-12 w-12 text-red-400 mb-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
|
|
||||||
</svg>
|
|
||||||
<p class="text-red-800 font-medium mb-2">Failed to load statistics</p>
|
|
||||||
<p class="text-sm text-red-600">Please try again later or contact support if the problem persists.</p>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Load stats on page load
|
|
||||||
loadTriageStats();
|
|
||||||
|
|
@ -1,78 +0,0 @@
|
||||||
/**
|
|
||||||
* Page Transitions
|
|
||||||
* Tractatus Framework - Phase 3: Page Transitions
|
|
||||||
*
|
|
||||||
* Provides smooth fade transitions between pages for better UX
|
|
||||||
*/
|
|
||||||
|
|
||||||
class PageTransitions {
|
|
||||||
constructor() {
|
|
||||||
this.transitionDuration = 300; // milliseconds
|
|
||||||
this.init();
|
|
||||||
}
|
|
||||||
|
|
||||||
init() {
|
|
||||||
// Add fade-in class to body on page load
|
|
||||||
document.body.classList.add('page-fade-in');
|
|
||||||
|
|
||||||
// Attach click handlers to internal links
|
|
||||||
this.attachLinkHandlers();
|
|
||||||
|
|
||||||
console.log('[PageTransitions] Initialized');
|
|
||||||
}
|
|
||||||
|
|
||||||
attachLinkHandlers() {
|
|
||||||
// Get all internal links (href starts with / or is relative)
|
|
||||||
const links = document.querySelectorAll('a[href^="/"], a[href^="./"], a[href^="../"]');
|
|
||||||
|
|
||||||
links.forEach(link => {
|
|
||||||
// Skip if link has target="_blank" or download attribute
|
|
||||||
if (link.getAttribute('target') === '_blank' || link.hasAttribute('download')) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
link.addEventListener('click', (e) => {
|
|
||||||
// Allow Ctrl/Cmd+click to open in new tab
|
|
||||||
if (e.ctrlKey || e.metaKey || e.shiftKey) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Skip if link has hash (same-page navigation)
|
|
||||||
const href = link.getAttribute('href');
|
|
||||||
if (href && href.startsWith('#')) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
e.preventDefault();
|
|
||||||
this.transitionToPage(link.href);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
console.log(`[PageTransitions] Attached handlers to ${links.length} links`);
|
|
||||||
}
|
|
||||||
|
|
||||||
transitionToPage(url) {
|
|
||||||
// Remove fade-in, add fade-out
|
|
||||||
document.body.classList.remove('page-fade-in');
|
|
||||||
document.body.classList.add('page-fade-out');
|
|
||||||
|
|
||||||
// Navigate after fade-out completes
|
|
||||||
setTimeout(() => {
|
|
||||||
window.location.href = url;
|
|
||||||
}, this.transitionDuration);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Initialize on DOM ready
|
|
||||||
if (document.readyState === 'loading') {
|
|
||||||
document.addEventListener('DOMContentLoaded', () => {
|
|
||||||
new PageTransitions();
|
|
||||||
});
|
|
||||||
} else {
|
|
||||||
new PageTransitions();
|
|
||||||
}
|
|
||||||
|
|
||||||
// Export for module systems
|
|
||||||
if (typeof module !== 'undefined' && module.exports) {
|
|
||||||
module.exports = PageTransitions;
|
|
||||||
}
|
|
||||||
|
|
@ -1,30 +0,0 @@
|
||||||
/**
|
|
||||||
* Researcher Page - Accordion Functionality
|
|
||||||
* Handles expandable/collapsible sections for research content
|
|
||||||
*/
|
|
||||||
|
|
||||||
document.addEventListener('DOMContentLoaded', function() {
|
|
||||||
// Get all accordion buttons
|
|
||||||
const accordionButtons = document.querySelectorAll('[data-accordion]');
|
|
||||||
|
|
||||||
accordionButtons.forEach(button => {
|
|
||||||
button.addEventListener('click', function() {
|
|
||||||
const accordionId = this.dataset.accordion;
|
|
||||||
toggleAccordion(accordionId);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Toggle accordion section open/closed
|
|
||||||
* @param {string} id - Accordion section ID
|
|
||||||
*/
|
|
||||||
function toggleAccordion(id) {
|
|
||||||
const content = document.getElementById(id + '-content');
|
|
||||||
const icon = document.getElementById(id + '-icon');
|
|
||||||
|
|
||||||
if (content && icon) {
|
|
||||||
content.classList.toggle('active');
|
|
||||||
icon.classList.toggle('active');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
@ -1,135 +0,0 @@
|
||||||
/**
|
|
||||||
* Scroll Animations using Intersection Observer
|
|
||||||
* Tractatus Framework - Phase 3: Engagement & Interactive Features
|
|
||||||
*
|
|
||||||
* Provides smooth scroll-triggered animations for elements marked with .animate-on-scroll
|
|
||||||
* Supports multiple animation types via data-animation attribute
|
|
||||||
*/
|
|
||||||
|
|
||||||
class ScrollAnimations {
|
|
||||||
constructor(options = {}) {
|
|
||||||
this.observerOptions = {
|
|
||||||
threshold: options.threshold || 0.1,
|
|
||||||
rootMargin: options.rootMargin || '0px 0px -100px 0px'
|
|
||||||
};
|
|
||||||
|
|
||||||
this.animations = {
|
|
||||||
'fade-in': 'opacity-0 animate-fade-in',
|
|
||||||
'slide-up': 'opacity-0 translate-y-8 animate-slide-up',
|
|
||||||
'slide-down': 'opacity-0 -translate-y-8 animate-slide-down',
|
|
||||||
'slide-left': 'opacity-0 translate-x-8 animate-slide-left',
|
|
||||||
'slide-right': 'opacity-0 -translate-x-8 animate-slide-right',
|
|
||||||
'scale-in': 'opacity-0 scale-95 animate-scale-in',
|
|
||||||
'rotate-in': 'opacity-0 rotate-12 animate-rotate-in'
|
|
||||||
};
|
|
||||||
|
|
||||||
this.init();
|
|
||||||
}
|
|
||||||
|
|
||||||
init() {
|
|
||||||
// Wait for DOM to be ready
|
|
||||||
if (document.readyState === 'loading') {
|
|
||||||
document.addEventListener('DOMContentLoaded', () => this.observe());
|
|
||||||
} else {
|
|
||||||
this.observe();
|
|
||||||
}
|
|
||||||
|
|
||||||
console.log('[ScrollAnimations] Initialized');
|
|
||||||
}
|
|
||||||
|
|
||||||
observe() {
|
|
||||||
const observer = new IntersectionObserver((entries) => {
|
|
||||||
entries.forEach(entry => {
|
|
||||||
if (entry.isIntersecting) {
|
|
||||||
this.animateElement(entry.target);
|
|
||||||
|
|
||||||
// Optional: unobserve after animation to improve performance
|
|
||||||
// Only do this for elements without data-animate-repeat attribute
|
|
||||||
if (!entry.target.hasAttribute('data-animate-repeat')) {
|
|
||||||
observer.unobserve(entry.target);
|
|
||||||
}
|
|
||||||
} else if (entry.target.hasAttribute('data-animate-repeat')) {
|
|
||||||
// Reset animation for repeatable elements
|
|
||||||
this.resetElement(entry.target);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}, this.observerOptions);
|
|
||||||
|
|
||||||
// Find all elements with .animate-on-scroll class
|
|
||||||
const elements = document.querySelectorAll('.animate-on-scroll');
|
|
||||||
console.log(`[ScrollAnimations] Observing ${elements.length} elements`);
|
|
||||||
|
|
||||||
elements.forEach((el, index) => {
|
|
||||||
// Add stagger delay if data-stagger attribute is present
|
|
||||||
if (el.hasAttribute('data-stagger')) {
|
|
||||||
const delay = parseInt(el.getAttribute('data-stagger')) || (index * 100);
|
|
||||||
el.style.animationDelay = `${delay}ms`;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Apply initial animation classes based on data-animation attribute
|
|
||||||
const animationType = el.getAttribute('data-animation') || 'fade-in';
|
|
||||||
if (this.animations[animationType]) {
|
|
||||||
// Remove any existing animation classes
|
|
||||||
Object.values(this.animations).forEach(classes => {
|
|
||||||
classes.split(' ').forEach(cls => el.classList.remove(cls));
|
|
||||||
});
|
|
||||||
|
|
||||||
// Add initial state classes (will be removed when visible)
|
|
||||||
const initialClasses = this.getInitialClasses(animationType);
|
|
||||||
initialClasses.forEach(cls => el.classList.add(cls));
|
|
||||||
}
|
|
||||||
|
|
||||||
observer.observe(el);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
getInitialClasses(animationType) {
|
|
||||||
// Return classes that represent the "before animation" state
|
|
||||||
const map = {
|
|
||||||
'fade-in': ['opacity-0'],
|
|
||||||
'slide-up': ['opacity-0', 'translate-y-8'],
|
|
||||||
'slide-down': ['opacity-0', '-translate-y-8'],
|
|
||||||
'slide-left': ['opacity-0', 'translate-x-8'],
|
|
||||||
'slide-right': ['opacity-0', '-translate-x-8'],
|
|
||||||
'scale-in': ['opacity-0', 'scale-95'],
|
|
||||||
'rotate-in': ['opacity-0', 'rotate-12']
|
|
||||||
};
|
|
||||||
|
|
||||||
return map[animationType] || ['opacity-0'];
|
|
||||||
}
|
|
||||||
|
|
||||||
animateElement(element) {
|
|
||||||
// Remove initial state classes
|
|
||||||
element.classList.remove('opacity-0', 'translate-y-8', '-translate-y-8', 'translate-x-8', '-translate-x-8', 'scale-95', 'rotate-12');
|
|
||||||
|
|
||||||
// Add visible state
|
|
||||||
element.classList.add('is-visible');
|
|
||||||
|
|
||||||
// Trigger custom event for other components to listen to
|
|
||||||
element.dispatchEvent(new CustomEvent('scroll-animated', {
|
|
||||||
bubbles: true,
|
|
||||||
detail: { element }
|
|
||||||
}));
|
|
||||||
}
|
|
||||||
|
|
||||||
resetElement(element) {
|
|
||||||
// Remove visible state
|
|
||||||
element.classList.remove('is-visible');
|
|
||||||
|
|
||||||
// Re-apply initial animation classes
|
|
||||||
const animationType = element.getAttribute('data-animation') || 'fade-in';
|
|
||||||
const initialClasses = this.getInitialClasses(animationType);
|
|
||||||
initialClasses.forEach(cls => element.classList.add(cls));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Auto-initialize when script loads
|
|
||||||
// Can be disabled by setting window.DISABLE_AUTO_SCROLL_ANIMATIONS = true before loading this script
|
|
||||||
if (typeof window !== 'undefined' && !window.DISABLE_AUTO_SCROLL_ANIMATIONS) {
|
|
||||||
window.scrollAnimations = new ScrollAnimations();
|
|
||||||
}
|
|
||||||
|
|
||||||
// Export for module usage
|
|
||||||
if (typeof module !== 'undefined' && module.exports) {
|
|
||||||
module.exports = ScrollAnimations;
|
|
||||||
}
|
|
||||||
|
|
@ -1,131 +0,0 @@
|
||||||
/**
|
|
||||||
* Currency Utilities (Client-Side)
|
|
||||||
* Multi-currency support for Koha donation form
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Base prices in NZD (in cents)
|
|
||||||
const BASE_PRICES_NZD = {
|
|
||||||
tier_5: 500, // $5 NZD
|
|
||||||
tier_15: 1500, // $15 NZD
|
|
||||||
tier_50: 5000 // $50 NZD
|
|
||||||
};
|
|
||||||
|
|
||||||
// Exchange rates: 1 NZD = X currency
|
|
||||||
const EXCHANGE_RATES = {
|
|
||||||
NZD: 1.0,
|
|
||||||
USD: 0.60,
|
|
||||||
EUR: 0.55,
|
|
||||||
GBP: 0.47,
|
|
||||||
AUD: 0.93,
|
|
||||||
CAD: 0.82,
|
|
||||||
JPY: 94.0,
|
|
||||||
CHF: 0.53,
|
|
||||||
SGD: 0.81,
|
|
||||||
HKD: 4.68
|
|
||||||
};
|
|
||||||
|
|
||||||
// Currency metadata
|
|
||||||
const CURRENCY_CONFIG = {
|
|
||||||
NZD: { symbol: '$', code: 'NZD', name: 'NZ Dollar', decimals: 2, flag: '🇳🇿' },
|
|
||||||
USD: { symbol: '$', code: 'USD', name: 'US Dollar', decimals: 2, flag: '🇺🇸' },
|
|
||||||
EUR: { symbol: '€', code: 'EUR', name: 'Euro', decimals: 2, flag: '🇪🇺' },
|
|
||||||
GBP: { symbol: '£', code: 'GBP', name: 'British Pound', decimals: 2, flag: '🇬🇧' },
|
|
||||||
AUD: { symbol: '$', code: 'AUD', name: 'Australian Dollar', decimals: 2, flag: '🇦🇺' },
|
|
||||||
CAD: { symbol: '$', code: 'CAD', name: 'Canadian Dollar', decimals: 2, flag: '🇨🇦' },
|
|
||||||
JPY: { symbol: '¥', code: 'JPY', name: 'Japanese Yen', decimals: 0, flag: '🇯🇵' },
|
|
||||||
CHF: { symbol: 'CHF', code: 'CHF', name: 'Swiss Franc', decimals: 2, flag: '🇨🇭' },
|
|
||||||
SGD: { symbol: '$', code: 'SGD', name: 'Singapore Dollar', decimals: 2, flag: '🇸🇬' },
|
|
||||||
HKD: { symbol: '$', code: 'HKD', name: 'Hong Kong Dollar', decimals: 2, flag: '🇭🇰' }
|
|
||||||
};
|
|
||||||
|
|
||||||
// Supported currencies
|
|
||||||
const SUPPORTED_CURRENCIES = ['NZD', 'USD', 'EUR', 'GBP', 'AUD', 'CAD', 'JPY', 'CHF', 'SGD', 'HKD'];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Convert NZD amount to target currency
|
|
||||||
*/
|
|
||||||
function convertFromNZD(amountNZD, targetCurrency) {
|
|
||||||
const rate = EXCHANGE_RATES[targetCurrency];
|
|
||||||
return Math.round(amountNZD * rate);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get tier prices for a currency
|
|
||||||
*/
|
|
||||||
function getTierPrices(currency) {
|
|
||||||
return {
|
|
||||||
tier_5: convertFromNZD(BASE_PRICES_NZD.tier_5, currency),
|
|
||||||
tier_15: convertFromNZD(BASE_PRICES_NZD.tier_15, currency),
|
|
||||||
tier_50: convertFromNZD(BASE_PRICES_NZD.tier_50, currency)
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Format currency amount for display
|
|
||||||
*/
|
|
||||||
function formatCurrency(amountCents, currency) {
|
|
||||||
const config = CURRENCY_CONFIG[currency];
|
|
||||||
const amount = amountCents / 100;
|
|
||||||
|
|
||||||
// For currencies with symbols that should come after (none in our list currently)
|
|
||||||
// we could customize here, but Intl.NumberFormat handles it well
|
|
||||||
|
|
||||||
try {
|
|
||||||
return new Intl.NumberFormat('en-NZ', {
|
|
||||||
style: 'currency',
|
|
||||||
currency: currency,
|
|
||||||
minimumFractionDigits: config.decimals,
|
|
||||||
maximumFractionDigits: config.decimals
|
|
||||||
}).format(amount);
|
|
||||||
} catch (e) {
|
|
||||||
// Fallback if Intl fails
|
|
||||||
return `${config.symbol}${amount.toFixed(config.decimals)}`;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get currency display name with flag
|
|
||||||
*/
|
|
||||||
function getCurrencyDisplayName(currency) {
|
|
||||||
const config = CURRENCY_CONFIG[currency];
|
|
||||||
return `${config.flag} ${config.code} - ${config.name}`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Detect user's currency from browser/location
|
|
||||||
*/
|
|
||||||
function detectUserCurrency() {
|
|
||||||
// Try localStorage first
|
|
||||||
const saved = localStorage.getItem('tractatus_currency');
|
|
||||||
if (saved && SUPPORTED_CURRENCIES.includes(saved)) {
|
|
||||||
return saved;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Try to detect from browser language
|
|
||||||
const lang = navigator.language || navigator.userLanguage || 'en-NZ';
|
|
||||||
const langMap = {
|
|
||||||
'en-US': 'USD',
|
|
||||||
'en-GB': 'GBP',
|
|
||||||
'en-AU': 'AUD',
|
|
||||||
'en-CA': 'CAD',
|
|
||||||
'en-NZ': 'NZD',
|
|
||||||
'ja': 'JPY',
|
|
||||||
'ja-JP': 'JPY',
|
|
||||||
'de': 'EUR',
|
|
||||||
'de-DE': 'EUR',
|
|
||||||
'fr': 'EUR',
|
|
||||||
'fr-FR': 'EUR',
|
|
||||||
'de-CH': 'CHF',
|
|
||||||
'en-SG': 'SGD',
|
|
||||||
'zh-HK': 'HKD'
|
|
||||||
};
|
|
||||||
|
|
||||||
return langMap[lang] || langMap[lang.substring(0, 2)] || 'NZD';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Save user's currency preference
|
|
||||||
*/
|
|
||||||
function saveCurrencyPreference(currency) {
|
|
||||||
localStorage.setItem('tractatus_currency', currency);
|
|
||||||
}
|
|
||||||
|
|
@ -1,112 +0,0 @@
|
||||||
/**
|
|
||||||
* Simple client-side router for three audience paths
|
|
||||||
*/
|
|
||||||
|
|
||||||
class Router {
|
|
||||||
constructor() {
|
|
||||||
this.routes = new Map();
|
|
||||||
this.currentPath = null;
|
|
||||||
|
|
||||||
// Initialize router
|
|
||||||
window.addEventListener('popstate', () => this.handleRoute());
|
|
||||||
document.addEventListener('DOMContentLoaded', () => this.handleRoute());
|
|
||||||
|
|
||||||
// Handle link clicks
|
|
||||||
document.addEventListener('click', (e) => {
|
|
||||||
if (e.target.matches('[data-route]')) {
|
|
||||||
e.preventDefault();
|
|
||||||
const path = e.target.getAttribute('data-route') || e.target.getAttribute('href');
|
|
||||||
this.navigateTo(path);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Register a route
|
|
||||||
*/
|
|
||||||
on(path, handler) {
|
|
||||||
this.routes.set(path, handler);
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Navigate to a path
|
|
||||||
*/
|
|
||||||
navigateTo(path) {
|
|
||||||
if (path === this.currentPath) return;
|
|
||||||
|
|
||||||
history.pushState(null, '', path);
|
|
||||||
this.handleRoute();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle current route
|
|
||||||
*/
|
|
||||||
async handleRoute() {
|
|
||||||
const path = window.location.pathname;
|
|
||||||
this.currentPath = path;
|
|
||||||
|
|
||||||
// Try exact match
|
|
||||||
if (this.routes.has(path)) {
|
|
||||||
await this.routes.get(path)();
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Try pattern match
|
|
||||||
for (const [pattern, handler] of this.routes) {
|
|
||||||
const match = this.matchRoute(pattern, path);
|
|
||||||
if (match) {
|
|
||||||
await handler(match.params);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// No match, show 404
|
|
||||||
this.show404();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Match route pattern
|
|
||||||
*/
|
|
||||||
matchRoute(pattern, path) {
|
|
||||||
const patternParts = pattern.split('/');
|
|
||||||
const pathParts = path.split('/');
|
|
||||||
|
|
||||||
if (patternParts.length !== pathParts.length) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
const params = {};
|
|
||||||
for (let i = 0; i < patternParts.length; i++) {
|
|
||||||
if (patternParts[i].startsWith(':')) {
|
|
||||||
const paramName = patternParts[i].slice(1);
|
|
||||||
params[paramName] = pathParts[i];
|
|
||||||
} else if (patternParts[i] !== pathParts[i]) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return { params };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Show 404 page
|
|
||||||
*/
|
|
||||||
show404() {
|
|
||||||
const container = document.getElementById('app') || document.body;
|
|
||||||
container.innerHTML = `
|
|
||||||
<div class="min-h-screen flex items-center justify-center bg-gray-50">
|
|
||||||
<div class="text-center">
|
|
||||||
<h1 class="text-6xl font-bold text-gray-900 mb-4">404</h1>
|
|
||||||
<p class="text-xl text-gray-600 mb-8">Page not found</p>
|
|
||||||
<a href="/" class="text-blue-600 hover:text-blue-700 font-semibold">
|
|
||||||
← Return to homepage
|
|
||||||
</a>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Create global router instance
|
|
||||||
window.router = new Router();
|
|
||||||
|
|
@ -1,421 +0,0 @@
|
||||||
/**
|
|
||||||
* Tractatus Version Manager
|
|
||||||
* - Registers service worker
|
|
||||||
* - Checks for updates every hour
|
|
||||||
* - Shows update notifications
|
|
||||||
* - Manages PWA install prompts
|
|
||||||
*/
|
|
||||||
|
|
||||||
class VersionManager {
|
|
||||||
constructor() {
|
|
||||||
this.serviceWorker = null;
|
|
||||||
this.deferredInstallPrompt = null;
|
|
||||||
this.updateCheckInterval = null;
|
|
||||||
this.currentVersion = null;
|
|
||||||
|
|
||||||
this.init();
|
|
||||||
}
|
|
||||||
|
|
||||||
async init() {
|
|
||||||
// Only run in browsers that support service workers
|
|
||||||
if (!('serviceWorker' in navigator)) {
|
|
||||||
console.log('[VersionManager] Service workers not supported');
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
try {
|
|
||||||
// Register service worker
|
|
||||||
await this.registerServiceWorker();
|
|
||||||
|
|
||||||
// Check for updates immediately
|
|
||||||
await this.checkForUpdates();
|
|
||||||
|
|
||||||
// Check for updates every hour
|
|
||||||
this.updateCheckInterval = setInterval(() => {
|
|
||||||
this.checkForUpdates();
|
|
||||||
}, 3600000); // 1 hour
|
|
||||||
|
|
||||||
// Listen for PWA install prompt
|
|
||||||
this.setupInstallPrompt();
|
|
||||||
|
|
||||||
// Listen for service worker messages
|
|
||||||
navigator.serviceWorker.addEventListener('message', (event) => {
|
|
||||||
if (event.data.type === 'UPDATE_AVAILABLE') {
|
|
||||||
this.showUpdateNotification(event.data);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('[VersionManager] Initialization failed:', error);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async registerServiceWorker() {
|
|
||||||
try {
|
|
||||||
const registration = await navigator.serviceWorker.register('/service-worker.js');
|
|
||||||
this.serviceWorker = registration;
|
|
||||||
console.log('[VersionManager] Service worker registered');
|
|
||||||
|
|
||||||
// Check for updates when service worker updates
|
|
||||||
registration.addEventListener('updatefound', () => {
|
|
||||||
const newWorker = registration.installing;
|
|
||||||
newWorker.addEventListener('statechange', () => {
|
|
||||||
if (newWorker.state === 'installed' && navigator.serviceWorker.controller) {
|
|
||||||
// New service worker available
|
|
||||||
this.showUpdateNotification({
|
|
||||||
updateAvailable: true,
|
|
||||||
currentVersion: this.currentVersion,
|
|
||||||
serverVersion: 'latest'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('[VersionManager] Service worker registration failed:', error);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async checkForUpdates() {
|
|
||||||
try {
|
|
||||||
const response = await fetch('/version.json', { cache: 'no-store' });
|
|
||||||
const versionInfo = await response.json();
|
|
||||||
|
|
||||||
// Get current version from localStorage or default
|
|
||||||
const storedVersion = localStorage.getItem('tractatus_version') || '0.0.0';
|
|
||||||
this.currentVersion = storedVersion;
|
|
||||||
|
|
||||||
if (storedVersion !== versionInfo.version) {
|
|
||||||
console.log('[VersionManager] Update available:', versionInfo.version);
|
|
||||||
this.showUpdateNotification({
|
|
||||||
updateAvailable: true,
|
|
||||||
currentVersion: storedVersion,
|
|
||||||
serverVersion: versionInfo.version,
|
|
||||||
changelog: versionInfo.changelog,
|
|
||||||
forceUpdate: versionInfo.forceUpdate
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('[VersionManager] Version check failed:', error);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
showUpdateNotification(versionInfo) {
|
|
||||||
// Don't show if notification already visible
|
|
||||||
if (document.getElementById('tractatus-update-notification')) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
const notification = document.createElement('div');
|
|
||||||
notification.id = 'tractatus-update-notification';
|
|
||||||
notification.className = 'fixed bottom-0 left-0 right-0 bg-blue-600 text-white px-4 py-3 shadow-lg z-50 transform transition-transform duration-300 translate-y-full';
|
|
||||||
notification.innerHTML = `
|
|
||||||
<div class="max-w-7xl mx-auto flex items-center justify-between flex-wrap gap-4">
|
|
||||||
<div class="flex items-start flex-1">
|
|
||||||
<svg class="w-6 h-6 mr-3 flex-shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
|
|
||||||
</svg>
|
|
||||||
<div>
|
|
||||||
<p class="font-semibold">Update Available</p>
|
|
||||||
<p class="text-sm text-blue-100">
|
|
||||||
A new version of Tractatus Framework is available
|
|
||||||
${versionInfo.serverVersion ? `(v${versionInfo.serverVersion})` : ''}
|
|
||||||
</p>
|
|
||||||
${versionInfo.changelog ? `
|
|
||||||
<details class="mt-2 text-sm">
|
|
||||||
<summary class="cursor-pointer text-blue-100 hover:text-white">What's new?</summary>
|
|
||||||
<ul class="mt-2 ml-4 list-disc text-blue-100">
|
|
||||||
${versionInfo.changelog.map(item => `<li>${item}</li>`).join('')}
|
|
||||||
</ul>
|
|
||||||
</details>
|
|
||||||
` : ''}
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="flex gap-3">
|
|
||||||
${versionInfo.forceUpdate ? `
|
|
||||||
<button id="update-now-btn" class="bg-white text-blue-600 px-6 py-2 rounded-lg font-semibold hover:bg-blue-50 transition">
|
|
||||||
Update Now
|
|
||||||
</button>
|
|
||||||
` : `
|
|
||||||
<button id="update-later-btn" class="text-white hover:text-blue-100 transition px-3">
|
|
||||||
Later
|
|
||||||
</button>
|
|
||||||
<button id="update-reload-btn" class="bg-white text-blue-600 px-6 py-2 rounded-lg font-semibold hover:bg-blue-50 transition">
|
|
||||||
Reload
|
|
||||||
</button>
|
|
||||||
`}
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
|
|
||||||
document.body.appendChild(notification);
|
|
||||||
|
|
||||||
// Add event listeners (CSP compliant)
|
|
||||||
const updateNowBtn = document.getElementById('update-now-btn');
|
|
||||||
const updateLaterBtn = document.getElementById('update-later-btn');
|
|
||||||
const updateReloadBtn = document.getElementById('update-reload-btn');
|
|
||||||
|
|
||||||
if (updateNowBtn) {
|
|
||||||
updateNowBtn.addEventListener('click', () => this.applyUpdate());
|
|
||||||
}
|
|
||||||
if (updateLaterBtn) {
|
|
||||||
updateLaterBtn.addEventListener('click', () => this.dismissUpdate());
|
|
||||||
}
|
|
||||||
if (updateReloadBtn) {
|
|
||||||
updateReloadBtn.addEventListener('click', () => this.applyUpdate());
|
|
||||||
}
|
|
||||||
|
|
||||||
// Animate in
|
|
||||||
setTimeout(() => {
|
|
||||||
notification.classList.remove('translate-y-full');
|
|
||||||
}, 100);
|
|
||||||
|
|
||||||
// Auto-reload for forced updates after 10 seconds
|
|
||||||
if (versionInfo.forceUpdate) {
|
|
||||||
setTimeout(() => {
|
|
||||||
this.applyUpdate();
|
|
||||||
}, 10000);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
applyUpdate() {
|
|
||||||
// Store new version
|
|
||||||
fetch('/version.json', { cache: 'no-store' })
|
|
||||||
.then(response => response.json())
|
|
||||||
.then(versionInfo => {
|
|
||||||
localStorage.setItem('tractatus_version', versionInfo.version);
|
|
||||||
|
|
||||||
// Tell service worker to skip waiting
|
|
||||||
if (this.serviceWorker) {
|
|
||||||
this.serviceWorker.waiting?.postMessage({ type: 'SKIP_WAITING' });
|
|
||||||
}
|
|
||||||
|
|
||||||
// Reload page
|
|
||||||
window.location.reload();
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
dismissUpdate() {
|
|
||||||
const notification = document.getElementById('tractatus-update-notification');
|
|
||||||
if (notification) {
|
|
||||||
notification.classList.add('translate-y-full');
|
|
||||||
setTimeout(() => {
|
|
||||||
notification.remove();
|
|
||||||
}, 300);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
setupInstallPrompt() {
|
|
||||||
// Listen for beforeinstallprompt event
|
|
||||||
window.addEventListener('beforeinstallprompt', (e) => {
|
|
||||||
// Prevent Chrome 67 and earlier from automatically showing the prompt
|
|
||||||
e.preventDefault();
|
|
||||||
|
|
||||||
// Stash the event so it can be triggered later
|
|
||||||
this.deferredInstallPrompt = e;
|
|
||||||
|
|
||||||
// Check if user has dismissed install prompt before
|
|
||||||
const dismissed = sessionStorage.getItem('install_prompt_dismissed');
|
|
||||||
if (!dismissed) {
|
|
||||||
// Show install prompt after 30 seconds
|
|
||||||
setTimeout(() => {
|
|
||||||
this.showInstallPrompt();
|
|
||||||
}, 30000);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Detect if app was installed
|
|
||||||
window.addEventListener('appinstalled', () => {
|
|
||||||
console.log('[VersionManager] PWA installed');
|
|
||||||
this.deferredInstallPrompt = null;
|
|
||||||
|
|
||||||
// Hide install prompt if visible
|
|
||||||
const prompt = document.getElementById('tractatus-install-prompt');
|
|
||||||
if (prompt) {
|
|
||||||
prompt.remove();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
showInstallPrompt() {
|
|
||||||
if (!this.deferredInstallPrompt) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Don't show if already installed or on iOS Safari (handles differently)
|
|
||||||
if (window.matchMedia('(display-mode: standalone)').matches) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
const prompt = document.createElement('div');
|
|
||||||
prompt.id = 'tractatus-install-prompt';
|
|
||||||
prompt.className = 'fixed bottom-0 left-0 right-0 bg-gradient-to-r from-purple-600 to-blue-600 text-white px-4 py-3 shadow-lg z-50 transform transition-transform duration-300 translate-y-full';
|
|
||||||
prompt.innerHTML = `
|
|
||||||
<div class="max-w-7xl mx-auto flex items-center justify-between flex-wrap gap-4">
|
|
||||||
<div class="flex items-start flex-1">
|
|
||||||
<svg class="w-6 h-6 mr-3 flex-shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 18h.01M8 21h8a2 2 0 002-2V5a2 2 0 00-2-2H8a2 2 0 00-2 2v14a2 2 0 002 2z"/>
|
|
||||||
</svg>
|
|
||||||
<div>
|
|
||||||
<p class="font-semibold">Install Tractatus App</p>
|
|
||||||
<p class="text-sm text-purple-100">
|
|
||||||
Add to your home screen for quick access and offline support
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="flex gap-3">
|
|
||||||
<button id="dismiss-install-btn" class="text-white hover:text-purple-100 transition px-3">
|
|
||||||
Not Now
|
|
||||||
</button>
|
|
||||||
<button id="install-app-btn" class="bg-white text-purple-600 px-6 py-2 rounded-lg font-semibold hover:bg-purple-50 transition">
|
|
||||||
Install
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
|
|
||||||
document.body.appendChild(prompt);
|
|
||||||
|
|
||||||
// Add event listeners (CSP compliant)
|
|
||||||
const dismissBtn = document.getElementById('dismiss-install-btn');
|
|
||||||
const installBtn = document.getElementById('install-app-btn');
|
|
||||||
|
|
||||||
if (dismissBtn) {
|
|
||||||
dismissBtn.addEventListener('click', () => this.dismissInstallPrompt());
|
|
||||||
}
|
|
||||||
if (installBtn) {
|
|
||||||
installBtn.addEventListener('click', () => this.installApp());
|
|
||||||
}
|
|
||||||
|
|
||||||
// Animate in
|
|
||||||
setTimeout(() => {
|
|
||||||
prompt.classList.remove('translate-y-full');
|
|
||||||
}, 100);
|
|
||||||
}
|
|
||||||
|
|
||||||
async installApp() {
|
|
||||||
if (!this.deferredInstallPrompt) {
|
|
||||||
// Show helpful feedback if installation isn't available
|
|
||||||
this.showInstallUnavailableMessage();
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Show the install prompt
|
|
||||||
this.deferredInstallPrompt.prompt();
|
|
||||||
|
|
||||||
// Wait for the user to respond to the prompt
|
|
||||||
const { outcome } = await this.deferredInstallPrompt.userChoice;
|
|
||||||
console.log(`[VersionManager] User response: ${outcome}`);
|
|
||||||
|
|
||||||
// Clear the deferredInstallPrompt
|
|
||||||
this.deferredInstallPrompt = null;
|
|
||||||
|
|
||||||
// Hide the prompt
|
|
||||||
this.dismissInstallPrompt();
|
|
||||||
}
|
|
||||||
|
|
||||||
showInstallUnavailableMessage() {
|
|
||||||
// Check if app is already installed
|
|
||||||
const isInstalled = window.matchMedia('(display-mode: standalone)').matches;
|
|
||||||
|
|
||||||
// Don't show message if it already exists
|
|
||||||
if (document.getElementById('tractatus-install-unavailable')) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
const message = document.createElement('div');
|
|
||||||
message.id = 'tractatus-install-unavailable';
|
|
||||||
message.className = 'fixed bottom-0 left-0 right-0 bg-gray-800 text-white px-4 py-3 shadow-lg z-50 transform transition-transform duration-300 translate-y-full';
|
|
||||||
|
|
||||||
if (isInstalled) {
|
|
||||||
message.innerHTML = `
|
|
||||||
<div class="max-w-7xl mx-auto flex items-center justify-between flex-wrap gap-4">
|
|
||||||
<div class="flex items-start flex-1">
|
|
||||||
<svg class="w-6 h-6 mr-3 flex-shrink-0 text-green-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"/>
|
|
||||||
</svg>
|
|
||||||
<div>
|
|
||||||
<p class="font-semibold">Already Installed</p>
|
|
||||||
<p class="text-sm text-gray-300">
|
|
||||||
Tractatus is already installed on your device. You're using it right now!
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<button id="dismiss-unavailable-btn" class="text-white hover:text-gray-300 transition px-3">
|
|
||||||
Okay
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
} else {
|
|
||||||
message.innerHTML = `
|
|
||||||
<div class="max-w-7xl mx-auto flex items-center justify-between flex-wrap gap-4">
|
|
||||||
<div class="flex items-start flex-1">
|
|
||||||
<svg class="w-6 h-6 mr-3 flex-shrink-0 text-yellow-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
||||||
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
|
|
||||||
</svg>
|
|
||||||
<div>
|
|
||||||
<p class="font-semibold">Installation Not Available</p>
|
|
||||||
<p class="text-sm text-gray-300">
|
|
||||||
Your browser doesn't currently support app installation. Try using Chrome, Edge, or Safari on a supported device.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<button id="dismiss-unavailable-btn" class="text-white hover:text-gray-300 transition px-3">
|
|
||||||
Okay
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
document.body.appendChild(message);
|
|
||||||
|
|
||||||
// Add event listener for dismiss button
|
|
||||||
const dismissBtn = document.getElementById('dismiss-unavailable-btn');
|
|
||||||
if (dismissBtn) {
|
|
||||||
dismissBtn.addEventListener('click', () => {
|
|
||||||
message.classList.add('translate-y-full');
|
|
||||||
setTimeout(() => {
|
|
||||||
message.remove();
|
|
||||||
}, 300);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Animate in
|
|
||||||
setTimeout(() => {
|
|
||||||
message.classList.remove('translate-y-full');
|
|
||||||
}, 100);
|
|
||||||
|
|
||||||
// Auto-dismiss after 8 seconds
|
|
||||||
setTimeout(() => {
|
|
||||||
if (message.parentElement) {
|
|
||||||
message.classList.add('translate-y-full');
|
|
||||||
setTimeout(() => {
|
|
||||||
message.remove();
|
|
||||||
}, 300);
|
|
||||||
}
|
|
||||||
}, 8000);
|
|
||||||
}
|
|
||||||
|
|
||||||
dismissInstallPrompt() {
|
|
||||||
const prompt = document.getElementById('tractatus-install-prompt');
|
|
||||||
if (prompt) {
|
|
||||||
prompt.classList.add('translate-y-full');
|
|
||||||
setTimeout(() => {
|
|
||||||
prompt.remove();
|
|
||||||
}, 300);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Remember dismissal for this session
|
|
||||||
sessionStorage.setItem('install_prompt_dismissed', 'true');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Initialize version manager on page load
|
|
||||||
if (document.readyState === 'loading') {
|
|
||||||
document.addEventListener('DOMContentLoaded', () => {
|
|
||||||
window.versionManager = new VersionManager();
|
|
||||||
});
|
|
||||||
} else {
|
|
||||||
window.versionManager = new VersionManager();
|
|
||||||
}
|
|
||||||
|
|
@ -1,388 +0,0 @@
|
||||||
/**
|
|
||||||
* Admin Controller
|
|
||||||
* Moderation queue and system statistics
|
|
||||||
*/
|
|
||||||
|
|
||||||
const ModerationQueue = require('../models/ModerationQueue.model');
|
|
||||||
const Document = require('../models/Document.model');
|
|
||||||
const BlogPost = require('../models/BlogPost.model');
|
|
||||||
const User = require('../models/User.model');
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get moderation queue dashboard
|
|
||||||
* GET /api/admin/moderation
|
|
||||||
*/
|
|
||||||
async function getModerationQueue(req, res) {
|
|
||||||
try {
|
|
||||||
const { limit = 20, skip = 0, priority, quadrant, item_type, type } = req.query;
|
|
||||||
|
|
||||||
let items;
|
|
||||||
let total;
|
|
||||||
|
|
||||||
// Support both new 'type' and legacy 'item_type' fields
|
|
||||||
// Treat 'all' as no filter (same as not providing a type)
|
|
||||||
const filterType = (type && type !== 'all') ? type : (item_type && item_type !== 'all' ? item_type : null);
|
|
||||||
|
|
||||||
if (quadrant) {
|
|
||||||
items = await ModerationQueue.findByQuadrant(quadrant, {
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip)
|
|
||||||
});
|
|
||||||
total = await ModerationQueue.countPending({ quadrant });
|
|
||||||
} else if (filterType) {
|
|
||||||
// Filter by new 'type' field (preferred) or legacy 'item_type' field
|
|
||||||
const collection = await require('../utils/db.util').getCollection('moderation_queue');
|
|
||||||
items = await collection
|
|
||||||
.find({
|
|
||||||
status: 'pending',
|
|
||||||
$or: [
|
|
||||||
{ type: filterType },
|
|
||||||
{ item_type: filterType }
|
|
||||||
]
|
|
||||||
})
|
|
||||||
.sort({ priority: -1, created_at: 1 })
|
|
||||||
.skip(parseInt(skip))
|
|
||||||
.limit(parseInt(limit))
|
|
||||||
.toArray();
|
|
||||||
|
|
||||||
total = await collection.countDocuments({
|
|
||||||
status: 'pending',
|
|
||||||
$or: [
|
|
||||||
{ type: filterType },
|
|
||||||
{ item_type: filterType }
|
|
||||||
]
|
|
||||||
});
|
|
||||||
} else {
|
|
||||||
items = await ModerationQueue.findPending({
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip),
|
|
||||||
priority
|
|
||||||
});
|
|
||||||
total = await ModerationQueue.countPending(priority ? { priority } : {});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Get stats by quadrant
|
|
||||||
const stats = await ModerationQueue.getStatsByQuadrant();
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
items,
|
|
||||||
queue: items, // Alias for backward compatibility
|
|
||||||
stats: stats.reduce((acc, stat) => {
|
|
||||||
acc[stat._id] = {
|
|
||||||
total: stat.count,
|
|
||||||
high_priority: stat.high_priority
|
|
||||||
};
|
|
||||||
return acc;
|
|
||||||
}, {}),
|
|
||||||
pagination: {
|
|
||||||
total,
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip)
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get moderation queue error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get single moderation item
|
|
||||||
* GET /api/admin/moderation/:id
|
|
||||||
*/
|
|
||||||
async function getModerationItem(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
|
|
||||||
const item = await ModerationQueue.findById(id);
|
|
||||||
|
|
||||||
if (!item) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Moderation item not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
item
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get moderation item error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Review moderation item (approve/reject/escalate)
|
|
||||||
* POST /api/admin/moderation/:id/review
|
|
||||||
*/
|
|
||||||
async function reviewModerationItem(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
const { action, notes } = req.body;
|
|
||||||
|
|
||||||
const item = await ModerationQueue.findById(id);
|
|
||||||
|
|
||||||
if (!item) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Moderation item not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
let success;
|
|
||||||
let createdPost = null;
|
|
||||||
|
|
||||||
switch (action) {
|
|
||||||
case 'approve':
|
|
||||||
success = await ModerationQueue.approve(id, req.userId, notes);
|
|
||||||
|
|
||||||
// Blog-specific handling: Create BlogPost from approved draft
|
|
||||||
if (success && item.type === 'BLOG_POST_DRAFT' && item.data?.draft) {
|
|
||||||
try {
|
|
||||||
const draft = item.data.draft;
|
|
||||||
const slug = generateSlug(draft.title);
|
|
||||||
|
|
||||||
// Create and publish blog post
|
|
||||||
createdPost = await BlogPost.create({
|
|
||||||
title: draft.title,
|
|
||||||
slug,
|
|
||||||
content: draft.content,
|
|
||||||
excerpt: draft.excerpt,
|
|
||||||
tags: draft.tags || [],
|
|
||||||
author: {
|
|
||||||
type: 'ai_curated',
|
|
||||||
name: req.user.name || req.user.email,
|
|
||||||
claude_version: item.metadata?.model_info?.model || 'claude-3-5-sonnet'
|
|
||||||
},
|
|
||||||
author_name: req.user.name || req.user.email, // Flattened for frontend
|
|
||||||
ai_assisted: true, // Flag for AI disclosure
|
|
||||||
tractatus_classification: {
|
|
||||||
quadrant: item.quadrant || 'OPERATIONAL',
|
|
||||||
values_sensitive: false,
|
|
||||||
requires_strategic_review: false
|
|
||||||
},
|
|
||||||
moderation: {
|
|
||||||
ai_analysis: item.data.validation,
|
|
||||||
human_reviewer: req.userId,
|
|
||||||
review_notes: notes,
|
|
||||||
approved_at: new Date()
|
|
||||||
},
|
|
||||||
status: 'published',
|
|
||||||
published_at: new Date()
|
|
||||||
});
|
|
||||||
|
|
||||||
// Log governance action
|
|
||||||
const GovernanceLog = require('../models/GovernanceLog.model');
|
|
||||||
await GovernanceLog.create({
|
|
||||||
action: 'BLOG_POST_PUBLISHED',
|
|
||||||
user_id: req.userId,
|
|
||||||
user_email: req.user.email,
|
|
||||||
timestamp: new Date(),
|
|
||||||
outcome: 'APPROVED',
|
|
||||||
details: {
|
|
||||||
post_id: createdPost._id,
|
|
||||||
slug,
|
|
||||||
title: draft.title,
|
|
||||||
queue_id: id,
|
|
||||||
validation_result: item.data.validation?.recommendation
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`Blog post created from approved draft: ${createdPost._id} (${slug}) by ${req.user.email}`);
|
|
||||||
} catch (blogError) {
|
|
||||||
logger.error('Failed to create blog post from approved draft:', blogError);
|
|
||||||
// Don't fail the entire approval if blog creation fails
|
|
||||||
}
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
case 'reject':
|
|
||||||
success = await ModerationQueue.reject(id, req.userId, notes);
|
|
||||||
break;
|
|
||||||
case 'escalate':
|
|
||||||
success = await ModerationQueue.escalate(id, req.userId, notes);
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'Invalid action. Must be: approve, reject, or escalate'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
return res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'Failed to update moderation item'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const updatedItem = await ModerationQueue.findById(id);
|
|
||||||
|
|
||||||
logger.info(`Moderation item ${action}: ${id} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
item: updatedItem,
|
|
||||||
message: `Item ${action}d successfully`,
|
|
||||||
blog_post: createdPost ? {
|
|
||||||
id: createdPost._id,
|
|
||||||
slug: createdPost.slug,
|
|
||||||
title: createdPost.title,
|
|
||||||
url: `/blog-post.html?slug=${createdPost.slug}`
|
|
||||||
} : undefined
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Review moderation item error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate URL-friendly slug from title
|
|
||||||
*/
|
|
||||||
function generateSlug(title) {
|
|
||||||
return title
|
|
||||||
.toLowerCase()
|
|
||||||
.replace(/[^a-z0-9]+/g, '-')
|
|
||||||
.replace(/^-|-$/g, '')
|
|
||||||
.substring(0, 100);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get system statistics
|
|
||||||
* GET /api/admin/stats
|
|
||||||
*/
|
|
||||||
async function getSystemStats(req, res) {
|
|
||||||
try {
|
|
||||||
// Document stats
|
|
||||||
const totalDocuments = await Document.count();
|
|
||||||
const documentsByQuadrant = await Promise.all([
|
|
||||||
Document.count({ quadrant: 'STRATEGIC' }),
|
|
||||||
Document.count({ quadrant: 'OPERATIONAL' }),
|
|
||||||
Document.count({ quadrant: 'TACTICAL' }),
|
|
||||||
Document.count({ quadrant: 'SYSTEM' }),
|
|
||||||
Document.count({ quadrant: 'STOCHASTIC' })
|
|
||||||
]);
|
|
||||||
|
|
||||||
// Blog stats
|
|
||||||
const blogStats = await Promise.all([
|
|
||||||
BlogPost.countByStatus('published'),
|
|
||||||
BlogPost.countByStatus('draft'),
|
|
||||||
BlogPost.countByStatus('pending')
|
|
||||||
]);
|
|
||||||
|
|
||||||
// Moderation queue stats
|
|
||||||
const moderationStats = await ModerationQueue.getStatsByQuadrant();
|
|
||||||
const totalPending = await ModerationQueue.countPending();
|
|
||||||
|
|
||||||
// User stats
|
|
||||||
const totalUsers = await User.count();
|
|
||||||
const activeUsers = await User.count({ active: true });
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
stats: {
|
|
||||||
documents: {
|
|
||||||
total: totalDocuments,
|
|
||||||
by_quadrant: {
|
|
||||||
STRATEGIC: documentsByQuadrant[0],
|
|
||||||
OPERATIONAL: documentsByQuadrant[1],
|
|
||||||
TACTICAL: documentsByQuadrant[2],
|
|
||||||
SYSTEM: documentsByQuadrant[3],
|
|
||||||
STOCHASTIC: documentsByQuadrant[4]
|
|
||||||
}
|
|
||||||
},
|
|
||||||
blog: {
|
|
||||||
published: blogStats[0],
|
|
||||||
draft: blogStats[1],
|
|
||||||
pending: blogStats[2],
|
|
||||||
total: blogStats[0] + blogStats[1] + blogStats[2]
|
|
||||||
},
|
|
||||||
moderation: {
|
|
||||||
total_pending: totalPending,
|
|
||||||
by_quadrant: moderationStats.reduce((acc, stat) => {
|
|
||||||
acc[stat._id] = {
|
|
||||||
total: stat.count,
|
|
||||||
high_priority: stat.high_priority
|
|
||||||
};
|
|
||||||
return acc;
|
|
||||||
}, {})
|
|
||||||
},
|
|
||||||
users: {
|
|
||||||
total: totalUsers,
|
|
||||||
active: activeUsers,
|
|
||||||
inactive: totalUsers - activeUsers
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get system stats error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get recent activity log
|
|
||||||
* GET /api/admin/activity
|
|
||||||
*/
|
|
||||||
async function getActivityLog(req, res) {
|
|
||||||
try {
|
|
||||||
// This would typically read from a dedicated activity log
|
|
||||||
// For now, return recent moderation reviews as example
|
|
||||||
const { limit = 50 } = req.query;
|
|
||||||
|
|
||||||
const collection = await require('../utils/db.util').getCollection('moderation_queue');
|
|
||||||
|
|
||||||
const recentActivity = await collection
|
|
||||||
.find({ status: 'reviewed' })
|
|
||||||
.sort({ reviewed_at: -1 })
|
|
||||||
.limit(parseInt(limit))
|
|
||||||
.toArray();
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
activity: recentActivity.map(item => ({
|
|
||||||
timestamp: item.reviewed_at,
|
|
||||||
action: item.review_decision?.action,
|
|
||||||
item_type: item.item_type,
|
|
||||||
item_id: item.item_id,
|
|
||||||
reviewer: item.review_decision?.reviewer,
|
|
||||||
notes: item.review_decision?.notes
|
|
||||||
}))
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get activity log error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
getModerationQueue,
|
|
||||||
getModerationItem,
|
|
||||||
reviewModerationItem,
|
|
||||||
getSystemStats,
|
|
||||||
getActivityLog
|
|
||||||
};
|
|
||||||
|
|
@ -1,121 +0,0 @@
|
||||||
/**
|
|
||||||
* Authentication Controller
|
|
||||||
* Handles user login and token verification
|
|
||||||
*/
|
|
||||||
|
|
||||||
const User = require('../models/User.model');
|
|
||||||
const { generateToken } = require('../utils/jwt.util');
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Login user
|
|
||||||
* POST /api/auth/login
|
|
||||||
*/
|
|
||||||
async function login(req, res) {
|
|
||||||
try {
|
|
||||||
const { email, password } = req.body;
|
|
||||||
|
|
||||||
// Authenticate user
|
|
||||||
const user = await User.authenticate(email, password);
|
|
||||||
|
|
||||||
if (!user) {
|
|
||||||
logger.warn(`Failed login attempt for email: ${email}`);
|
|
||||||
return res.status(401).json({
|
|
||||||
error: 'Authentication failed',
|
|
||||||
message: 'Invalid email or password'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Generate JWT token
|
|
||||||
const token = generateToken({
|
|
||||||
userId: user._id.toString(),
|
|
||||||
email: user.email,
|
|
||||||
role: user.role
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`User logged in: ${user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
accessToken: token,
|
|
||||||
user: {
|
|
||||||
id: user._id.toString(),
|
|
||||||
email: user.email,
|
|
||||||
name: user.name,
|
|
||||||
role: user.role
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Login error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred during login'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Verify token and get current user
|
|
||||||
* GET /api/auth/me
|
|
||||||
*/
|
|
||||||
async function getCurrentUser(req, res) {
|
|
||||||
try {
|
|
||||||
// User is already attached to req by auth middleware
|
|
||||||
const user = await User.findById(req.userId);
|
|
||||||
|
|
||||||
if (!user) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'User not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
user: {
|
|
||||||
id: user._id,
|
|
||||||
email: user.email,
|
|
||||||
name: user.name,
|
|
||||||
role: user.role,
|
|
||||||
created_at: user.created_at,
|
|
||||||
last_login: user.last_login
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get current user error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Logout (client-side token removal, server logs it)
|
|
||||||
* POST /api/auth/logout
|
|
||||||
*/
|
|
||||||
async function logout(req, res) {
|
|
||||||
try {
|
|
||||||
logger.info(`User logged out: ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Logged out successfully'
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Logout error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
login,
|
|
||||||
getCurrentUser,
|
|
||||||
logout
|
|
||||||
};
|
|
||||||
|
|
@ -1,764 +0,0 @@
|
||||||
/**
|
|
||||||
* Blog Controller
|
|
||||||
* AI-curated blog with human oversight
|
|
||||||
*/
|
|
||||||
|
|
||||||
const BlogPost = require('../models/BlogPost.model');
|
|
||||||
const ModerationQueue = require('../models/ModerationQueue.model');
|
|
||||||
const GovernanceLog = require('../models/GovernanceLog.model');
|
|
||||||
const { markdownToHtml } = require('../utils/markdown.util');
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
const claudeAPI = require('../services/ClaudeAPI.service');
|
|
||||||
const BoundaryEnforcer = require('../services/BoundaryEnforcer.service');
|
|
||||||
const BlogCuration = require('../services/BlogCuration.service');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List published blog posts (public)
|
|
||||||
* GET /api/blog
|
|
||||||
*/
|
|
||||||
async function listPublishedPosts(req, res) {
|
|
||||||
try {
|
|
||||||
const { limit = 10, skip = 0 } = req.query;
|
|
||||||
|
|
||||||
const posts = await BlogPost.findPublished({
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip)
|
|
||||||
});
|
|
||||||
|
|
||||||
const total = await BlogPost.countByStatus('published');
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
posts,
|
|
||||||
pagination: {
|
|
||||||
total,
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip),
|
|
||||||
hasMore: parseInt(skip) + posts.length < total
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('List published posts error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get single blog post by slug (public, published only)
|
|
||||||
* GET /api/blog/:slug
|
|
||||||
*/
|
|
||||||
async function getPublishedPost(req, res) {
|
|
||||||
try {
|
|
||||||
const { slug } = req.params;
|
|
||||||
|
|
||||||
const post = await BlogPost.findBySlug(slug);
|
|
||||||
|
|
||||||
if (!post || post.status !== 'published') {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Blog post not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Increment view count
|
|
||||||
await BlogPost.incrementViews(post._id);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
post
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get published post error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List posts by status (admin only)
|
|
||||||
* GET /api/blog/admin/posts?status=draft
|
|
||||||
*/
|
|
||||||
async function listPostsByStatus(req, res) {
|
|
||||||
try {
|
|
||||||
const { status = 'draft', limit = 20, skip = 0 } = req.query;
|
|
||||||
|
|
||||||
const posts = await BlogPost.findByStatus(status, {
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip)
|
|
||||||
});
|
|
||||||
|
|
||||||
const total = await BlogPost.countByStatus(status);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
status,
|
|
||||||
posts,
|
|
||||||
pagination: {
|
|
||||||
total,
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip)
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('List posts by status error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get any post by ID (admin only)
|
|
||||||
* GET /api/blog/admin/:id
|
|
||||||
*/
|
|
||||||
async function getPostById(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
|
|
||||||
const post = await BlogPost.findById(id);
|
|
||||||
|
|
||||||
if (!post) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Blog post not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
post
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get post by ID error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create blog post (admin only)
|
|
||||||
* POST /api/blog
|
|
||||||
*/
|
|
||||||
async function createPost(req, res) {
|
|
||||||
try {
|
|
||||||
const { title, slug, content, excerpt, tags, author, tractatus_classification } = req.body;
|
|
||||||
|
|
||||||
// Convert markdown content to HTML if needed
|
|
||||||
const content_html = content.includes('# ') ? markdownToHtml(content) : content;
|
|
||||||
|
|
||||||
const post = await BlogPost.create({
|
|
||||||
title,
|
|
||||||
slug,
|
|
||||||
content: content_html,
|
|
||||||
excerpt,
|
|
||||||
tags,
|
|
||||||
author: {
|
|
||||||
...author,
|
|
||||||
name: author?.name || req.user.name || req.user.email
|
|
||||||
},
|
|
||||||
tractatus_classification,
|
|
||||||
status: 'draft'
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`Blog post created: ${slug} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.status(201).json({
|
|
||||||
success: true,
|
|
||||||
post
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Create post error:', error);
|
|
||||||
|
|
||||||
// Handle duplicate slug
|
|
||||||
if (error.code === 11000) {
|
|
||||||
return res.status(409).json({
|
|
||||||
error: 'Conflict',
|
|
||||||
message: 'A post with this slug already exists'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update blog post (admin only)
|
|
||||||
* PUT /api/blog/:id
|
|
||||||
*/
|
|
||||||
async function updatePost(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
const updates = { ...req.body };
|
|
||||||
|
|
||||||
// If content is updated and looks like markdown, convert to HTML
|
|
||||||
if (updates.content && updates.content.includes('# ')) {
|
|
||||||
updates.content = markdownToHtml(updates.content);
|
|
||||||
}
|
|
||||||
|
|
||||||
const success = await BlogPost.update(id, updates);
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Blog post not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const post = await BlogPost.findById(id);
|
|
||||||
|
|
||||||
logger.info(`Blog post updated: ${id} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
post
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Update post error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Publish blog post (admin only)
|
|
||||||
* POST /api/blog/:id/publish
|
|
||||||
*/
|
|
||||||
async function publishPost(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
const { review_notes } = req.body;
|
|
||||||
|
|
||||||
const post = await BlogPost.findById(id);
|
|
||||||
|
|
||||||
if (!post) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Blog post not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
if (post.status === 'published') {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'Post is already published'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Update with review notes if provided
|
|
||||||
if (review_notes) {
|
|
||||||
await BlogPost.update(id, {
|
|
||||||
'moderation.review_notes': review_notes
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Publish the post
|
|
||||||
await BlogPost.publish(id, req.userId);
|
|
||||||
|
|
||||||
const updatedPost = await BlogPost.findById(id);
|
|
||||||
|
|
||||||
logger.info(`Blog post published: ${id} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
post: updatedPost,
|
|
||||||
message: 'Post published successfully'
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Publish post error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete blog post (admin only)
|
|
||||||
* DELETE /api/blog/:id
|
|
||||||
*/
|
|
||||||
async function deletePost(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
|
|
||||||
const success = await BlogPost.delete(id);
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Blog post not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Blog post deleted: ${id} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Post deleted successfully'
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Delete post error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Suggest blog topics using AI (admin only)
|
|
||||||
* POST /api/blog/suggest-topics
|
|
||||||
*
|
|
||||||
* TRA-OPS-0002: AI suggests topics, human writes and approves posts
|
|
||||||
*/
|
|
||||||
async function suggestTopics(req, res) {
|
|
||||||
try {
|
|
||||||
const { audience, theme } = req.body;
|
|
||||||
|
|
||||||
// Validate audience
|
|
||||||
const validAudiences = ['researcher', 'implementer', 'advocate', 'general'];
|
|
||||||
if (!audience || !validAudiences.includes(audience)) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: `Audience must be one of: ${validAudiences.join(', ')}`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Blog topic suggestion requested: audience=${audience}, theme=${theme || 'none'}`);
|
|
||||||
|
|
||||||
// 1. Boundary check (TRA-OPS-0002: Editorial decisions require human oversight)
|
|
||||||
const boundaryCheck = BoundaryEnforcer.enforce({
|
|
||||||
description: 'Suggest blog topics for editorial calendar',
|
|
||||||
text: 'AI provides suggestions, human makes final editorial decisions',
|
|
||||||
classification: { quadrant: 'OPERATIONAL' },
|
|
||||||
type: 'content_suggestion'
|
|
||||||
});
|
|
||||||
|
|
||||||
// Log boundary check
|
|
||||||
await GovernanceLog.create({
|
|
||||||
action: 'BLOG_TOPIC_SUGGESTION',
|
|
||||||
user_id: req.user._id,
|
|
||||||
user_email: req.user.email,
|
|
||||||
timestamp: new Date(),
|
|
||||||
boundary_check: boundaryCheck,
|
|
||||||
outcome: boundaryCheck.allowed ? 'QUEUED_FOR_APPROVAL' : 'BLOCKED',
|
|
||||||
details: {
|
|
||||||
audience,
|
|
||||||
theme
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
if (!boundaryCheck.allowed) {
|
|
||||||
logger.warn(`Blog topic suggestion blocked by BoundaryEnforcer: ${boundaryCheck.section}`);
|
|
||||||
return res.status(403).json({
|
|
||||||
error: 'Boundary Violation',
|
|
||||||
message: boundaryCheck.reasoning,
|
|
||||||
section: boundaryCheck.section,
|
|
||||||
details: 'This action requires human judgment in values territory'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// 2. Claude API call for topic suggestions
|
|
||||||
const suggestions = await claudeAPI.generateBlogTopics(audience, theme);
|
|
||||||
|
|
||||||
logger.info(`Claude API returned ${suggestions.length} topic suggestions`);
|
|
||||||
|
|
||||||
// 3. Create moderation queue entry (human approval required)
|
|
||||||
const queueEntry = await ModerationQueue.create({
|
|
||||||
type: 'BLOG_TOPIC_SUGGESTION',
|
|
||||||
reference_collection: 'blog_posts',
|
|
||||||
data: {
|
|
||||||
audience,
|
|
||||||
theme,
|
|
||||||
suggestions,
|
|
||||||
requested_by: req.user.email
|
|
||||||
},
|
|
||||||
status: 'PENDING_APPROVAL',
|
|
||||||
ai_generated: true,
|
|
||||||
requires_human_approval: true,
|
|
||||||
created_by: req.user._id,
|
|
||||||
created_at: new Date(),
|
|
||||||
metadata: {
|
|
||||||
boundary_check: boundaryCheck,
|
|
||||||
governance_policy: 'TRA-OPS-0002'
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`Created moderation queue entry: ${queueEntry._id}`);
|
|
||||||
|
|
||||||
// 4. Return response (suggestions queued for human review)
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Blog topic suggestions generated. Awaiting human review and approval.',
|
|
||||||
queue_id: queueEntry._id,
|
|
||||||
suggestions,
|
|
||||||
governance: {
|
|
||||||
policy: 'TRA-OPS-0002',
|
|
||||||
boundary_check: boundaryCheck,
|
|
||||||
requires_approval: true,
|
|
||||||
note: 'Topics are suggestions only. Human must write all blog posts.'
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Suggest topics error:', error);
|
|
||||||
|
|
||||||
// Handle Claude API errors specifically
|
|
||||||
if (error.message.includes('Claude API')) {
|
|
||||||
return res.status(502).json({
|
|
||||||
error: 'AI Service Error',
|
|
||||||
message: 'Failed to generate topic suggestions. Please try again.',
|
|
||||||
details: process.env.NODE_ENV === 'development' ? error.message : undefined
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Draft a full blog post using AI (admin only)
|
|
||||||
* POST /api/blog/draft-post
|
|
||||||
*
|
|
||||||
* TRA-OPS-0002: AI drafts content, human reviews and approves before publication
|
|
||||||
* Enforces inst_016, inst_017, inst_018 via BlogCuration service
|
|
||||||
*/
|
|
||||||
async function draftBlogPost(req, res) {
|
|
||||||
try {
|
|
||||||
const { topic, audience, length = 'medium', focus } = req.body;
|
|
||||||
|
|
||||||
// Validate required fields
|
|
||||||
if (!topic || !audience) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'topic and audience are required'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const validAudiences = ['researcher', 'implementer', 'advocate', 'general'];
|
|
||||||
if (!validAudiences.includes(audience)) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: `audience must be one of: ${validAudiences.join(', ')}`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const validLengths = ['short', 'medium', 'long'];
|
|
||||||
if (!validLengths.includes(length)) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: `length must be one of: ${validLengths.join(', ')}`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Blog post draft requested: topic="${topic}", audience=${audience}, length=${length}`);
|
|
||||||
|
|
||||||
// Generate draft using BlogCuration service (includes boundary checks and validation)
|
|
||||||
const result = await BlogCuration.draftBlogPost({
|
|
||||||
topic,
|
|
||||||
audience,
|
|
||||||
length,
|
|
||||||
focus
|
|
||||||
});
|
|
||||||
|
|
||||||
const { draft, validation, boundary_check, metadata } = result;
|
|
||||||
|
|
||||||
// Log governance action
|
|
||||||
await GovernanceLog.create({
|
|
||||||
action: 'BLOG_POST_DRAFT',
|
|
||||||
user_id: req.user._id,
|
|
||||||
user_email: req.user.email,
|
|
||||||
timestamp: new Date(),
|
|
||||||
boundary_check,
|
|
||||||
outcome: 'QUEUED_FOR_APPROVAL',
|
|
||||||
details: {
|
|
||||||
topic,
|
|
||||||
audience,
|
|
||||||
length,
|
|
||||||
validation_result: validation.recommendation,
|
|
||||||
violations: validation.violations.length,
|
|
||||||
warnings: validation.warnings.length
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Create moderation queue entry (human approval required)
|
|
||||||
const queueEntry = await ModerationQueue.create({
|
|
||||||
type: 'BLOG_POST_DRAFT',
|
|
||||||
reference_collection: 'blog_posts',
|
|
||||||
data: {
|
|
||||||
topic,
|
|
||||||
audience,
|
|
||||||
length,
|
|
||||||
focus,
|
|
||||||
draft,
|
|
||||||
validation,
|
|
||||||
requested_by: req.user.email
|
|
||||||
},
|
|
||||||
status: 'PENDING_APPROVAL',
|
|
||||||
ai_generated: true,
|
|
||||||
requires_human_approval: true,
|
|
||||||
created_by: req.user._id,
|
|
||||||
created_at: new Date(),
|
|
||||||
priority: validation.violations.length > 0 ? 'high' : 'medium',
|
|
||||||
metadata: {
|
|
||||||
boundary_check,
|
|
||||||
governance_policy: 'TRA-OPS-0002',
|
|
||||||
tractatus_instructions: ['inst_016', 'inst_017', 'inst_018'],
|
|
||||||
model_info: metadata
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`Created blog draft queue entry: ${queueEntry._id}, validation: ${validation.recommendation}`);
|
|
||||||
|
|
||||||
// Return response
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Blog post draft generated. Awaiting human review and approval.',
|
|
||||||
queue_id: queueEntry._id,
|
|
||||||
draft,
|
|
||||||
validation,
|
|
||||||
governance: {
|
|
||||||
policy: 'TRA-OPS-0002',
|
|
||||||
boundary_check,
|
|
||||||
requires_approval: true,
|
|
||||||
tractatus_enforcement: {
|
|
||||||
inst_016: 'No fabricated statistics or unverifiable claims',
|
|
||||||
inst_017: 'No absolute assurance terms (guarantee, 100%, etc.)',
|
|
||||||
inst_018: 'No unverified production-ready claims'
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Draft blog post error:', error);
|
|
||||||
|
|
||||||
// Handle boundary violations
|
|
||||||
if (error.message.includes('Boundary violation')) {
|
|
||||||
return res.status(403).json({
|
|
||||||
error: 'Boundary Violation',
|
|
||||||
message: error.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Handle Claude API errors
|
|
||||||
if (error.message.includes('Claude API') || error.message.includes('Blog draft generation failed')) {
|
|
||||||
return res.status(502).json({
|
|
||||||
error: 'AI Service Error',
|
|
||||||
message: 'Failed to generate blog draft. Please try again.',
|
|
||||||
details: process.env.NODE_ENV === 'development' ? error.message : undefined
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Analyze blog content for Tractatus compliance (admin only)
|
|
||||||
* POST /api/blog/analyze-content
|
|
||||||
*
|
|
||||||
* Validates content against inst_016, inst_017, inst_018
|
|
||||||
*/
|
|
||||||
async function analyzeContent(req, res) {
|
|
||||||
try {
|
|
||||||
const { title, body } = req.body;
|
|
||||||
|
|
||||||
if (!title || !body) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'title and body are required'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Content compliance analysis requested: "${title}"`);
|
|
||||||
|
|
||||||
const analysis = await BlogCuration.analyzeContentCompliance({
|
|
||||||
title,
|
|
||||||
body
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`Compliance analysis complete: ${analysis.recommendation}, score: ${analysis.overall_score}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
analysis,
|
|
||||||
tractatus_enforcement: {
|
|
||||||
inst_016: 'No fabricated statistics',
|
|
||||||
inst_017: 'No absolute guarantees',
|
|
||||||
inst_018: 'No unverified production claims'
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Analyze content error:', error);
|
|
||||||
|
|
||||||
if (error.message.includes('Claude API') || error.message.includes('Compliance analysis failed')) {
|
|
||||||
return res.status(502).json({
|
|
||||||
error: 'AI Service Error',
|
|
||||||
message: 'Failed to analyze content. Please try again.',
|
|
||||||
details: process.env.NODE_ENV === 'development' ? error.message : undefined
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get editorial guidelines (admin only)
|
|
||||||
* GET /api/blog/editorial-guidelines
|
|
||||||
*/
|
|
||||||
async function getEditorialGuidelines(req, res) {
|
|
||||||
try {
|
|
||||||
const guidelines = BlogCuration.getEditorialGuidelines();
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
guidelines
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get editorial guidelines error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate RSS feed for published blog posts (public)
|
|
||||||
* GET /api/blog/rss
|
|
||||||
*/
|
|
||||||
async function generateRSSFeed(req, res) {
|
|
||||||
try {
|
|
||||||
// Fetch recent published posts (limit to 50 most recent)
|
|
||||||
const posts = await BlogPost.findPublished({
|
|
||||||
limit: 50,
|
|
||||||
skip: 0
|
|
||||||
});
|
|
||||||
|
|
||||||
// RSS 2.0 feed structure
|
|
||||||
const baseUrl = process.env.FRONTEND_URL || 'https://agenticgovernance.digital';
|
|
||||||
const buildDate = new Date().toUTCString();
|
|
||||||
|
|
||||||
// Start RSS XML
|
|
||||||
let rss = `<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
|
|
||||||
<channel>
|
|
||||||
<title>Tractatus AI Safety Framework Blog</title>
|
|
||||||
<link>${baseUrl}/blog.html</link>
|
|
||||||
<description>Insights, updates, and analysis on AI governance, safety frameworks, and the Tractatus boundary enforcement approach.</description>
|
|
||||||
<language>en-us</language>
|
|
||||||
<lastBuildDate>${buildDate}</lastBuildDate>
|
|
||||||
<atom:link href="${baseUrl}/api/blog/rss" rel="self" type="application/rss+xml" />
|
|
||||||
<image>
|
|
||||||
<url>${baseUrl}/images/tractatus-icon.svg</url>
|
|
||||||
<title>Tractatus AI Safety Framework</title>
|
|
||||||
<link>${baseUrl}/blog.html</link>
|
|
||||||
</image>
|
|
||||||
`;
|
|
||||||
|
|
||||||
// Add items for each post
|
|
||||||
for (const post of posts) {
|
|
||||||
const postUrl = `${baseUrl}/blog-post.html?slug=${post.slug}`;
|
|
||||||
const pubDate = new Date(post.published_at || post.created_at).toUTCString();
|
|
||||||
const author = post.author_name || post.author?.name || 'Tractatus Team';
|
|
||||||
|
|
||||||
// Strip HTML tags from excerpt for RSS description
|
|
||||||
const description = (post.excerpt || post.content)
|
|
||||||
.replace(/<[^>]*>/g, '')
|
|
||||||
.substring(0, 500);
|
|
||||||
|
|
||||||
// Tags as categories
|
|
||||||
const categories = (post.tags || []).map(tag =>
|
|
||||||
` <category>${escapeXml(tag)}</category>`
|
|
||||||
).join('\n');
|
|
||||||
|
|
||||||
rss += ` <item>
|
|
||||||
<title>${escapeXml(post.title)}</title>
|
|
||||||
<link>${postUrl}</link>
|
|
||||||
<guid isPermaLink="true">${postUrl}</guid>
|
|
||||||
<description>${escapeXml(description)}</description>
|
|
||||||
<author>${escapeXml(author)}</author>
|
|
||||||
<pubDate>${pubDate}</pubDate>
|
|
||||||
${categories ? categories + '\n' : ''} </item>
|
|
||||||
`;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Close RSS XML
|
|
||||||
rss += ` </channel>
|
|
||||||
</rss>`;
|
|
||||||
|
|
||||||
// Set RSS content-type and send
|
|
||||||
res.set('Content-Type', 'application/rss+xml; charset=UTF-8');
|
|
||||||
res.send(rss);
|
|
||||||
|
|
||||||
logger.info(`RSS feed generated: ${posts.length} posts`);
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Generate RSS feed error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'Failed to generate RSS feed'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Helper: Escape XML special characters
|
|
||||||
*/
|
|
||||||
function escapeXml(unsafe) {
|
|
||||||
if (!unsafe) return '';
|
|
||||||
return unsafe
|
|
||||||
.replace(/&/g, '&')
|
|
||||||
.replace(/</g, '<')
|
|
||||||
.replace(/>/g, '>')
|
|
||||||
.replace(/"/g, '"')
|
|
||||||
.replace(/'/g, ''');
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
listPublishedPosts,
|
|
||||||
getPublishedPost,
|
|
||||||
listPostsByStatus,
|
|
||||||
getPostById,
|
|
||||||
createPost,
|
|
||||||
updatePost,
|
|
||||||
publishPost,
|
|
||||||
deletePost,
|
|
||||||
suggestTopics,
|
|
||||||
draftBlogPost,
|
|
||||||
analyzeContent,
|
|
||||||
getEditorialGuidelines,
|
|
||||||
generateRSSFeed
|
|
||||||
};
|
|
||||||
|
|
@ -1,453 +0,0 @@
|
||||||
/**
|
|
||||||
* Case Study Controller
|
|
||||||
* Community case study submissions with AI review
|
|
||||||
*/
|
|
||||||
|
|
||||||
const CaseSubmission = require('../models/CaseSubmission.model');
|
|
||||||
const ModerationQueue = require('../models/ModerationQueue.model');
|
|
||||||
const GovernanceLog = require('../models/GovernanceLog.model');
|
|
||||||
const BoundaryEnforcer = require('../services/BoundaryEnforcer.service');
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Submit case study (public)
|
|
||||||
* POST /api/cases/submit
|
|
||||||
*
|
|
||||||
* Phase 1: Manual review (no AI)
|
|
||||||
* Phase 2: Add AI categorization with claudeAPI.reviewCaseStudy()
|
|
||||||
*/
|
|
||||||
async function submitCase(req, res) {
|
|
||||||
try {
|
|
||||||
const { submitter, case_study } = req.body;
|
|
||||||
|
|
||||||
// Validate required fields
|
|
||||||
if (!submitter?.name || !submitter?.email) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'Missing required submitter information'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!case_study?.title || !case_study?.description || !case_study?.failure_mode) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'Missing required case study information'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Case study submitted: ${case_study.title} by ${submitter.name}`);
|
|
||||||
|
|
||||||
// Create submission (Phase 1: no AI review yet)
|
|
||||||
const submission = await CaseSubmission.create({
|
|
||||||
submitter,
|
|
||||||
case_study,
|
|
||||||
ai_review: {
|
|
||||||
relevance_score: 0.5, // Default, will be AI-assessed in Phase 2
|
|
||||||
completeness_score: 0.5,
|
|
||||||
recommended_category: 'uncategorized'
|
|
||||||
},
|
|
||||||
moderation: {
|
|
||||||
status: 'pending'
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Add to moderation queue for human review
|
|
||||||
await ModerationQueue.create({
|
|
||||||
type: 'CASE_SUBMISSION',
|
|
||||||
reference_collection: 'case_submissions',
|
|
||||||
reference_id: submission._id,
|
|
||||||
quadrant: 'OPERATIONAL',
|
|
||||||
data: {
|
|
||||||
submitter,
|
|
||||||
case_study
|
|
||||||
},
|
|
||||||
priority: 'medium',
|
|
||||||
status: 'PENDING_APPROVAL',
|
|
||||||
requires_human_approval: true,
|
|
||||||
human_required_reason: 'All case submissions require human review and approval'
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`Case submission created: ${submission._id}`);
|
|
||||||
|
|
||||||
res.status(201).json({
|
|
||||||
success: true,
|
|
||||||
message: 'Thank you for your submission. We will review it shortly.',
|
|
||||||
submission_id: submission._id,
|
|
||||||
governance: {
|
|
||||||
human_review: true,
|
|
||||||
note: 'All case studies are reviewed by humans before publication'
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Submit case error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred while submitting your case study'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get case submission statistics (admin)
|
|
||||||
* GET /api/cases/submissions/stats
|
|
||||||
*/
|
|
||||||
async function getStats(req, res) {
|
|
||||||
try {
|
|
||||||
const total = await CaseSubmission.countDocuments({});
|
|
||||||
const pending = await CaseSubmission.countDocuments({ 'moderation.status': 'pending' });
|
|
||||||
const approved = await CaseSubmission.countDocuments({ 'moderation.status': 'approved' });
|
|
||||||
const rejected = await CaseSubmission.countDocuments({ 'moderation.status': 'rejected' });
|
|
||||||
const needsInfo = await CaseSubmission.countDocuments({ 'moderation.status': 'needs_info' });
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
stats: {
|
|
||||||
total,
|
|
||||||
pending,
|
|
||||||
approved,
|
|
||||||
rejected,
|
|
||||||
needs_info: needsInfo
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get stats error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List all case submissions (admin)
|
|
||||||
* GET /api/cases/submissions?status=pending&failure_mode=pattern_bias&score=high&sort=relevance_score
|
|
||||||
*/
|
|
||||||
async function listSubmissions(req, res) {
|
|
||||||
try {
|
|
||||||
const {
|
|
||||||
status,
|
|
||||||
failure_mode,
|
|
||||||
score,
|
|
||||||
sort = 'submitted_at',
|
|
||||||
limit = 20,
|
|
||||||
skip = 0
|
|
||||||
} = req.query;
|
|
||||||
|
|
||||||
// Build query filter
|
|
||||||
const filter = {};
|
|
||||||
|
|
||||||
if (status) {
|
|
||||||
filter['moderation.status'] = status;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (failure_mode) {
|
|
||||||
filter['case_study.failure_mode'] = failure_mode;
|
|
||||||
}
|
|
||||||
|
|
||||||
// AI score filtering
|
|
||||||
if (score) {
|
|
||||||
if (score === 'high') {
|
|
||||||
filter['ai_review.relevance_score'] = { $gte: 0.7 };
|
|
||||||
} else if (score === 'medium') {
|
|
||||||
filter['ai_review.relevance_score'] = { $gte: 0.4, $lt: 0.7 };
|
|
||||||
} else if (score === 'low') {
|
|
||||||
filter['ai_review.relevance_score'] = { $lt: 0.4 };
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Build sort options
|
|
||||||
const sortOptions = {};
|
|
||||||
if (sort === 'submitted_at') {
|
|
||||||
sortOptions.submitted_at = -1; // Newest first
|
|
||||||
} else if (sort === 'relevance_score') {
|
|
||||||
sortOptions['ai_review.relevance_score'] = -1; // Highest first
|
|
||||||
} else if (sort === 'completeness_score') {
|
|
||||||
sortOptions['ai_review.completeness_score'] = -1; // Highest first
|
|
||||||
}
|
|
||||||
|
|
||||||
// Query database
|
|
||||||
const submissions = await CaseSubmission.find(filter)
|
|
||||||
.sort(sortOptions)
|
|
||||||
.limit(parseInt(limit))
|
|
||||||
.skip(parseInt(skip))
|
|
||||||
.lean();
|
|
||||||
|
|
||||||
const total = await CaseSubmission.countDocuments(filter);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
submissions,
|
|
||||||
pagination: {
|
|
||||||
total,
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip),
|
|
||||||
hasMore: parseInt(skip) + submissions.length < total
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('List submissions error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List high-relevance pending submissions (admin)
|
|
||||||
* GET /api/cases/submissions/high-relevance
|
|
||||||
*/
|
|
||||||
async function listHighRelevance(req, res) {
|
|
||||||
try {
|
|
||||||
const { limit = 10 } = req.query;
|
|
||||||
|
|
||||||
const submissions = await CaseSubmission.findHighRelevance({
|
|
||||||
limit: parseInt(limit)
|
|
||||||
});
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
count: submissions.length,
|
|
||||||
submissions
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('List high relevance error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get case submission by ID (admin)
|
|
||||||
* GET /api/cases/submissions/:id
|
|
||||||
*/
|
|
||||||
async function getSubmission(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
|
|
||||||
const submission = await CaseSubmission.findById(id);
|
|
||||||
|
|
||||||
if (!submission) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Case submission not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
submission
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get submission error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Approve case submission (admin)
|
|
||||||
* POST /api/cases/submissions/:id/approve
|
|
||||||
*/
|
|
||||||
async function approveSubmission(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
const { notes } = req.body;
|
|
||||||
|
|
||||||
const submission = await CaseSubmission.findById(id);
|
|
||||||
|
|
||||||
if (!submission) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Case submission not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
if (submission.moderation.status === 'approved') {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'Submission is already approved'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const success = await CaseSubmission.approve(id, req.user._id, notes || '');
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
return res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'Failed to approve submission'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Case submission approved: ${id} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Case submission approved successfully',
|
|
||||||
note: 'You can now publish this as a case study document'
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Approve submission error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Reject case submission (admin)
|
|
||||||
* POST /api/cases/submissions/:id/reject
|
|
||||||
*/
|
|
||||||
async function rejectSubmission(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
const { reason } = req.body;
|
|
||||||
|
|
||||||
if (!reason) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'Rejection reason is required'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const submission = await CaseSubmission.findById(id);
|
|
||||||
|
|
||||||
if (!submission) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Case submission not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const success = await CaseSubmission.reject(id, req.user._id, reason);
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
return res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'Failed to reject submission'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Case submission rejected: ${id} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Case submission rejected',
|
|
||||||
note: 'Consider notifying the submitter with feedback'
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Reject submission error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Request more information (admin)
|
|
||||||
* POST /api/cases/submissions/:id/request-info
|
|
||||||
*/
|
|
||||||
async function requestMoreInfo(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
const { requested_info } = req.body;
|
|
||||||
|
|
||||||
if (!requested_info) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'Requested information must be specified'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const submission = await CaseSubmission.findById(id);
|
|
||||||
|
|
||||||
if (!submission) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Case submission not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const success = await CaseSubmission.requestInfo(id, req.user._id, requested_info);
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
return res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'Failed to update submission'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`More info requested for case ${id} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Information request recorded',
|
|
||||||
note: 'Remember to contact submitter separately to request additional information'
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Request info error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete case submission (admin)
|
|
||||||
* DELETE /api/cases/submissions/:id
|
|
||||||
*/
|
|
||||||
async function deleteSubmission(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
|
|
||||||
const success = await CaseSubmission.delete(id);
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Case submission not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Case submission deleted: ${id} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Case submission deleted successfully'
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Delete submission error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
submitCase,
|
|
||||||
getStats,
|
|
||||||
listSubmissions,
|
|
||||||
listHighRelevance,
|
|
||||||
getSubmission,
|
|
||||||
approveSubmission,
|
|
||||||
rejectSubmission,
|
|
||||||
requestMoreInfo,
|
|
||||||
deleteSubmission
|
|
||||||
};
|
|
||||||
|
|
@ -1,480 +0,0 @@
|
||||||
/**
|
|
||||||
* Documents Controller
|
|
||||||
* Handles framework documentation CRUD operations
|
|
||||||
*/
|
|
||||||
|
|
||||||
const Document = require('../models/Document.model');
|
|
||||||
const { markdownToHtml, extractTOC } = require('../utils/markdown.util');
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List all documents
|
|
||||||
* GET /api/documents
|
|
||||||
*/
|
|
||||||
async function listDocuments(req, res) {
|
|
||||||
try {
|
|
||||||
const { limit = 50, skip = 0, quadrant, audience } = req.query;
|
|
||||||
|
|
||||||
let documents;
|
|
||||||
let total;
|
|
||||||
|
|
||||||
// Build filter - only show public documents (not internal/confidential)
|
|
||||||
const filter = {
|
|
||||||
visibility: 'public'
|
|
||||||
};
|
|
||||||
if (quadrant) {
|
|
||||||
filter.quadrant = quadrant;
|
|
||||||
}
|
|
||||||
if (audience) {
|
|
||||||
filter.audience = audience;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (quadrant && !audience) {
|
|
||||||
documents = await Document.findByQuadrant(quadrant, {
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip),
|
|
||||||
publicOnly: true
|
|
||||||
});
|
|
||||||
total = await Document.count(filter);
|
|
||||||
} else if (audience && !quadrant) {
|
|
||||||
documents = await Document.findByAudience(audience, {
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip),
|
|
||||||
publicOnly: true
|
|
||||||
});
|
|
||||||
total = await Document.count(filter);
|
|
||||||
} else {
|
|
||||||
documents = await Document.list({
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip),
|
|
||||||
filter
|
|
||||||
});
|
|
||||||
total = await Document.count(filter);
|
|
||||||
}
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
documents,
|
|
||||||
pagination: {
|
|
||||||
total,
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip),
|
|
||||||
hasMore: parseInt(skip) + documents.length < total
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('List documents error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get document by ID or slug
|
|
||||||
* GET /api/documents/:identifier
|
|
||||||
*/
|
|
||||||
async function getDocument(req, res) {
|
|
||||||
try {
|
|
||||||
const { identifier } = req.params;
|
|
||||||
|
|
||||||
// Try to find by ID first, then by slug
|
|
||||||
let document;
|
|
||||||
if (identifier.match(/^[0-9a-fA-F]{24}$/)) {
|
|
||||||
document = await Document.findById(identifier);
|
|
||||||
} else {
|
|
||||||
document = await Document.findBySlug(identifier);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!document) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Document not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
document
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get document error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Search documents with faceted filtering
|
|
||||||
* GET /api/documents/search?q=...&quadrant=...&persistence=...&audience=...
|
|
||||||
*/
|
|
||||||
async function searchDocuments(req, res) {
|
|
||||||
try {
|
|
||||||
const { q, quadrant, persistence, audience, limit = 20, skip = 0 } = req.query;
|
|
||||||
|
|
||||||
// Build filter for faceted search
|
|
||||||
const filter = {
|
|
||||||
visibility: 'public'
|
|
||||||
};
|
|
||||||
|
|
||||||
// Add facet filters
|
|
||||||
if (quadrant) {
|
|
||||||
filter.quadrant = quadrant.toUpperCase();
|
|
||||||
}
|
|
||||||
if (persistence) {
|
|
||||||
filter.persistence = persistence.toUpperCase();
|
|
||||||
}
|
|
||||||
if (audience) {
|
|
||||||
filter.audience = audience.toLowerCase();
|
|
||||||
}
|
|
||||||
|
|
||||||
let documents;
|
|
||||||
|
|
||||||
// If text query provided, use full-text search with filters
|
|
||||||
if (q && q.trim()) {
|
|
||||||
const { getCollection } = require('../utils/db.util');
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
|
|
||||||
// Add text search to filter
|
|
||||||
filter.$text = { $search: q };
|
|
||||||
|
|
||||||
documents = await collection
|
|
||||||
.find(filter, { score: { $meta: 'textScore' } })
|
|
||||||
.sort({ score: { $meta: 'textScore' } })
|
|
||||||
.skip(parseInt(skip))
|
|
||||||
.limit(parseInt(limit))
|
|
||||||
.toArray();
|
|
||||||
} else {
|
|
||||||
// No text query - just filter by facets
|
|
||||||
documents = await Document.list({
|
|
||||||
filter,
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip),
|
|
||||||
sort: { order: 1, 'metadata.date_created': -1 }
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Count total matching documents
|
|
||||||
const { getCollection } = require('../utils/db.util');
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
const total = await collection.countDocuments(filter);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
query: q || null,
|
|
||||||
filters: {
|
|
||||||
quadrant: quadrant || null,
|
|
||||||
persistence: persistence || null,
|
|
||||||
audience: audience || null
|
|
||||||
},
|
|
||||||
documents,
|
|
||||||
count: documents.length,
|
|
||||||
total,
|
|
||||||
pagination: {
|
|
||||||
total,
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip),
|
|
||||||
hasMore: parseInt(skip) + documents.length < total
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Search documents error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create document (admin only)
|
|
||||||
* POST /api/documents
|
|
||||||
*/
|
|
||||||
async function createDocument(req, res) {
|
|
||||||
try {
|
|
||||||
const { title, slug, quadrant, persistence, audience, content_markdown, metadata } = req.body;
|
|
||||||
|
|
||||||
// Convert markdown to HTML
|
|
||||||
const content_html = markdownToHtml(content_markdown);
|
|
||||||
|
|
||||||
// Extract table of contents
|
|
||||||
const toc = extractTOC(content_markdown);
|
|
||||||
|
|
||||||
// Create search index from content
|
|
||||||
const search_index = `${title} ${content_markdown}`.toLowerCase();
|
|
||||||
|
|
||||||
const document = await Document.create({
|
|
||||||
title,
|
|
||||||
slug,
|
|
||||||
quadrant,
|
|
||||||
persistence,
|
|
||||||
audience: audience || 'general',
|
|
||||||
content_html,
|
|
||||||
content_markdown,
|
|
||||||
toc,
|
|
||||||
metadata,
|
|
||||||
search_index
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`Document created: ${slug} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.status(201).json({
|
|
||||||
success: true,
|
|
||||||
document
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Create document error:', error);
|
|
||||||
|
|
||||||
// Handle duplicate slug
|
|
||||||
if (error.code === 11000) {
|
|
||||||
return res.status(409).json({
|
|
||||||
error: 'Conflict',
|
|
||||||
message: 'A document with this slug already exists'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update document (admin only)
|
|
||||||
* PUT /api/documents/:id
|
|
||||||
*/
|
|
||||||
async function updateDocument(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
const updates = { ...req.body };
|
|
||||||
|
|
||||||
// If content_markdown is updated, regenerate HTML and TOC
|
|
||||||
if (updates.content_markdown) {
|
|
||||||
updates.content_html = markdownToHtml(updates.content_markdown);
|
|
||||||
updates.toc = extractTOC(updates.content_markdown);
|
|
||||||
updates.search_index = `${updates.title || ''} ${updates.content_markdown}`.toLowerCase();
|
|
||||||
}
|
|
||||||
|
|
||||||
const success = await Document.update(id, updates);
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Document not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const document = await Document.findById(id);
|
|
||||||
|
|
||||||
logger.info(`Document updated: ${id} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
document
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Update document error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete document (admin only)
|
|
||||||
* DELETE /api/documents/:id
|
|
||||||
*/
|
|
||||||
async function deleteDocument(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
|
|
||||||
const success = await Document.delete(id);
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Document not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Document deleted: ${id} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Document deleted successfully'
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Delete document error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List archived documents
|
|
||||||
* GET /api/documents/archived
|
|
||||||
*/
|
|
||||||
async function listArchivedDocuments(req, res) {
|
|
||||||
try {
|
|
||||||
const { limit = 50, skip = 0 } = req.query;
|
|
||||||
|
|
||||||
const documents = await Document.listArchived({
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip)
|
|
||||||
});
|
|
||||||
|
|
||||||
const total = await Document.count({ visibility: 'archived' });
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
documents,
|
|
||||||
pagination: {
|
|
||||||
total,
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip),
|
|
||||||
hasMore: parseInt(skip) + documents.length < total
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('List archived documents error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Publish a document (admin only)
|
|
||||||
* POST /api/documents/:id/publish
|
|
||||||
*
|
|
||||||
* SECURITY: Explicit publish workflow prevents accidental exposure
|
|
||||||
* World-class UX: Clear validation messages guide admins
|
|
||||||
*/
|
|
||||||
async function publishDocument(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
const { category, order } = req.body;
|
|
||||||
|
|
||||||
const result = await Document.publish(id, {
|
|
||||||
category,
|
|
||||||
order,
|
|
||||||
publishedBy: req.user?.email || 'admin'
|
|
||||||
});
|
|
||||||
|
|
||||||
if (!result.success) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: result.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Document published: ${id} by ${req.user?.email || 'admin'} (category: ${category})`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: result.message,
|
|
||||||
document: result.document
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Publish document error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: error.message || 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Unpublish a document (admin only)
|
|
||||||
* POST /api/documents/:id/unpublish
|
|
||||||
*/
|
|
||||||
async function unpublishDocument(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
const { reason } = req.body;
|
|
||||||
|
|
||||||
const result = await Document.unpublish(id, reason);
|
|
||||||
|
|
||||||
if (!result.success) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: result.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Document unpublished: ${id} by ${req.user?.email || 'admin'} (reason: ${reason || 'none'})`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: result.message
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Unpublish document error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List draft documents (admin only)
|
|
||||||
* GET /api/documents/drafts
|
|
||||||
*/
|
|
||||||
async function listDraftDocuments(req, res) {
|
|
||||||
try {
|
|
||||||
const { limit = 50, skip = 0 } = req.query;
|
|
||||||
|
|
||||||
const documents = await Document.listByWorkflowStatus('draft', {
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip)
|
|
||||||
});
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
documents,
|
|
||||||
pagination: {
|
|
||||||
total: documents.length,
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip)
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('List draft documents error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
listDocuments,
|
|
||||||
getDocument,
|
|
||||||
searchDocuments,
|
|
||||||
createDocument,
|
|
||||||
updateDocument,
|
|
||||||
deleteDocument,
|
|
||||||
listArchivedDocuments,
|
|
||||||
publishDocument,
|
|
||||||
unpublishDocument,
|
|
||||||
listDraftDocuments
|
|
||||||
};
|
|
||||||
|
|
@ -1,307 +0,0 @@
|
||||||
/**
|
|
||||||
* Koha Controller
|
|
||||||
* Handles donation-related HTTP requests
|
|
||||||
*/
|
|
||||||
|
|
||||||
const kohaService = require('../services/koha.service');
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create checkout session for donation
|
|
||||||
* POST /api/koha/checkout
|
|
||||||
*/
|
|
||||||
exports.createCheckout = async (req, res) => {
|
|
||||||
try {
|
|
||||||
// Check if Stripe is configured (not placeholder)
|
|
||||||
if (!process.env.STRIPE_SECRET_KEY ||
|
|
||||||
process.env.STRIPE_SECRET_KEY.includes('PLACEHOLDER')) {
|
|
||||||
return res.status(503).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Donation system not yet active',
|
|
||||||
message: 'The Koha donation system is currently being configured. Please check back soon.'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const { amount, frequency, tier, donor, public_acknowledgement, public_name } = req.body;
|
|
||||||
|
|
||||||
// Validate required fields
|
|
||||||
if (!amount || !frequency || !donor?.email) {
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Missing required fields: amount, frequency, donor.email'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Validate amount
|
|
||||||
if (amount < 100) {
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Minimum donation amount is NZD $1.00'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Validate frequency
|
|
||||||
if (!['monthly', 'one_time'].includes(frequency)) {
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Invalid frequency. Must be "monthly" or "one_time"'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Validate tier for monthly donations
|
|
||||||
if (frequency === 'monthly' && !['5', '15', '50'].includes(tier)) {
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Invalid tier for monthly donations. Must be "5", "15", or "50"'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Create checkout session
|
|
||||||
const session = await kohaService.createCheckoutSession({
|
|
||||||
amount,
|
|
||||||
frequency,
|
|
||||||
tier,
|
|
||||||
donor,
|
|
||||||
public_acknowledgement: public_acknowledgement || false,
|
|
||||||
public_name: public_name || null
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`[KOHA] Checkout session created: ${session.sessionId}`);
|
|
||||||
|
|
||||||
res.status(200).json({
|
|
||||||
success: true,
|
|
||||||
data: session
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Create checkout error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: error.message || 'Failed to create checkout session'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle Stripe webhook events
|
|
||||||
* POST /api/koha/webhook
|
|
||||||
*/
|
|
||||||
exports.handleWebhook = async (req, res) => {
|
|
||||||
const signature = req.headers['stripe-signature'];
|
|
||||||
|
|
||||||
try {
|
|
||||||
// Verify webhook signature and construct event
|
|
||||||
const event = kohaService.verifyWebhookSignature(req.rawBody, signature);
|
|
||||||
|
|
||||||
// Process webhook event
|
|
||||||
await kohaService.handleWebhook(event);
|
|
||||||
|
|
||||||
res.status(200).json({ received: true });
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Webhook error:', error);
|
|
||||||
res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: error.message || 'Webhook processing failed'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get public transparency metrics
|
|
||||||
* GET /api/koha/transparency
|
|
||||||
*/
|
|
||||||
exports.getTransparency = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const metrics = await kohaService.getTransparencyMetrics();
|
|
||||||
|
|
||||||
res.status(200).json({
|
|
||||||
success: true,
|
|
||||||
data: metrics
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Get transparency error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to fetch transparency metrics'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Cancel recurring donation
|
|
||||||
* POST /api/koha/cancel
|
|
||||||
* Requires email verification to prevent unauthorized cancellations
|
|
||||||
*/
|
|
||||||
exports.cancelDonation = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const { subscriptionId, email } = req.body;
|
|
||||||
|
|
||||||
if (!subscriptionId || !email) {
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Subscription ID and email are required'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Verify donor owns this subscription by checking email
|
|
||||||
const donation = await require('../models/Donation.model').findBySubscriptionId(subscriptionId);
|
|
||||||
|
|
||||||
if (!donation) {
|
|
||||||
return res.status(404).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Subscription not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Verify email matches the donor's email
|
|
||||||
if (donation.donor.email.toLowerCase() !== email.toLowerCase()) {
|
|
||||||
logger.warn(`[KOHA SECURITY] Failed cancellation attempt: subscription ${subscriptionId} with wrong email ${email}`);
|
|
||||||
return res.status(403).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Email does not match subscription owner'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Email verified, proceed with cancellation
|
|
||||||
const result = await kohaService.cancelRecurringDonation(subscriptionId);
|
|
||||||
|
|
||||||
logger.info(`[KOHA] Subscription cancelled: ${subscriptionId} by ${email}`);
|
|
||||||
|
|
||||||
res.status(200).json({
|
|
||||||
success: true,
|
|
||||||
data: result
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Cancel donation error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: error.message || 'Failed to cancel donation'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get donation statistics (ADMIN ONLY)
|
|
||||||
* GET /api/koha/statistics
|
|
||||||
* Authentication enforced in routes layer (requireAdmin middleware)
|
|
||||||
*/
|
|
||||||
exports.getStatistics = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const { startDate, endDate } = req.query;
|
|
||||||
|
|
||||||
const statistics = await kohaService.getStatistics(startDate, endDate);
|
|
||||||
|
|
||||||
res.status(200).json({
|
|
||||||
success: true,
|
|
||||||
data: statistics
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Get statistics error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to fetch statistics'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Verify donation session (after redirect from Stripe)
|
|
||||||
* GET /api/koha/verify/:sessionId
|
|
||||||
*/
|
|
||||||
exports.verifySession = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const { sessionId } = req.params;
|
|
||||||
|
|
||||||
if (!sessionId) {
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Session ID is required'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Retrieve session from Stripe
|
|
||||||
const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);
|
|
||||||
const session = await stripe.checkout.sessions.retrieve(sessionId);
|
|
||||||
|
|
||||||
// Check if payment was successful
|
|
||||||
const isSuccessful = session.payment_status === 'paid';
|
|
||||||
|
|
||||||
res.status(200).json({
|
|
||||||
success: true,
|
|
||||||
data: {
|
|
||||||
status: session.payment_status,
|
|
||||||
amount: session.amount_total / 100,
|
|
||||||
currency: session.currency,
|
|
||||||
frequency: session.metadata.frequency,
|
|
||||||
isSuccessful: isSuccessful
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Verify session error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to verify session'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create Stripe Customer Portal session
|
|
||||||
* POST /api/koha/portal
|
|
||||||
* Allows donors to manage their subscription (update payment, cancel, etc.)
|
|
||||||
*/
|
|
||||||
exports.createPortalSession = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const { email } = req.body;
|
|
||||||
|
|
||||||
if (!email) {
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Email is required'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Find customer by email
|
|
||||||
const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);
|
|
||||||
const customers = await stripe.customers.list({
|
|
||||||
email: email,
|
|
||||||
limit: 1
|
|
||||||
});
|
|
||||||
|
|
||||||
if (customers.data.length === 0) {
|
|
||||||
return res.status(404).json({
|
|
||||||
success: false,
|
|
||||||
error: 'No subscription found for this email address'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const customer = customers.data[0];
|
|
||||||
|
|
||||||
// Create portal session
|
|
||||||
const session = await stripe.billingPortal.sessions.create({
|
|
||||||
customer: customer.id,
|
|
||||||
return_url: `${process.env.FRONTEND_URL || 'https://agenticgovernance.digital'}/koha.html`,
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`[KOHA] Customer portal session created for ${email}`);
|
|
||||||
|
|
||||||
res.status(200).json({
|
|
||||||
success: true,
|
|
||||||
data: {
|
|
||||||
url: session.url
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Create portal session error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: error.message || 'Failed to create portal session'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
@ -1,447 +0,0 @@
|
||||||
/**
|
|
||||||
* Media Inquiry Controller
|
|
||||||
* Press/media inquiry submission and AI triage
|
|
||||||
*/
|
|
||||||
|
|
||||||
const MediaInquiry = require('../models/MediaInquiry.model');
|
|
||||||
const ModerationQueue = require('../models/ModerationQueue.model');
|
|
||||||
const GovernanceLog = require('../models/GovernanceLog.model');
|
|
||||||
const BoundaryEnforcer = require('../services/BoundaryEnforcer.service');
|
|
||||||
const MediaTriageService = require('../services/MediaTriage.service');
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Submit media inquiry (public)
|
|
||||||
* POST /api/media/inquiries
|
|
||||||
*
|
|
||||||
* Phase 1: Manual triage (no AI)
|
|
||||||
* Phase 2: Add AI triage with claudeAPI.triageMediaInquiry()
|
|
||||||
*/
|
|
||||||
async function submitInquiry(req, res) {
|
|
||||||
try {
|
|
||||||
const { contact, inquiry } = req.body;
|
|
||||||
|
|
||||||
// Validate required fields
|
|
||||||
if (!contact?.name || !contact?.email || !contact?.outlet) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'Missing required contact information'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!inquiry?.subject || !inquiry?.message) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'Missing required inquiry information'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Media inquiry submitted: ${contact.outlet} - ${inquiry.subject}`);
|
|
||||||
|
|
||||||
// Create inquiry (Phase 1: no AI triage yet)
|
|
||||||
const mediaInquiry = await MediaInquiry.create({
|
|
||||||
contact,
|
|
||||||
inquiry,
|
|
||||||
status: 'new',
|
|
||||||
ai_triage: {
|
|
||||||
urgency: 'medium', // Default, will be AI-assessed in Phase 2
|
|
||||||
topic_sensitivity: 'standard',
|
|
||||||
involves_values: false
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Add to moderation queue for human review
|
|
||||||
await ModerationQueue.create({
|
|
||||||
type: 'MEDIA_INQUIRY',
|
|
||||||
reference_collection: 'media_inquiries',
|
|
||||||
reference_id: mediaInquiry._id,
|
|
||||||
quadrant: 'OPERATIONAL',
|
|
||||||
data: {
|
|
||||||
contact,
|
|
||||||
inquiry
|
|
||||||
},
|
|
||||||
priority: 'medium',
|
|
||||||
status: 'PENDING_APPROVAL',
|
|
||||||
requires_human_approval: true,
|
|
||||||
human_required_reason: 'All media inquiries require human review and response'
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`Media inquiry created: ${mediaInquiry._id}`);
|
|
||||||
|
|
||||||
res.status(201).json({
|
|
||||||
success: true,
|
|
||||||
message: 'Thank you for your inquiry. We will review and respond shortly.',
|
|
||||||
inquiry_id: mediaInquiry._id,
|
|
||||||
governance: {
|
|
||||||
human_review: true,
|
|
||||||
note: 'All media inquiries are reviewed by humans before response'
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Submit inquiry error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred while submitting your inquiry'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List all media inquiries (admin)
|
|
||||||
* GET /api/media/inquiries?status=new
|
|
||||||
*/
|
|
||||||
async function listInquiries(req, res) {
|
|
||||||
try {
|
|
||||||
const { status = 'new', limit = 20, skip = 0 } = req.query;
|
|
||||||
|
|
||||||
const inquiries = await MediaInquiry.findByStatus(status, {
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip)
|
|
||||||
});
|
|
||||||
|
|
||||||
const total = await MediaInquiry.countByStatus(status);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
status,
|
|
||||||
inquiries,
|
|
||||||
pagination: {
|
|
||||||
total,
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip),
|
|
||||||
hasMore: parseInt(skip) + inquiries.length < total
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('List inquiries error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List urgent media inquiries (admin)
|
|
||||||
* GET /api/media/inquiries/urgent
|
|
||||||
*/
|
|
||||||
async function listUrgentInquiries(req, res) {
|
|
||||||
try {
|
|
||||||
const { limit = 10 } = req.query;
|
|
||||||
|
|
||||||
const inquiries = await MediaInquiry.findUrgent({
|
|
||||||
limit: parseInt(limit)
|
|
||||||
});
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
count: inquiries.length,
|
|
||||||
inquiries
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('List urgent inquiries error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get media inquiry by ID (admin)
|
|
||||||
* GET /api/media/inquiries/:id
|
|
||||||
*/
|
|
||||||
async function getInquiry(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
|
|
||||||
const inquiry = await MediaInquiry.findById(id);
|
|
||||||
|
|
||||||
if (!inquiry) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Media inquiry not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
inquiry
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get inquiry error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Assign inquiry to user (admin)
|
|
||||||
* POST /api/media/inquiries/:id/assign
|
|
||||||
*/
|
|
||||||
async function assignInquiry(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
const { user_id } = req.body;
|
|
||||||
|
|
||||||
const userId = user_id || req.user._id;
|
|
||||||
|
|
||||||
const success = await MediaInquiry.assign(id, userId);
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Media inquiry not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Media inquiry ${id} assigned to ${userId} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Inquiry assigned successfully'
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Assign inquiry error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Respond to inquiry (admin)
|
|
||||||
* POST /api/media/inquiries/:id/respond
|
|
||||||
*/
|
|
||||||
async function respondToInquiry(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
const { content } = req.body;
|
|
||||||
|
|
||||||
if (!content) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'Response content is required'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const inquiry = await MediaInquiry.findById(id);
|
|
||||||
|
|
||||||
if (!inquiry) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Media inquiry not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const success = await MediaInquiry.respond(id, {
|
|
||||||
content,
|
|
||||||
responder: req.user.email
|
|
||||||
});
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
return res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'Failed to update inquiry'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Media inquiry ${id} responded to by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Response recorded successfully',
|
|
||||||
note: 'Remember to send actual email to media contact separately'
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Respond to inquiry error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete media inquiry (admin)
|
|
||||||
* DELETE /api/media/inquiries/:id
|
|
||||||
*/
|
|
||||||
async function deleteInquiry(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
|
|
||||||
const success = await MediaInquiry.delete(id);
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Media inquiry not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Media inquiry deleted: ${id} by ${req.user.email}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Inquiry deleted successfully'
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Delete inquiry error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'An error occurred'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Run AI triage on inquiry (admin)
|
|
||||||
* POST /api/media/inquiries/:id/triage
|
|
||||||
*
|
|
||||||
* Demonstrates Tractatus dogfooding: AI assists, human decides
|
|
||||||
*/
|
|
||||||
async function triageInquiry(req, res) {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
|
|
||||||
const inquiry = await MediaInquiry.findById(id);
|
|
||||||
|
|
||||||
if (!inquiry) {
|
|
||||||
return res.status(404).json({
|
|
||||||
error: 'Not Found',
|
|
||||||
message: 'Media inquiry not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Running AI triage on inquiry ${id}`);
|
|
||||||
|
|
||||||
// Run AI triage (MediaTriage service handles all analysis)
|
|
||||||
const triageResult = await MediaTriageService.triageInquiry(inquiry);
|
|
||||||
|
|
||||||
// Update inquiry with triage results
|
|
||||||
await MediaInquiry.update(id, {
|
|
||||||
'ai_triage.urgency': triageResult.urgency,
|
|
||||||
'ai_triage.urgency_score': triageResult.urgency_score,
|
|
||||||
'ai_triage.urgency_reasoning': triageResult.urgency_reasoning,
|
|
||||||
'ai_triage.topic_sensitivity': triageResult.topic_sensitivity,
|
|
||||||
'ai_triage.sensitivity_reasoning': triageResult.sensitivity_reasoning,
|
|
||||||
'ai_triage.involves_values': triageResult.involves_values,
|
|
||||||
'ai_triage.values_reasoning': triageResult.values_reasoning,
|
|
||||||
'ai_triage.boundary_enforcement': triageResult.boundary_enforcement,
|
|
||||||
'ai_triage.suggested_response_time': triageResult.suggested_response_time,
|
|
||||||
'ai_triage.suggested_talking_points': triageResult.suggested_talking_points,
|
|
||||||
'ai_triage.draft_response': triageResult.draft_response,
|
|
||||||
'ai_triage.draft_response_reasoning': triageResult.draft_response_reasoning,
|
|
||||||
'ai_triage.triaged_at': triageResult.triaged_at,
|
|
||||||
'ai_triage.ai_model': triageResult.ai_model,
|
|
||||||
status: 'triaged'
|
|
||||||
});
|
|
||||||
|
|
||||||
// Log governance action
|
|
||||||
await GovernanceLog.create({
|
|
||||||
action: 'AI_TRIAGE',
|
|
||||||
entity_type: 'media_inquiry',
|
|
||||||
entity_id: id,
|
|
||||||
actor: req.user.email,
|
|
||||||
quadrant: triageResult.involves_values ? 'STRATEGIC' : 'OPERATIONAL',
|
|
||||||
tractatus_component: 'BoundaryEnforcer',
|
|
||||||
reasoning: triageResult.values_reasoning,
|
|
||||||
outcome: 'success',
|
|
||||||
metadata: {
|
|
||||||
urgency: triageResult.urgency,
|
|
||||||
urgency_score: triageResult.urgency_score,
|
|
||||||
involves_values: triageResult.involves_values,
|
|
||||||
boundary_enforced: triageResult.involves_values,
|
|
||||||
human_approval_required: true
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`AI triage complete for inquiry ${id}: urgency=${triageResult.urgency}, values=${triageResult.involves_values}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'AI triage completed',
|
|
||||||
triage: triageResult,
|
|
||||||
governance: {
|
|
||||||
human_approval_required: true,
|
|
||||||
boundary_enforcer_active: triageResult.involves_values,
|
|
||||||
transparency_note: 'All AI reasoning is visible for human review'
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Triage inquiry error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'AI triage failed',
|
|
||||||
details: error.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get triage statistics for public transparency
|
|
||||||
* GET /api/media/triage-stats
|
|
||||||
*/
|
|
||||||
async function getTriageStats(req, res) {
|
|
||||||
try {
|
|
||||||
// Get all triaged inquiries (public stats, no sensitive data)
|
|
||||||
const { getCollection } = require('../utils/db.util');
|
|
||||||
const collection = await getCollection('media_inquiries');
|
|
||||||
|
|
||||||
const inquiries = await collection.find({
|
|
||||||
'ai_triage.triaged_at': { $exists: true }
|
|
||||||
}).toArray();
|
|
||||||
|
|
||||||
const stats = await MediaTriageService.getTriageStats(inquiries);
|
|
||||||
|
|
||||||
// Add transparency metrics
|
|
||||||
const transparencyMetrics = {
|
|
||||||
...stats,
|
|
||||||
human_review_rate: '100%', // All inquiries require human review
|
|
||||||
ai_auto_response_rate: '0%', // No auto-responses allowed
|
|
||||||
boundary_enforcement_active: stats.boundary_enforcements > 0,
|
|
||||||
framework_compliance: {
|
|
||||||
human_approval_required: true,
|
|
||||||
ai_reasoning_transparent: true,
|
|
||||||
values_decisions_escalated: true
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
period: 'all_time',
|
|
||||||
statistics: transparencyMetrics,
|
|
||||||
note: 'All media inquiries require human review before response. AI assists with triage only.'
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Get triage stats error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'Failed to retrieve statistics'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
submitInquiry,
|
|
||||||
listInquiries,
|
|
||||||
listUrgentInquiries,
|
|
||||||
getInquiry,
|
|
||||||
assignInquiry,
|
|
||||||
respondToInquiry,
|
|
||||||
deleteInquiry,
|
|
||||||
triageInquiry,
|
|
||||||
getTriageStats
|
|
||||||
};
|
|
||||||
|
|
@ -1,309 +0,0 @@
|
||||||
/**
|
|
||||||
* Newsletter Controller
|
|
||||||
* Handles newsletter subscriptions and management
|
|
||||||
*/
|
|
||||||
|
|
||||||
const NewsletterSubscription = require('../models/NewsletterSubscription.model');
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Subscribe to newsletter (public)
|
|
||||||
* POST /api/newsletter/subscribe
|
|
||||||
*/
|
|
||||||
exports.subscribe = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const { email, name, source, interests } = req.body;
|
|
||||||
|
|
||||||
// Validate email
|
|
||||||
if (!email || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Valid email address is required'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Capture metadata
|
|
||||||
const metadata = {
|
|
||||||
ip_address: req.ip || req.connection.remoteAddress,
|
|
||||||
user_agent: req.get('user-agent'),
|
|
||||||
referrer: req.get('referer')
|
|
||||||
};
|
|
||||||
|
|
||||||
const subscription = await NewsletterSubscription.subscribe({
|
|
||||||
email,
|
|
||||||
name,
|
|
||||||
source: source || 'blog',
|
|
||||||
interests: interests || [],
|
|
||||||
...metadata
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info('Newsletter subscription created', {
|
|
||||||
email: subscription.email,
|
|
||||||
source: subscription.source,
|
|
||||||
verified: subscription.verified
|
|
||||||
});
|
|
||||||
|
|
||||||
// In a real system, send verification email here
|
|
||||||
// For now, we'll auto-verify (remove this in production)
|
|
||||||
await NewsletterSubscription.verify(subscription.verification_token);
|
|
||||||
|
|
||||||
res.status(201).json({
|
|
||||||
success: true,
|
|
||||||
message: 'Successfully subscribed to newsletter',
|
|
||||||
subscription: {
|
|
||||||
email: subscription.email,
|
|
||||||
verified: true
|
|
||||||
}
|
|
||||||
});
|
|
||||||
} catch (subscribeError) {
|
|
||||||
console.error('Newsletter subscription error:', subscribeError);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to subscribe to newsletter',
|
|
||||||
details: process.env.NODE_ENV === 'development' ? subscribeError.message : undefined
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Verify email subscription
|
|
||||||
* GET /api/newsletter/verify/:token
|
|
||||||
*/
|
|
||||||
exports.verify = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const { token } = req.params;
|
|
||||||
|
|
||||||
const verified = await NewsletterSubscription.verify(token);
|
|
||||||
|
|
||||||
if (!verified) {
|
|
||||||
return res.status(404).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Invalid or expired verification token'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Email verified successfully'
|
|
||||||
});
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Newsletter verification error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to verify email'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Unsubscribe from newsletter (public)
|
|
||||||
* POST /api/newsletter/unsubscribe
|
|
||||||
*/
|
|
||||||
exports.unsubscribe = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const { email, token } = req.body;
|
|
||||||
|
|
||||||
if (!email && !token) {
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Email or token is required'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const unsubscribed = await NewsletterSubscription.unsubscribe(email, token);
|
|
||||||
|
|
||||||
if (!unsubscribed) {
|
|
||||||
return res.status(404).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Subscription not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info('Newsletter unsubscribe', { email: email || 'via token' });
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Successfully unsubscribed from newsletter'
|
|
||||||
});
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Newsletter unsubscribe error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to unsubscribe'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update subscription preferences (public)
|
|
||||||
* PUT /api/newsletter/preferences
|
|
||||||
*/
|
|
||||||
exports.updatePreferences = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const { email, name, interests } = req.body;
|
|
||||||
|
|
||||||
if (!email) {
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Email is required'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const updated = await NewsletterSubscription.updatePreferences(email, {
|
|
||||||
name,
|
|
||||||
interests
|
|
||||||
});
|
|
||||||
|
|
||||||
if (!updated) {
|
|
||||||
return res.status(404).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Active subscription not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Preferences updated successfully'
|
|
||||||
});
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Newsletter preferences update error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to update preferences'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get newsletter statistics (admin only)
|
|
||||||
* GET /api/admin/newsletter/stats
|
|
||||||
*/
|
|
||||||
exports.getStats = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const stats = await NewsletterSubscription.getStats();
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
stats
|
|
||||||
});
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Newsletter stats error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to retrieve statistics'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List all subscriptions (admin only)
|
|
||||||
* GET /api/admin/newsletter/subscriptions
|
|
||||||
*/
|
|
||||||
exports.listSubscriptions = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const {
|
|
||||||
limit = 100,
|
|
||||||
skip = 0,
|
|
||||||
active = 'true',
|
|
||||||
verified = null,
|
|
||||||
source = null
|
|
||||||
} = req.query;
|
|
||||||
|
|
||||||
const options = {
|
|
||||||
limit: parseInt(limit),
|
|
||||||
skip: parseInt(skip),
|
|
||||||
active: active === 'true',
|
|
||||||
verified: verified === null ? null : verified === 'true',
|
|
||||||
source: source || null
|
|
||||||
};
|
|
||||||
|
|
||||||
const subscriptions = await NewsletterSubscription.list(options);
|
|
||||||
const total = await NewsletterSubscription.count({
|
|
||||||
active: options.active,
|
|
||||||
...(options.verified !== null && { verified: options.verified }),
|
|
||||||
...(options.source && { source: options.source })
|
|
||||||
});
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
subscriptions,
|
|
||||||
pagination: {
|
|
||||||
total,
|
|
||||||
limit: options.limit,
|
|
||||||
skip: options.skip,
|
|
||||||
has_more: skip + subscriptions.length < total
|
|
||||||
}
|
|
||||||
});
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Newsletter list error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to list subscriptions'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Export subscriptions as CSV (admin only)
|
|
||||||
* GET /api/admin/newsletter/export
|
|
||||||
*/
|
|
||||||
exports.exportSubscriptions = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const { active = 'true' } = req.query;
|
|
||||||
|
|
||||||
const subscriptions = await NewsletterSubscription.list({
|
|
||||||
active: active === 'true',
|
|
||||||
limit: 10000
|
|
||||||
});
|
|
||||||
|
|
||||||
// Generate CSV
|
|
||||||
const csv = [
|
|
||||||
'Email,Name,Source,Verified,Subscribed At',
|
|
||||||
...subscriptions.map(sub =>
|
|
||||||
`${sub.email},"${sub.name || ''}",${sub.source},${sub.verified},${sub.subscribed_at.toISOString()}`
|
|
||||||
)
|
|
||||||
].join('\n');
|
|
||||||
|
|
||||||
res.setHeader('Content-Type', 'text/csv');
|
|
||||||
res.setHeader('Content-Disposition', `attachment; filename="newsletter-subscriptions-${Date.now()}.csv"`);
|
|
||||||
res.send(csv);
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Newsletter export error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to export subscriptions'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete subscription (admin only)
|
|
||||||
* DELETE /api/admin/newsletter/subscriptions/:id
|
|
||||||
*/
|
|
||||||
exports.deleteSubscription = async (req, res) => {
|
|
||||||
try {
|
|
||||||
const { id } = req.params;
|
|
||||||
|
|
||||||
const deleted = await NewsletterSubscription.delete(id);
|
|
||||||
|
|
||||||
if (!deleted) {
|
|
||||||
return res.status(404).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Subscription not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info('Newsletter subscription deleted', { id });
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'Subscription deleted successfully'
|
|
||||||
});
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Newsletter delete error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to delete subscription'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
@ -1,436 +0,0 @@
|
||||||
/**
|
|
||||||
* Variables Controller
|
|
||||||
*
|
|
||||||
* Handles CRUD operations for project-specific variable values.
|
|
||||||
* Variables enable context-aware rendering of governance rules.
|
|
||||||
*
|
|
||||||
* Endpoints:
|
|
||||||
* - GET /api/admin/projects/:projectId/variables - List variables for project
|
|
||||||
* - GET /api/admin/variables/global - Get all unique variable names
|
|
||||||
* - POST /api/admin/projects/:projectId/variables - Create/update variable
|
|
||||||
* - PUT /api/admin/projects/:projectId/variables/:name - Update variable value
|
|
||||||
* - DELETE /api/admin/projects/:projectId/variables/:name - Delete variable
|
|
||||||
*/
|
|
||||||
|
|
||||||
const VariableValue = require('../models/VariableValue.model');
|
|
||||||
const Project = require('../models/Project.model');
|
|
||||||
const VariableSubstitutionService = require('../services/VariableSubstitution.service');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get all variables for a project
|
|
||||||
* @route GET /api/admin/projects/:projectId/variables
|
|
||||||
* @param {string} projectId - Project identifier
|
|
||||||
* @query {string} category - Filter by category (optional)
|
|
||||||
*/
|
|
||||||
async function getProjectVariables(req, res) {
|
|
||||||
try {
|
|
||||||
const { projectId } = req.params;
|
|
||||||
const { category } = req.query;
|
|
||||||
|
|
||||||
// Verify project exists
|
|
||||||
const project = await Project.findByProjectId(projectId);
|
|
||||||
if (!project) {
|
|
||||||
return res.status(404).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Project not found',
|
|
||||||
message: `No project found with ID: ${projectId}`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Fetch variables
|
|
||||||
const variables = await VariableValue.findByProject(projectId, { category });
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
projectId,
|
|
||||||
projectName: project.name,
|
|
||||||
variables,
|
|
||||||
total: variables.length
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error fetching project variables:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to fetch variables',
|
|
||||||
message: error.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get all unique variable names across all rules
|
|
||||||
* @route GET /api/admin/variables/global
|
|
||||||
*/
|
|
||||||
async function getGlobalVariables(req, res) {
|
|
||||||
try {
|
|
||||||
// Get all unique variables from rules
|
|
||||||
const ruleVariables = await VariableSubstitutionService.getAllVariables();
|
|
||||||
|
|
||||||
// Get all unique variables currently defined
|
|
||||||
const definedVariables = await VariableValue.getAllVariableNames();
|
|
||||||
|
|
||||||
// Merge and add metadata
|
|
||||||
const variableMap = new Map();
|
|
||||||
|
|
||||||
// Add variables from rules
|
|
||||||
ruleVariables.forEach(v => {
|
|
||||||
variableMap.set(v.name, {
|
|
||||||
name: v.name,
|
|
||||||
usageCount: v.usageCount,
|
|
||||||
rules: v.rules,
|
|
||||||
isDefined: definedVariables.includes(v.name)
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
// Add variables that are defined but not used in any rules
|
|
||||||
definedVariables.forEach(name => {
|
|
||||||
if (!variableMap.has(name)) {
|
|
||||||
variableMap.set(name, {
|
|
||||||
name,
|
|
||||||
usageCount: 0,
|
|
||||||
rules: [],
|
|
||||||
isDefined: true
|
|
||||||
});
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
const allVariables = Array.from(variableMap.values())
|
|
||||||
.sort((a, b) => b.usageCount - a.usageCount);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
variables: allVariables,
|
|
||||||
total: allVariables.length,
|
|
||||||
statistics: {
|
|
||||||
totalVariables: allVariables.length,
|
|
||||||
usedInRules: ruleVariables.length,
|
|
||||||
definedButUnused: allVariables.filter(v => v.usageCount === 0).length
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error fetching global variables:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to fetch global variables',
|
|
||||||
message: error.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create or update variable value for project (upsert)
|
|
||||||
* @route POST /api/admin/projects/:projectId/variables
|
|
||||||
* @param {string} projectId - Project identifier
|
|
||||||
* @body {string} variableName - Variable name (UPPER_SNAKE_CASE)
|
|
||||||
* @body {string} value - Variable value
|
|
||||||
* @body {string} description - Description (optional)
|
|
||||||
* @body {string} category - Category (optional)
|
|
||||||
* @body {string} dataType - Data type (optional)
|
|
||||||
*/
|
|
||||||
async function createOrUpdateVariable(req, res) {
|
|
||||||
try {
|
|
||||||
const { projectId } = req.params;
|
|
||||||
const { variableName, value, description, category, dataType, validationRules } = req.body;
|
|
||||||
|
|
||||||
// Verify project exists
|
|
||||||
const project = await Project.findByProjectId(projectId);
|
|
||||||
if (!project) {
|
|
||||||
return res.status(404).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Project not found',
|
|
||||||
message: `No project found with ID: ${projectId}`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Validate variable name format
|
|
||||||
if (!/^[A-Z][A-Z0-9_]*$/.test(variableName)) {
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Invalid variable name',
|
|
||||||
message: 'Variable name must be UPPER_SNAKE_CASE (e.g., DB_NAME, API_KEY_2)'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Upsert variable
|
|
||||||
const variable = await VariableValue.upsertValue(projectId, variableName, {
|
|
||||||
value,
|
|
||||||
description,
|
|
||||||
category,
|
|
||||||
dataType,
|
|
||||||
validationRules,
|
|
||||||
updatedBy: req.user?.email || 'system'
|
|
||||||
});
|
|
||||||
|
|
||||||
// Validate the value against rules
|
|
||||||
const validation = variable.validateValue();
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
variable: variable.toObject(),
|
|
||||||
validation,
|
|
||||||
message: `Variable "${variableName}" ${variable.isNew ? 'created' : 'updated'} successfully for project "${project.name}"`
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error creating/updating variable:', error);
|
|
||||||
|
|
||||||
// Handle validation errors
|
|
||||||
if (error.name === 'ValidationError') {
|
|
||||||
const errors = Object.values(error.errors).map(e => e.message);
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Validation failed',
|
|
||||||
message: errors.join(', '),
|
|
||||||
details: error.errors
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to create/update variable',
|
|
||||||
message: error.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update existing variable value
|
|
||||||
* @route PUT /api/admin/projects/:projectId/variables/:variableName
|
|
||||||
* @param {string} projectId - Project identifier
|
|
||||||
* @param {string} variableName - Variable name
|
|
||||||
* @body {Object} updates - Fields to update
|
|
||||||
*/
|
|
||||||
async function updateVariable(req, res) {
|
|
||||||
try {
|
|
||||||
const { projectId, variableName } = req.params;
|
|
||||||
const updates = req.body;
|
|
||||||
|
|
||||||
// Find existing variable
|
|
||||||
const variable = await VariableValue.findValue(projectId, variableName);
|
|
||||||
|
|
||||||
if (!variable) {
|
|
||||||
return res.status(404).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Variable not found',
|
|
||||||
message: `No variable "${variableName}" found for project "${projectId}"`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Apply updates
|
|
||||||
const allowedFields = ['value', 'description', 'category', 'dataType', 'validationRules'];
|
|
||||||
allowedFields.forEach(field => {
|
|
||||||
if (updates[field] !== undefined) {
|
|
||||||
variable[field] = updates[field];
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
variable.updatedBy = req.user?.email || 'system';
|
|
||||||
await variable.save();
|
|
||||||
|
|
||||||
// Validate the new value
|
|
||||||
const validation = variable.validateValue();
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
variable: variable.toObject(),
|
|
||||||
validation,
|
|
||||||
message: `Variable "${variableName}" updated successfully`
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error updating variable:', error);
|
|
||||||
|
|
||||||
if (error.name === 'ValidationError') {
|
|
||||||
const errors = Object.values(error.errors).map(e => e.message);
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Validation failed',
|
|
||||||
message: errors.join(', '),
|
|
||||||
details: error.errors
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to update variable',
|
|
||||||
message: error.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete variable
|
|
||||||
* @route DELETE /api/admin/projects/:projectId/variables/:variableName
|
|
||||||
* @param {string} projectId - Project identifier
|
|
||||||
* @param {string} variableName - Variable name
|
|
||||||
* @query {boolean} hard - If true, permanently delete; otherwise soft delete
|
|
||||||
*/
|
|
||||||
async function deleteVariable(req, res) {
|
|
||||||
try {
|
|
||||||
const { projectId, variableName } = req.params;
|
|
||||||
const { hard } = req.query;
|
|
||||||
|
|
||||||
const variable = await VariableValue.findValue(projectId, variableName);
|
|
||||||
|
|
||||||
if (!variable) {
|
|
||||||
return res.status(404).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Variable not found',
|
|
||||||
message: `No variable "${variableName}" found for project "${projectId}"`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
if (hard === 'true') {
|
|
||||||
// Hard delete - permanently remove
|
|
||||||
await VariableValue.deleteOne({ projectId, variableName: variableName.toUpperCase() });
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: `Variable "${variableName}" permanently deleted`
|
|
||||||
});
|
|
||||||
} else {
|
|
||||||
// Soft delete - set active to false
|
|
||||||
await variable.deactivate();
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: `Variable "${variableName}" deactivated. Use ?hard=true to permanently delete.`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error deleting variable:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to delete variable',
|
|
||||||
message: error.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Validate project variables (check for missing required variables)
|
|
||||||
* @route GET /api/admin/projects/:projectId/variables/validate
|
|
||||||
* @param {string} projectId - Project identifier
|
|
||||||
*/
|
|
||||||
async function validateProjectVariables(req, res) {
|
|
||||||
try {
|
|
||||||
const { projectId } = req.params;
|
|
||||||
|
|
||||||
// Verify project exists
|
|
||||||
const project = await Project.findByProjectId(projectId);
|
|
||||||
if (!project) {
|
|
||||||
return res.status(404).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Project not found',
|
|
||||||
message: `No project found with ID: ${projectId}`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Validate variables
|
|
||||||
const validation = await VariableSubstitutionService.validateProjectVariables(projectId);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
projectId,
|
|
||||||
projectName: project.name,
|
|
||||||
validation,
|
|
||||||
message: validation.complete
|
|
||||||
? `All required variables are defined for project "${project.name}"`
|
|
||||||
: `Missing ${validation.missing.length} required variable(s) for project "${project.name}"`
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error validating project variables:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to validate variables',
|
|
||||||
message: error.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Batch create/update variables from array
|
|
||||||
* @route POST /api/admin/projects/:projectId/variables/batch
|
|
||||||
* @param {string} projectId - Project identifier
|
|
||||||
* @body {Array} variables - Array of variable objects
|
|
||||||
*/
|
|
||||||
async function batchUpsertVariables(req, res) {
|
|
||||||
try {
|
|
||||||
const { projectId } = req.params;
|
|
||||||
const { variables } = req.body;
|
|
||||||
|
|
||||||
if (!Array.isArray(variables)) {
|
|
||||||
return res.status(400).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Invalid request',
|
|
||||||
message: 'variables must be an array'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Verify project exists
|
|
||||||
const project = await Project.findByProjectId(projectId);
|
|
||||||
if (!project) {
|
|
||||||
return res.status(404).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Project not found',
|
|
||||||
message: `No project found with ID: ${projectId}`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const results = {
|
|
||||||
created: [],
|
|
||||||
updated: [],
|
|
||||||
failed: []
|
|
||||||
};
|
|
||||||
|
|
||||||
// Process each variable
|
|
||||||
for (const varData of variables) {
|
|
||||||
try {
|
|
||||||
const variable = await VariableValue.upsertValue(projectId, varData.variableName, {
|
|
||||||
...varData,
|
|
||||||
updatedBy: req.user?.email || 'system'
|
|
||||||
});
|
|
||||||
|
|
||||||
const action = variable.isNew ? 'created' : 'updated';
|
|
||||||
results[action].push({
|
|
||||||
variableName: varData.variableName,
|
|
||||||
value: varData.value
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
results.failed.push({
|
|
||||||
variableName: varData.variableName,
|
|
||||||
error: error.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
results,
|
|
||||||
message: `Batch operation complete: ${results.created.length} created, ${results.updated.length} updated, ${results.failed.length} failed`
|
|
||||||
});
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('Error batch upserting variables:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
success: false,
|
|
||||||
error: 'Failed to batch upsert variables',
|
|
||||||
message: error.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
getProjectVariables,
|
|
||||||
getGlobalVariables,
|
|
||||||
createOrUpdateVariable,
|
|
||||||
updateVariable,
|
|
||||||
deleteVariable,
|
|
||||||
validateProjectVariables,
|
|
||||||
batchUpsertVariables
|
|
||||||
};
|
|
||||||
|
|
@ -1,115 +0,0 @@
|
||||||
/**
|
|
||||||
* Authentication Middleware
|
|
||||||
* JWT-based authentication for admin routes
|
|
||||||
*/
|
|
||||||
|
|
||||||
const { verifyToken, extractTokenFromHeader } = require('../utils/jwt.util');
|
|
||||||
const { User } = require('../models');
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Verify JWT token and attach user to request
|
|
||||||
*/
|
|
||||||
async function authenticateToken(req, res, next) {
|
|
||||||
try {
|
|
||||||
const token = extractTokenFromHeader(req.headers.authorization);
|
|
||||||
|
|
||||||
if (!token) {
|
|
||||||
return res.status(401).json({
|
|
||||||
error: 'Authentication required',
|
|
||||||
message: 'No token provided'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Verify token
|
|
||||||
const decoded = verifyToken(token);
|
|
||||||
|
|
||||||
// Get user from database
|
|
||||||
const user = await User.findById(decoded.userId);
|
|
||||||
|
|
||||||
if (!user) {
|
|
||||||
return res.status(401).json({
|
|
||||||
error: 'Authentication failed',
|
|
||||||
message: 'User not found'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!user.active) {
|
|
||||||
return res.status(401).json({
|
|
||||||
error: 'Authentication failed',
|
|
||||||
message: 'User account is inactive'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Attach user to request
|
|
||||||
req.user = user;
|
|
||||||
req.userId = user._id;
|
|
||||||
|
|
||||||
next();
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Authentication error:', error);
|
|
||||||
|
|
||||||
return res.status(401).json({
|
|
||||||
error: 'Authentication failed',
|
|
||||||
message: error.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Check if user has required role
|
|
||||||
*/
|
|
||||||
function requireRole(...roles) {
|
|
||||||
return (req, res, next) => {
|
|
||||||
if (!req.user) {
|
|
||||||
return res.status(401).json({
|
|
||||||
error: 'Authentication required'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!roles.includes(req.user.role)) {
|
|
||||||
return res.status(403).json({
|
|
||||||
error: 'Insufficient permissions',
|
|
||||||
message: `Required role: ${roles.join(' or ')}`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
next();
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Optional authentication (attach user if token present, continue if not)
|
|
||||||
*/
|
|
||||||
async function optionalAuth(req, res, next) {
|
|
||||||
try {
|
|
||||||
const token = extractTokenFromHeader(req.headers.authorization);
|
|
||||||
|
|
||||||
if (token) {
|
|
||||||
const decoded = verifyToken(token);
|
|
||||||
const user = await User.findById(decoded.userId);
|
|
||||||
|
|
||||||
if (user && user.active) {
|
|
||||||
req.user = user;
|
|
||||||
req.userId = user._id;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} catch (error) {
|
|
||||||
// Silently fail - authentication is optional
|
|
||||||
logger.debug('Optional auth failed:', error.message);
|
|
||||||
}
|
|
||||||
|
|
||||||
next();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Require admin role (convenience function)
|
|
||||||
*/
|
|
||||||
const requireAdmin = requireRole('admin');
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
authenticateToken,
|
|
||||||
requireRole,
|
|
||||||
requireAdmin,
|
|
||||||
optionalAuth
|
|
||||||
};
|
|
||||||
|
|
@ -1,118 +0,0 @@
|
||||||
/**
|
|
||||||
* CSRF Protection Middleware (Modern Approach)
|
|
||||||
*
|
|
||||||
* Uses SameSite cookies + double-submit cookie pattern
|
|
||||||
* Replaces deprecated csurf package
|
|
||||||
*
|
|
||||||
* Reference: OWASP CSRF Prevention Cheat Sheet
|
|
||||||
* https://cheatsheetseries.owasp.org/cheatsheets/Cross-Site_Request_Forgery_Prevention_Cheat_Sheet.html
|
|
||||||
*/
|
|
||||||
|
|
||||||
const crypto = require('crypto');
|
|
||||||
const { logSecurityEvent, getClientIp } = require('../utils/security-logger');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate CSRF token
|
|
||||||
*/
|
|
||||||
function generateCsrfToken() {
|
|
||||||
return crypto.randomBytes(32).toString('hex');
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* CSRF Protection Middleware
|
|
||||||
*
|
|
||||||
* Uses double-submit cookie pattern:
|
|
||||||
* 1. Server sets CSRF token in secure, SameSite cookie
|
|
||||||
* 2. Client must send same token in custom header (X-CSRF-Token)
|
|
||||||
* 3. Server validates cookie matches header
|
|
||||||
*/
|
|
||||||
function csrfProtection(req, res, next) {
|
|
||||||
// Skip GET, HEAD, OPTIONS (safe methods)
|
|
||||||
if (['GET', 'HEAD', 'OPTIONS'].includes(req.method)) {
|
|
||||||
return next();
|
|
||||||
}
|
|
||||||
|
|
||||||
// Get CSRF token from cookie
|
|
||||||
const cookieToken = req.cookies['csrf-token'];
|
|
||||||
|
|
||||||
// Get CSRF token from header
|
|
||||||
const headerToken = req.headers['x-csrf-token'] || req.headers['csrf-token'];
|
|
||||||
|
|
||||||
// Validate tokens exist and match
|
|
||||||
if (!cookieToken || !headerToken || cookieToken !== headerToken) {
|
|
||||||
logSecurityEvent({
|
|
||||||
type: 'csrf_violation',
|
|
||||||
sourceIp: getClientIp(req),
|
|
||||||
userId: req.user?.id,
|
|
||||||
endpoint: req.path,
|
|
||||||
userAgent: req.get('user-agent'),
|
|
||||||
details: {
|
|
||||||
method: req.method,
|
|
||||||
hasCookie: !!cookieToken,
|
|
||||||
hasHeader: !!headerToken,
|
|
||||||
tokensMatch: cookieToken === headerToken
|
|
||||||
},
|
|
||||||
action: 'blocked',
|
|
||||||
severity: 'high'
|
|
||||||
});
|
|
||||||
|
|
||||||
return res.status(403).json({
|
|
||||||
error: 'Forbidden',
|
|
||||||
message: 'Invalid CSRF token',
|
|
||||||
code: 'CSRF_VALIDATION_FAILED'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
next();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Middleware to set CSRF token cookie
|
|
||||||
* Apply this globally or on routes that need CSRF protection
|
|
||||||
*/
|
|
||||||
function setCsrfToken(req, res, next) {
|
|
||||||
// Only set cookie if it doesn't exist
|
|
||||||
if (!req.cookies['csrf-token']) {
|
|
||||||
const token = generateCsrfToken();
|
|
||||||
|
|
||||||
//Check if we're behind a proxy (X-Forwarded-Proto header)
|
|
||||||
const isSecure = req.secure || req.headers['x-forwarded-proto'] === 'https';
|
|
||||||
|
|
||||||
res.cookie('csrf-token', token, {
|
|
||||||
httpOnly: true,
|
|
||||||
secure: isSecure && process.env.NODE_ENV === 'production',
|
|
||||||
sameSite: 'strict',
|
|
||||||
maxAge: 24 * 60 * 60 * 1000 // 24 hours
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
next();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Endpoint to get CSRF token for client-side usage
|
|
||||||
* GET /api/csrf-token
|
|
||||||
*
|
|
||||||
* Returns the CSRF token from the cookie so client can include it in requests
|
|
||||||
*/
|
|
||||||
function getCsrfToken(req, res) {
|
|
||||||
const token = req.cookies['csrf-token'];
|
|
||||||
|
|
||||||
if (!token) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'No CSRF token found. Visit the site first to receive a token.'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
csrfToken: token
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
csrfProtection,
|
|
||||||
setCsrfToken,
|
|
||||||
getCsrfToken,
|
|
||||||
generateCsrfToken
|
|
||||||
};
|
|
||||||
|
|
@ -1,440 +0,0 @@
|
||||||
/**
|
|
||||||
* File Security Middleware (inst_041 Implementation)
|
|
||||||
*
|
|
||||||
* Multi-layer file upload validation:
|
|
||||||
* 1. File type validation (magic number check)
|
|
||||||
* 2. ClamAV malware scanning
|
|
||||||
* 3. Size limits enforcement
|
|
||||||
* 4. Quarantine system for suspicious files
|
|
||||||
* 5. Comprehensive security logging
|
|
||||||
*
|
|
||||||
* Reference: docs/plans/security-implementation-roadmap.md Phase 2
|
|
||||||
*/
|
|
||||||
|
|
||||||
const path = require('path');
|
|
||||||
const fs = require('fs').promises;
|
|
||||||
const { exec } = require('child_process');
|
|
||||||
const { promisify } = require('util');
|
|
||||||
const multer = require('multer');
|
|
||||||
const { logSecurityEvent, getClientIp } = require('../utils/security-logger');
|
|
||||||
|
|
||||||
const execAsync = promisify(exec);
|
|
||||||
|
|
||||||
// Configuration
|
|
||||||
const UPLOAD_DIR = process.env.UPLOAD_DIR || '/tmp/tractatus-uploads';
|
|
||||||
const QUARANTINE_DIR = process.env.QUARANTINE_DIR ||
|
|
||||||
(process.env.HOME ? `${process.env.HOME}/var/quarantine/tractatus` : '/var/quarantine/tractatus');
|
|
||||||
const MAX_FILE_SIZE = {
|
|
||||||
document: 10 * 1024 * 1024, // 10MB
|
|
||||||
media: 50 * 1024 * 1024, // 50MB
|
|
||||||
default: 5 * 1024 * 1024 // 5MB
|
|
||||||
};
|
|
||||||
|
|
||||||
// Allowed MIME types (whitelist approach)
|
|
||||||
const ALLOWED_MIME_TYPES = {
|
|
||||||
document: [
|
|
||||||
'application/pdf',
|
|
||||||
'application/msword',
|
|
||||||
'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
|
|
||||||
'text/plain',
|
|
||||||
'text/markdown'
|
|
||||||
],
|
|
||||||
media: [
|
|
||||||
'image/jpeg',
|
|
||||||
'image/png',
|
|
||||||
'image/gif',
|
|
||||||
'image/webp',
|
|
||||||
'video/mp4',
|
|
||||||
'video/webm'
|
|
||||||
]
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Ensure upload and quarantine directories exist
|
|
||||||
*/
|
|
||||||
async function ensureDirectories() {
|
|
||||||
try {
|
|
||||||
await fs.mkdir(UPLOAD_DIR, { recursive: true, mode: 0o750 });
|
|
||||||
await fs.mkdir(QUARANTINE_DIR, { recursive: true, mode: 0o750 });
|
|
||||||
} catch (error) {
|
|
||||||
console.error('[FILE SECURITY] Failed to create directories:', error.message);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Initialize directories on module load
|
|
||||||
ensureDirectories();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Validate file type using magic number (file command)
|
|
||||||
* Prevents MIME type spoofing
|
|
||||||
*/
|
|
||||||
async function validateFileType(filePath, expectedMimeType) {
|
|
||||||
try {
|
|
||||||
const { stdout } = await execAsync(`file --mime-type -b "${filePath}"`);
|
|
||||||
const actualMimeType = stdout.trim();
|
|
||||||
|
|
||||||
if (actualMimeType !== expectedMimeType) {
|
|
||||||
return {
|
|
||||||
valid: false,
|
|
||||||
actualType: actualMimeType,
|
|
||||||
expectedType: expectedMimeType,
|
|
||||||
message: 'File type mismatch (possible MIME spoofing)'
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
return { valid: true, actualType: actualMimeType };
|
|
||||||
} catch (error) {
|
|
||||||
return {
|
|
||||||
valid: false,
|
|
||||||
message: `File type validation failed: ${error.message}`
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Scan file with ClamAV
|
|
||||||
* Tries clamdscan first (fast, requires daemon), falls back to clamscan (slower, no daemon)
|
|
||||||
*/
|
|
||||||
async function scanWithClamAV(filePath) {
|
|
||||||
try {
|
|
||||||
// Try clamdscan first (fast with daemon)
|
|
||||||
await execAsync(`clamdscan --no-summary "${filePath}"`);
|
|
||||||
return { clean: true, threat: null, scanner: 'clamdscan' };
|
|
||||||
} catch (error) {
|
|
||||||
const output = error.stdout || error.stderr || '';
|
|
||||||
|
|
||||||
// Check if virus found
|
|
||||||
if (output.includes('FOUND')) {
|
|
||||||
const match = output.match(/(.+): (.+) FOUND/);
|
|
||||||
const threat = match ? match[2] : 'Unknown threat';
|
|
||||||
return { clean: false, threat, scanner: 'clamdscan' };
|
|
||||||
}
|
|
||||||
|
|
||||||
// If daemon not available, fallback to clamscan
|
|
||||||
if (output.includes('Could not connect')) {
|
|
||||||
console.log('[FILE SECURITY] clamdscan daemon unavailable, using clamscan fallback');
|
|
||||||
try {
|
|
||||||
const { stdout } = await execAsync(`clamscan --no-summary "${filePath}"`);
|
|
||||||
|
|
||||||
if (stdout.includes('FOUND')) {
|
|
||||||
const match = stdout.match(/(.+): (.+) FOUND/);
|
|
||||||
const threat = match ? match[2] : 'Unknown threat';
|
|
||||||
return { clean: false, threat, scanner: 'clamscan' };
|
|
||||||
}
|
|
||||||
|
|
||||||
return { clean: true, threat: null, scanner: 'clamscan' };
|
|
||||||
} catch (clamscanError) {
|
|
||||||
const clamscanOutput = clamscanError.stdout || clamscanError.stderr || '';
|
|
||||||
|
|
||||||
if (clamscanOutput.includes('FOUND')) {
|
|
||||||
const match = clamscanOutput.match(/(.+): (.+) FOUND/);
|
|
||||||
const threat = match ? match[2] : 'Unknown threat';
|
|
||||||
return { clean: false, threat, scanner: 'clamscan' };
|
|
||||||
}
|
|
||||||
|
|
||||||
return {
|
|
||||||
clean: false,
|
|
||||||
threat: null,
|
|
||||||
error: `ClamAV scan failed: ${clamscanError.message}`
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Other error
|
|
||||||
return {
|
|
||||||
clean: false,
|
|
||||||
threat: null,
|
|
||||||
error: `ClamAV scan failed: ${error.message}`
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Move file to quarantine
|
|
||||||
* Handles cross-filesystem moves (copy + delete instead of rename)
|
|
||||||
*/
|
|
||||||
async function quarantineFile(filePath, reason, metadata) {
|
|
||||||
try {
|
|
||||||
const filename = path.basename(filePath);
|
|
||||||
const timestamp = new Date().toISOString().replace(/:/g, '-');
|
|
||||||
const quarantinePath = path.join(QUARANTINE_DIR, `${timestamp}_${filename}`);
|
|
||||||
|
|
||||||
// Ensure quarantine directory exists
|
|
||||||
await ensureDirectories();
|
|
||||||
|
|
||||||
// Use copyFile + unlink to handle cross-filesystem moves
|
|
||||||
// (fs.rename fails with EXDEV when source and dest are on different filesystems)
|
|
||||||
await fs.copyFile(filePath, quarantinePath);
|
|
||||||
await fs.unlink(filePath);
|
|
||||||
|
|
||||||
// Create metadata file
|
|
||||||
const metadataPath = `${quarantinePath}.json`;
|
|
||||||
await fs.writeFile(metadataPath, JSON.stringify({
|
|
||||||
original_path: filePath,
|
|
||||||
original_name: filename,
|
|
||||||
quarantine_reason: reason,
|
|
||||||
quarantine_time: new Date().toISOString(),
|
|
||||||
...metadata
|
|
||||||
}, null, 2));
|
|
||||||
|
|
||||||
console.log(`[FILE SECURITY] File quarantined: ${filename} → ${quarantinePath}`);
|
|
||||||
return quarantinePath;
|
|
||||||
} catch (error) {
|
|
||||||
console.error('[FILE SECURITY] Quarantine failed:', error.message);
|
|
||||||
// Try to delete file if quarantine fails
|
|
||||||
try {
|
|
||||||
await fs.unlink(filePath);
|
|
||||||
} catch (unlinkError) {
|
|
||||||
console.error('[FILE SECURITY] Failed to delete file after quarantine failure:', unlinkError.message);
|
|
||||||
}
|
|
||||||
throw error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* File security validation middleware
|
|
||||||
* Use after multer upload
|
|
||||||
*/
|
|
||||||
function createFileSecurityMiddleware(options = {}) {
|
|
||||||
const {
|
|
||||||
fileType = 'default',
|
|
||||||
allowedMimeTypes = ALLOWED_MIME_TYPES.document
|
|
||||||
} = options;
|
|
||||||
|
|
||||||
return async (req, res, next) => {
|
|
||||||
// Skip if no file uploaded
|
|
||||||
if (!req.file && !req.files) {
|
|
||||||
return next();
|
|
||||||
}
|
|
||||||
|
|
||||||
const files = req.files || [req.file];
|
|
||||||
const clientIp = getClientIp(req);
|
|
||||||
const userId = req.user?.id || 'anonymous';
|
|
||||||
|
|
||||||
try {
|
|
||||||
for (const file of files) {
|
|
||||||
if (!file) continue;
|
|
||||||
|
|
||||||
const filePath = file.path;
|
|
||||||
const filename = file.originalname;
|
|
||||||
|
|
||||||
// 1. Check MIME type is allowed
|
|
||||||
if (!allowedMimeTypes.includes(file.mimetype)) {
|
|
||||||
await fs.unlink(filePath);
|
|
||||||
|
|
||||||
await logSecurityEvent({
|
|
||||||
type: 'file_upload_rejected',
|
|
||||||
sourceIp: clientIp,
|
|
||||||
userId,
|
|
||||||
endpoint: req.path,
|
|
||||||
userAgent: req.get('user-agent'),
|
|
||||||
details: {
|
|
||||||
filename,
|
|
||||||
mime_type: file.mimetype,
|
|
||||||
reason: 'MIME type not allowed'
|
|
||||||
},
|
|
||||||
action: 'rejected',
|
|
||||||
severity: 'medium'
|
|
||||||
});
|
|
||||||
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: `File type ${file.mimetype} is not allowed`,
|
|
||||||
allowed_types: allowedMimeTypes
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// 2. Validate file type with magic number
|
|
||||||
const typeValidation = await validateFileType(filePath, file.mimetype);
|
|
||||||
if (!typeValidation.valid) {
|
|
||||||
await quarantineFile(filePath, 'MIME_TYPE_MISMATCH', {
|
|
||||||
reported_mime: file.mimetype,
|
|
||||||
actual_mime: typeValidation.actualType,
|
|
||||||
user_id: userId,
|
|
||||||
source_ip: clientIp
|
|
||||||
});
|
|
||||||
|
|
||||||
await logSecurityEvent({
|
|
||||||
type: 'file_upload_quarantined',
|
|
||||||
sourceIp: clientIp,
|
|
||||||
userId,
|
|
||||||
endpoint: req.path,
|
|
||||||
userAgent: req.get('user-agent'),
|
|
||||||
details: {
|
|
||||||
filename,
|
|
||||||
reason: 'MIME type mismatch',
|
|
||||||
reported: file.mimetype,
|
|
||||||
actual: typeValidation.actualType
|
|
||||||
},
|
|
||||||
action: 'quarantined',
|
|
||||||
severity: 'high'
|
|
||||||
});
|
|
||||||
|
|
||||||
return res.status(403).json({
|
|
||||||
error: 'Forbidden',
|
|
||||||
message: 'File rejected due to security concerns',
|
|
||||||
code: 'FILE_TYPE_MISMATCH'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// 3. Scan with ClamAV
|
|
||||||
const scanResult = await scanWithClamAV(filePath);
|
|
||||||
|
|
||||||
if (!scanResult.clean) {
|
|
||||||
if (scanResult.threat) {
|
|
||||||
// Malware detected
|
|
||||||
await quarantineFile(filePath, 'MALWARE_DETECTED', {
|
|
||||||
threat: scanResult.threat,
|
|
||||||
user_id: userId,
|
|
||||||
source_ip: clientIp
|
|
||||||
});
|
|
||||||
|
|
||||||
await logSecurityEvent({
|
|
||||||
type: 'malware_detected',
|
|
||||||
sourceIp: clientIp,
|
|
||||||
userId,
|
|
||||||
endpoint: req.path,
|
|
||||||
userAgent: req.get('user-agent'),
|
|
||||||
details: {
|
|
||||||
filename,
|
|
||||||
threat: scanResult.threat,
|
|
||||||
mime_type: file.mimetype
|
|
||||||
},
|
|
||||||
action: 'quarantined',
|
|
||||||
severity: 'critical'
|
|
||||||
});
|
|
||||||
|
|
||||||
return res.status(403).json({
|
|
||||||
error: 'Forbidden',
|
|
||||||
message: 'File rejected: Security threat detected',
|
|
||||||
code: 'MALWARE_DETECTED'
|
|
||||||
});
|
|
||||||
} else {
|
|
||||||
// Scan failed
|
|
||||||
await logSecurityEvent({
|
|
||||||
type: 'file_scan_failed',
|
|
||||||
sourceIp: clientIp,
|
|
||||||
userId,
|
|
||||||
endpoint: req.path,
|
|
||||||
userAgent: req.get('user-agent'),
|
|
||||||
details: {
|
|
||||||
filename,
|
|
||||||
error: scanResult.error
|
|
||||||
},
|
|
||||||
action: 'blocked',
|
|
||||||
severity: 'high'
|
|
||||||
});
|
|
||||||
|
|
||||||
return res.status(503).json({
|
|
||||||
error: 'Service Unavailable',
|
|
||||||
message: 'File security scan unavailable. Please try again later.',
|
|
||||||
code: 'SCAN_FAILED'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// File passed all checks
|
|
||||||
await logSecurityEvent({
|
|
||||||
type: 'file_upload_validated',
|
|
||||||
sourceIp: clientIp,
|
|
||||||
userId,
|
|
||||||
endpoint: req.path,
|
|
||||||
userAgent: req.get('user-agent'),
|
|
||||||
details: {
|
|
||||||
filename,
|
|
||||||
mime_type: file.mimetype,
|
|
||||||
size: file.size
|
|
||||||
},
|
|
||||||
action: 'allowed',
|
|
||||||
severity: 'low'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// All files passed validation
|
|
||||||
next();
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
console.error('[FILE SECURITY] Validation error:', error);
|
|
||||||
|
|
||||||
await logSecurityEvent({
|
|
||||||
type: 'file_validation_error',
|
|
||||||
sourceIp: clientIp,
|
|
||||||
userId,
|
|
||||||
endpoint: req.path,
|
|
||||||
userAgent: req.get('user-agent'),
|
|
||||||
details: {
|
|
||||||
error: error.message
|
|
||||||
},
|
|
||||||
action: 'error',
|
|
||||||
severity: 'high'
|
|
||||||
});
|
|
||||||
|
|
||||||
return res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'File validation failed'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create multer storage configuration
|
|
||||||
*/
|
|
||||||
function createUploadStorage() {
|
|
||||||
return multer.diskStorage({
|
|
||||||
destination: async (req, file, cb) => {
|
|
||||||
await ensureDirectories();
|
|
||||||
cb(null, UPLOAD_DIR);
|
|
||||||
},
|
|
||||||
filename: (req, file, cb) => {
|
|
||||||
const uniqueSuffix = `${Date.now()}-${Math.round(Math.random() * 1E9)}`;
|
|
||||||
const ext = path.extname(file.originalname);
|
|
||||||
const basename = path.basename(file.originalname, ext);
|
|
||||||
const sanitized = basename.replace(/[^a-zA-Z0-9-_]/g, '_');
|
|
||||||
cb(null, `${sanitized}-${uniqueSuffix}${ext}`);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create multer upload middleware with security
|
|
||||||
*/
|
|
||||||
function createSecureUpload(options = {}) {
|
|
||||||
const {
|
|
||||||
fileType = 'default',
|
|
||||||
maxFileSize = MAX_FILE_SIZE.default,
|
|
||||||
allowedMimeTypes = ALLOWED_MIME_TYPES.document,
|
|
||||||
fieldName = 'file'
|
|
||||||
} = options;
|
|
||||||
|
|
||||||
const upload = multer({
|
|
||||||
storage: createUploadStorage(),
|
|
||||||
limits: {
|
|
||||||
fileSize: maxFileSize,
|
|
||||||
files: 1 // Single file upload by default
|
|
||||||
},
|
|
||||||
fileFilter: (req, file, cb) => {
|
|
||||||
// Basic MIME type check (will be verified again with magic number)
|
|
||||||
if (allowedMimeTypes.includes(file.mimetype)) {
|
|
||||||
cb(null, true);
|
|
||||||
} else {
|
|
||||||
cb(new Error(`File type ${file.mimetype} not allowed`));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
return [
|
|
||||||
upload.single(fieldName),
|
|
||||||
createFileSecurityMiddleware({ fileType, allowedMimeTypes })
|
|
||||||
];
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
createFileSecurityMiddleware,
|
|
||||||
createSecureUpload,
|
|
||||||
validateFileType,
|
|
||||||
scanWithClamAV,
|
|
||||||
quarantineFile,
|
|
||||||
ALLOWED_MIME_TYPES,
|
|
||||||
MAX_FILE_SIZE
|
|
||||||
};
|
|
||||||
|
|
@ -1,115 +0,0 @@
|
||||||
/**
|
|
||||||
* Response Sanitization Middleware (inst_013, inst_045)
|
|
||||||
* Prevents information disclosure in error responses
|
|
||||||
*
|
|
||||||
* QUICK WIN: Hide stack traces and sensitive data in production
|
|
||||||
* NEVER expose: stack traces, internal paths, environment details
|
|
||||||
*/
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Sanitize error responses
|
|
||||||
* Production: Generic error messages only
|
|
||||||
* Development: More detailed errors for debugging
|
|
||||||
*/
|
|
||||||
function sanitizeErrorResponse(err, req, res, next) {
|
|
||||||
const isProduction = process.env.NODE_ENV === 'production';
|
|
||||||
|
|
||||||
// Log full error details internally (always)
|
|
||||||
console.error('[ERROR]', {
|
|
||||||
message: err.message,
|
|
||||||
stack: err.stack,
|
|
||||||
path: req.path,
|
|
||||||
method: req.method,
|
|
||||||
ip: req.ip,
|
|
||||||
user: req.user?.id || req.user?.userId,
|
|
||||||
timestamp: new Date().toISOString()
|
|
||||||
});
|
|
||||||
|
|
||||||
// Determine status code
|
|
||||||
const statusCode = err.statusCode || err.status || 500;
|
|
||||||
|
|
||||||
// Generic error messages for common status codes
|
|
||||||
const genericErrors = {
|
|
||||||
400: 'Bad Request',
|
|
||||||
401: 'Unauthorized',
|
|
||||||
403: 'Forbidden',
|
|
||||||
404: 'Not Found',
|
|
||||||
405: 'Method Not Allowed',
|
|
||||||
413: 'Payload Too Large',
|
|
||||||
429: 'Too Many Requests',
|
|
||||||
500: 'Internal Server Error',
|
|
||||||
502: 'Bad Gateway',
|
|
||||||
503: 'Service Unavailable'
|
|
||||||
};
|
|
||||||
|
|
||||||
// Production: Generic error messages only
|
|
||||||
if (isProduction) {
|
|
||||||
return res.status(statusCode).json({
|
|
||||||
error: genericErrors[statusCode] || 'Error',
|
|
||||||
message: err.message || 'An error occurred',
|
|
||||||
// NEVER include in production: stack, file paths, internal details
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Development: More detailed errors (but still sanitized)
|
|
||||||
res.status(statusCode).json({
|
|
||||||
error: err.name || 'Error',
|
|
||||||
message: err.message,
|
|
||||||
statusCode,
|
|
||||||
// Stack trace only in development
|
|
||||||
stack: process.env.NODE_ENV === 'development' ? err.stack : undefined
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Remove sensitive fields from objects
|
|
||||||
* Useful for sanitizing database results before sending to client
|
|
||||||
*/
|
|
||||||
function removeSensitiveFields(data, sensitiveFields = ['password', 'passwordHash', 'apiKey', 'secret', 'token']) {
|
|
||||||
if (Array.isArray(data)) {
|
|
||||||
return data.map(item => removeSensitiveFields(item, sensitiveFields));
|
|
||||||
}
|
|
||||||
|
|
||||||
if (typeof data === 'object' && data !== null) {
|
|
||||||
const sanitized = { ...data };
|
|
||||||
|
|
||||||
// Remove sensitive fields
|
|
||||||
for (const field of sensitiveFields) {
|
|
||||||
delete sanitized[field];
|
|
||||||
}
|
|
||||||
|
|
||||||
// Recursively sanitize nested objects
|
|
||||||
for (const key in sanitized) {
|
|
||||||
if (typeof sanitized[key] === 'object' && sanitized[key] !== null) {
|
|
||||||
sanitized[key] = removeSensitiveFields(sanitized[key], sensitiveFields);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return sanitized;
|
|
||||||
}
|
|
||||||
|
|
||||||
return data;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Middleware to sanitize response data
|
|
||||||
* Apply before sending responses with user/database data
|
|
||||||
*/
|
|
||||||
function sanitizeResponseData(req, res, next) {
|
|
||||||
// Store original json method
|
|
||||||
const originalJson = res.json.bind(res);
|
|
||||||
|
|
||||||
// Override json method to sanitize data
|
|
||||||
res.json = function(data) {
|
|
||||||
const sanitized = removeSensitiveFields(data);
|
|
||||||
return originalJson(sanitized);
|
|
||||||
};
|
|
||||||
|
|
||||||
next();
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
sanitizeErrorResponse,
|
|
||||||
removeSensitiveFields,
|
|
||||||
sanitizeResponseData
|
|
||||||
};
|
|
||||||
|
|
@ -1,163 +0,0 @@
|
||||||
/**
|
|
||||||
* BlogPost Model
|
|
||||||
* AI-curated blog with human oversight
|
|
||||||
*/
|
|
||||||
|
|
||||||
const { ObjectId } = require('mongodb');
|
|
||||||
const { getCollection } = require('../utils/db.util');
|
|
||||||
|
|
||||||
class BlogPost {
|
|
||||||
/**
|
|
||||||
* Create a new blog post
|
|
||||||
*/
|
|
||||||
static async create(data) {
|
|
||||||
const collection = await getCollection('blog_posts');
|
|
||||||
|
|
||||||
const post = {
|
|
||||||
title: data.title,
|
|
||||||
slug: data.slug,
|
|
||||||
author: {
|
|
||||||
type: data.author?.type || 'human', // 'human' or 'ai_curated'
|
|
||||||
name: data.author?.name || 'John Stroh',
|
|
||||||
claude_version: data.author?.claude_version
|
|
||||||
},
|
|
||||||
content: data.content,
|
|
||||||
excerpt: data.excerpt,
|
|
||||||
featured_image: data.featured_image,
|
|
||||||
status: data.status || 'draft', // draft/pending/published/archived
|
|
||||||
moderation: {
|
|
||||||
ai_analysis: data.moderation?.ai_analysis,
|
|
||||||
human_reviewer: data.moderation?.human_reviewer,
|
|
||||||
review_notes: data.moderation?.review_notes,
|
|
||||||
approved_at: data.moderation?.approved_at
|
|
||||||
},
|
|
||||||
tractatus_classification: {
|
|
||||||
quadrant: data.tractatus_classification?.quadrant || 'OPERATIONAL',
|
|
||||||
values_sensitive: data.tractatus_classification?.values_sensitive || false,
|
|
||||||
requires_strategic_review: data.tractatus_classification?.requires_strategic_review || false
|
|
||||||
},
|
|
||||||
published_at: data.published_at,
|
|
||||||
tags: data.tags || [],
|
|
||||||
view_count: 0,
|
|
||||||
engagement: {
|
|
||||||
shares: 0,
|
|
||||||
comments: 0
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
const result = await collection.insertOne(post);
|
|
||||||
return { ...post, _id: result.insertedId };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find post by ID
|
|
||||||
*/
|
|
||||||
static async findById(id) {
|
|
||||||
const collection = await getCollection('blog_posts');
|
|
||||||
return await collection.findOne({ _id: new ObjectId(id) });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find post by slug
|
|
||||||
*/
|
|
||||||
static async findBySlug(slug) {
|
|
||||||
const collection = await getCollection('blog_posts');
|
|
||||||
return await collection.findOne({ slug });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find published posts
|
|
||||||
*/
|
|
||||||
static async findPublished(options = {}) {
|
|
||||||
const collection = await getCollection('blog_posts');
|
|
||||||
const { limit = 10, skip = 0, sort = { published_at: -1 } } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({ status: 'published' })
|
|
||||||
.sort(sort)
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find posts by status
|
|
||||||
*/
|
|
||||||
static async findByStatus(status, options = {}) {
|
|
||||||
const collection = await getCollection('blog_posts');
|
|
||||||
const { limit = 20, skip = 0 } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({ status })
|
|
||||||
.sort({ _id: -1 })
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update post
|
|
||||||
*/
|
|
||||||
static async update(id, updates) {
|
|
||||||
const collection = await getCollection('blog_posts');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{ $set: updates }
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Publish post (change status + set published_at)
|
|
||||||
*/
|
|
||||||
static async publish(id, reviewerId) {
|
|
||||||
const collection = await getCollection('blog_posts');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
status: 'published',
|
|
||||||
published_at: new Date(),
|
|
||||||
'moderation.human_reviewer': reviewerId,
|
|
||||||
'moderation.approved_at': new Date()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Increment view count
|
|
||||||
*/
|
|
||||||
static async incrementViews(id) {
|
|
||||||
const collection = await getCollection('blog_posts');
|
|
||||||
|
|
||||||
await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{ $inc: { view_count: 1 } }
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete post
|
|
||||||
*/
|
|
||||||
static async delete(id) {
|
|
||||||
const collection = await getCollection('blog_posts');
|
|
||||||
const result = await collection.deleteOne({ _id: new ObjectId(id) });
|
|
||||||
return result.deletedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Count posts by status
|
|
||||||
*/
|
|
||||||
static async countByStatus(status) {
|
|
||||||
const collection = await getCollection('blog_posts');
|
|
||||||
return await collection.countDocuments({ status });
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = BlogPost;
|
|
||||||
|
|
@ -1,206 +0,0 @@
|
||||||
/**
|
|
||||||
* CaseSubmission Model
|
|
||||||
* Community case study submissions
|
|
||||||
*/
|
|
||||||
|
|
||||||
const { ObjectId } = require('mongodb');
|
|
||||||
const { getCollection } = require('../utils/db.util');
|
|
||||||
|
|
||||||
class CaseSubmission {
|
|
||||||
/**
|
|
||||||
* Create a new case submission
|
|
||||||
*/
|
|
||||||
static async create(data) {
|
|
||||||
const collection = await getCollection('case_submissions');
|
|
||||||
|
|
||||||
const submission = {
|
|
||||||
submitter: {
|
|
||||||
name: data.submitter.name,
|
|
||||||
email: data.submitter.email,
|
|
||||||
organization: data.submitter.organization,
|
|
||||||
public: data.submitter.public !== undefined ? data.submitter.public : false
|
|
||||||
},
|
|
||||||
case_study: {
|
|
||||||
title: data.case_study.title,
|
|
||||||
description: data.case_study.description,
|
|
||||||
failure_mode: data.case_study.failure_mode,
|
|
||||||
tractatus_applicability: data.case_study.tractatus_applicability,
|
|
||||||
evidence: data.case_study.evidence || [],
|
|
||||||
attachments: data.case_study.attachments || []
|
|
||||||
},
|
|
||||||
ai_review: {
|
|
||||||
relevance_score: data.ai_review?.relevance_score, // 0-1
|
|
||||||
completeness_score: data.ai_review?.completeness_score, // 0-1
|
|
||||||
recommended_category: data.ai_review?.recommended_category,
|
|
||||||
suggested_improvements: data.ai_review?.suggested_improvements || [],
|
|
||||||
claude_analysis: data.ai_review?.claude_analysis
|
|
||||||
},
|
|
||||||
moderation: {
|
|
||||||
status: data.moderation?.status || 'pending', // pending/approved/rejected/needs_info
|
|
||||||
reviewer: data.moderation?.reviewer,
|
|
||||||
review_notes: data.moderation?.review_notes,
|
|
||||||
reviewed_at: data.moderation?.reviewed_at
|
|
||||||
},
|
|
||||||
published_case_id: data.published_case_id,
|
|
||||||
submitted_at: new Date()
|
|
||||||
};
|
|
||||||
|
|
||||||
const result = await collection.insertOne(submission);
|
|
||||||
return { ...submission, _id: result.insertedId };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find submission by ID
|
|
||||||
*/
|
|
||||||
static async findById(id) {
|
|
||||||
const collection = await getCollection('case_submissions');
|
|
||||||
return await collection.findOne({ _id: new ObjectId(id) });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find by moderation status
|
|
||||||
*/
|
|
||||||
static async findByStatus(status, options = {}) {
|
|
||||||
const collection = await getCollection('case_submissions');
|
|
||||||
const { limit = 20, skip = 0 } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({ 'moderation.status': status })
|
|
||||||
.sort({ submitted_at: -1 })
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find high-relevance submissions pending review
|
|
||||||
*/
|
|
||||||
static async findHighRelevance(options = {}) {
|
|
||||||
const collection = await getCollection('case_submissions');
|
|
||||||
const { limit = 10 } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({
|
|
||||||
'moderation.status': 'pending',
|
|
||||||
'ai_review.relevance_score': { $gte: 0.7 }
|
|
||||||
})
|
|
||||||
.sort({ 'ai_review.relevance_score': -1 })
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update submission
|
|
||||||
*/
|
|
||||||
static async update(id, updates) {
|
|
||||||
const collection = await getCollection('case_submissions');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{ $set: updates }
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Approve submission
|
|
||||||
*/
|
|
||||||
static async approve(id, reviewerId, notes = '') {
|
|
||||||
const collection = await getCollection('case_submissions');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
'moderation.status': 'approved',
|
|
||||||
'moderation.reviewer': reviewerId,
|
|
||||||
'moderation.review_notes': notes,
|
|
||||||
'moderation.reviewed_at': new Date()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Reject submission
|
|
||||||
*/
|
|
||||||
static async reject(id, reviewerId, reason) {
|
|
||||||
const collection = await getCollection('case_submissions');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
'moderation.status': 'rejected',
|
|
||||||
'moderation.reviewer': reviewerId,
|
|
||||||
'moderation.review_notes': reason,
|
|
||||||
'moderation.reviewed_at': new Date()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Request more information
|
|
||||||
*/
|
|
||||||
static async requestInfo(id, reviewerId, requestedInfo) {
|
|
||||||
const collection = await getCollection('case_submissions');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
'moderation.status': 'needs_info',
|
|
||||||
'moderation.reviewer': reviewerId,
|
|
||||||
'moderation.review_notes': requestedInfo,
|
|
||||||
'moderation.reviewed_at': new Date()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Link to published case study
|
|
||||||
*/
|
|
||||||
static async linkPublished(id, publishedCaseId) {
|
|
||||||
const collection = await getCollection('case_submissions');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
published_case_id: new ObjectId(publishedCaseId),
|
|
||||||
'moderation.status': 'approved'
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Count by status
|
|
||||||
*/
|
|
||||||
static async countByStatus(status) {
|
|
||||||
const collection = await getCollection('case_submissions');
|
|
||||||
return await collection.countDocuments({ 'moderation.status': status });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete submission
|
|
||||||
*/
|
|
||||||
static async delete(id) {
|
|
||||||
const collection = await getCollection('case_submissions');
|
|
||||||
const result = await collection.deleteOne({ _id: new ObjectId(id) });
|
|
||||||
return result.deletedCount > 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = CaseSubmission;
|
|
||||||
|
|
@ -1,350 +0,0 @@
|
||||||
/**
|
|
||||||
* Document Model
|
|
||||||
* Technical papers, framework documentation, specifications
|
|
||||||
*/
|
|
||||||
|
|
||||||
const { ObjectId } = require('mongodb');
|
|
||||||
const { getCollection } = require('../utils/db.util');
|
|
||||||
|
|
||||||
class Document {
|
|
||||||
/**
|
|
||||||
* Create a new document
|
|
||||||
*
|
|
||||||
* SECURITY: All new documents default to 'internal' visibility to prevent accidental exposure.
|
|
||||||
* Use publish() method to make documents public after review.
|
|
||||||
*/
|
|
||||||
static async create(data) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
|
|
||||||
// SECURITY: Require explicit visibility or default to 'internal' for safety
|
|
||||||
const visibility = data.visibility || 'internal';
|
|
||||||
|
|
||||||
// SECURITY: Validate visibility is a known value
|
|
||||||
const validVisibility = ['public', 'internal', 'confidential', 'archived'];
|
|
||||||
if (!validVisibility.includes(visibility)) {
|
|
||||||
throw new Error(`Invalid visibility: ${visibility}. Must be one of: ${validVisibility.join(', ')}`);
|
|
||||||
}
|
|
||||||
|
|
||||||
// SECURITY: Prevent accidental public uploads - require category for public docs
|
|
||||||
if (visibility === 'public' && (!data.category || data.category === 'none')) {
|
|
||||||
throw new Error('Public documents must have a valid category (not "none")');
|
|
||||||
}
|
|
||||||
|
|
||||||
const document = {
|
|
||||||
title: data.title,
|
|
||||||
slug: data.slug,
|
|
||||||
quadrant: data.quadrant, // STR/OPS/TAC/SYS/STO
|
|
||||||
persistence: data.persistence, // HIGH/MEDIUM/LOW/VARIABLE
|
|
||||||
audience: data.audience || 'general', // technical, general, researcher, implementer, advocate, business, developer
|
|
||||||
visibility, // SECURITY: Defaults to 'internal', explicit required for 'public'
|
|
||||||
category: data.category || 'none', // conceptual, practical, reference, archived, project-tracking, research-proposal, research-topic
|
|
||||||
order: data.order || 999, // Display order (1-999, lower = higher priority)
|
|
||||||
archiveNote: data.archiveNote || null, // Explanation for why document was archived
|
|
||||||
workflow_status: 'draft', // SECURITY: Track publish workflow (draft, review, published)
|
|
||||||
content_html: data.content_html,
|
|
||||||
content_markdown: data.content_markdown,
|
|
||||||
toc: data.toc || [],
|
|
||||||
security_classification: data.security_classification || {
|
|
||||||
contains_credentials: false,
|
|
||||||
contains_financial_info: false,
|
|
||||||
contains_vulnerability_info: false,
|
|
||||||
contains_infrastructure_details: false,
|
|
||||||
requires_authentication: false
|
|
||||||
},
|
|
||||||
metadata: {
|
|
||||||
author: data.metadata?.author || 'John Stroh',
|
|
||||||
date_created: new Date(),
|
|
||||||
date_updated: new Date(),
|
|
||||||
version: data.metadata?.version || '1.0',
|
|
||||||
document_code: data.metadata?.document_code,
|
|
||||||
related_documents: data.metadata?.related_documents || [],
|
|
||||||
tags: data.metadata?.tags || []
|
|
||||||
},
|
|
||||||
translations: data.translations || {},
|
|
||||||
search_index: data.search_index || '',
|
|
||||||
download_formats: data.download_formats || {}
|
|
||||||
};
|
|
||||||
|
|
||||||
const result = await collection.insertOne(document);
|
|
||||||
return { ...document, _id: result.insertedId };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find document by ID
|
|
||||||
*/
|
|
||||||
static async findById(id) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
return await collection.findOne({ _id: new ObjectId(id) });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find document by slug
|
|
||||||
*/
|
|
||||||
static async findBySlug(slug) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
return await collection.findOne({ slug });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find documents by quadrant
|
|
||||||
*/
|
|
||||||
static async findByQuadrant(quadrant, options = {}) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
const { limit = 50, skip = 0, sort = { 'metadata.date_created': -1 }, publicOnly = false } = options;
|
|
||||||
|
|
||||||
const filter = { quadrant };
|
|
||||||
if (publicOnly) {
|
|
||||||
filter.visibility = 'public';
|
|
||||||
}
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find(filter)
|
|
||||||
.sort(sort)
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find documents by audience
|
|
||||||
*/
|
|
||||||
static async findByAudience(audience, options = {}) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
const { limit = 50, skip = 0, sort = { 'metadata.date_created': -1 }, publicOnly = false } = options;
|
|
||||||
|
|
||||||
const filter = { audience };
|
|
||||||
if (publicOnly) {
|
|
||||||
filter.visibility = 'public';
|
|
||||||
}
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find(filter)
|
|
||||||
.sort(sort)
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Search documents
|
|
||||||
*/
|
|
||||||
static async search(query, options = {}) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
const { limit = 20, skip = 0, publicOnly = false } = options;
|
|
||||||
|
|
||||||
const filter = { $text: { $search: query } };
|
|
||||||
if (publicOnly) {
|
|
||||||
filter.visibility = 'public';
|
|
||||||
}
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find(
|
|
||||||
filter,
|
|
||||||
{ score: { $meta: 'textScore' } }
|
|
||||||
)
|
|
||||||
.sort({ score: { $meta: 'textScore' } })
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update document
|
|
||||||
*/
|
|
||||||
static async update(id, updates) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
|
|
||||||
// If updates contains metadata, merge date_updated into it
|
|
||||||
// Otherwise set it as a separate field
|
|
||||||
const updatePayload = { ...updates };
|
|
||||||
if (updatePayload.metadata) {
|
|
||||||
updatePayload.metadata = {
|
|
||||||
...updatePayload.metadata,
|
|
||||||
date_updated: new Date()
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
...updatePayload,
|
|
||||||
...(updatePayload.metadata ? {} : { 'metadata.date_updated': new Date() })
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete document
|
|
||||||
*/
|
|
||||||
static async delete(id) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
const result = await collection.deleteOne({ _id: new ObjectId(id) });
|
|
||||||
return result.deletedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Publish a document (make it public after review)
|
|
||||||
*
|
|
||||||
* SECURITY: Requires explicit category and validates document is ready
|
|
||||||
* World-class UX: Clear workflow states and validation feedback
|
|
||||||
*
|
|
||||||
* @param {string} id - Document ID
|
|
||||||
* @param {object} options - Publish options
|
|
||||||
* @param {string} options.category - Required category for public docs
|
|
||||||
* @param {number} options.order - Display order
|
|
||||||
* @returns {Promise<{success: boolean, message: string, document?: object}>}
|
|
||||||
*/
|
|
||||||
static async publish(id, options = {}) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
|
|
||||||
// Get document
|
|
||||||
const doc = await this.findById(id);
|
|
||||||
if (!doc) {
|
|
||||||
return { success: false, message: 'Document not found' };
|
|
||||||
}
|
|
||||||
|
|
||||||
// Validate document is ready for publishing
|
|
||||||
if (!doc.content_markdown && !doc.content_html) {
|
|
||||||
return { success: false, message: 'Document must have content before publishing' };
|
|
||||||
}
|
|
||||||
|
|
||||||
// SECURITY: Require valid category for public docs
|
|
||||||
const category = options.category || doc.category;
|
|
||||||
if (!category || category === 'none') {
|
|
||||||
return {
|
|
||||||
success: false,
|
|
||||||
message: 'Document must have a valid category before publishing. Available categories: getting-started, technical-reference, research-theory, advanced-topics, case-studies, business-leadership, archives'
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
// Validate category is in allowed list
|
|
||||||
const validCategories = [
|
|
||||||
'getting-started', 'technical-reference', 'research-theory',
|
|
||||||
'advanced-topics', 'case-studies', 'business-leadership', 'archives'
|
|
||||||
];
|
|
||||||
if (!validCategories.includes(category)) {
|
|
||||||
return {
|
|
||||||
success: false,
|
|
||||||
message: `Invalid category: ${category}. Must be one of: ${validCategories.join(', ')}`
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
// Update to public
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
visibility: 'public',
|
|
||||||
category,
|
|
||||||
order: options.order !== undefined ? options.order : doc.order,
|
|
||||||
workflow_status: 'published',
|
|
||||||
'metadata.date_updated': new Date(),
|
|
||||||
'metadata.published_date': new Date(),
|
|
||||||
'metadata.published_by': options.publishedBy || 'admin'
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
if (result.modifiedCount > 0) {
|
|
||||||
const updatedDoc = await this.findById(id);
|
|
||||||
return {
|
|
||||||
success: true,
|
|
||||||
message: `Document published successfully in category: ${category}`,
|
|
||||||
document: updatedDoc
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
return { success: false, message: 'Failed to publish document' };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Unpublish a document (revert to internal)
|
|
||||||
*
|
|
||||||
* @param {string} id - Document ID
|
|
||||||
* @param {string} reason - Reason for unpublishing
|
|
||||||
* @returns {Promise<{success: boolean, message: string}>}
|
|
||||||
*/
|
|
||||||
static async unpublish(id, reason = '') {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
visibility: 'internal',
|
|
||||||
workflow_status: 'draft',
|
|
||||||
'metadata.date_updated': new Date(),
|
|
||||||
'metadata.unpublished_date': new Date(),
|
|
||||||
'metadata.unpublish_reason': reason
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0
|
|
||||||
? { success: true, message: 'Document unpublished successfully' }
|
|
||||||
: { success: false, message: 'Failed to unpublish document' };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List documents by workflow status
|
|
||||||
*
|
|
||||||
* @param {string} status - Workflow status (draft, review, published)
|
|
||||||
* @param {object} options - List options
|
|
||||||
* @returns {Promise<Array>}
|
|
||||||
*/
|
|
||||||
static async listByWorkflowStatus(status, options = {}) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
const { limit = 50, skip = 0, sort = { 'metadata.date_created': -1 } } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({ workflow_status: status })
|
|
||||||
.sort(sort)
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List all documents
|
|
||||||
*/
|
|
||||||
static async list(options = {}) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
const { limit = 50, skip = 0, sort = { order: 1, 'metadata.date_created': -1 }, filter = {} } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find(filter)
|
|
||||||
.sort(sort)
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List archived documents
|
|
||||||
*/
|
|
||||||
static async listArchived(options = {}) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
const { limit = 50, skip = 0, sort = { 'metadata.date_created': -1 } } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({ visibility: 'archived' })
|
|
||||||
.sort(sort)
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Count documents
|
|
||||||
*/
|
|
||||||
static async count(filter = {}) {
|
|
||||||
const collection = await getCollection('documents');
|
|
||||||
return await collection.countDocuments(filter);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = Document;
|
|
||||||
|
|
@ -1,333 +0,0 @@
|
||||||
/**
|
|
||||||
* Donation Model
|
|
||||||
* Koha (donation) system for Tractatus Framework support
|
|
||||||
*
|
|
||||||
* Privacy-first design:
|
|
||||||
* - Anonymous donations by default
|
|
||||||
* - Opt-in public acknowledgement
|
|
||||||
* - Email stored securely for receipts only
|
|
||||||
* - Public transparency metrics
|
|
||||||
*/
|
|
||||||
|
|
||||||
const { ObjectId } = require('mongodb');
|
|
||||||
const { getCollection } = require('../utils/db.util');
|
|
||||||
|
|
||||||
class Donation {
|
|
||||||
/**
|
|
||||||
* Create a new donation record
|
|
||||||
*/
|
|
||||||
static async create(data) {
|
|
||||||
const collection = await getCollection('koha_donations');
|
|
||||||
|
|
||||||
const donation = {
|
|
||||||
// Donation details
|
|
||||||
amount: data.amount, // In cents (in the specified currency)
|
|
||||||
currency: data.currency || 'nzd',
|
|
||||||
amount_nzd: data.amount_nzd || data.amount, // Amount in NZD for transparency calculations
|
|
||||||
exchange_rate_to_nzd: data.exchange_rate_to_nzd || 1.0, // Exchange rate at donation time
|
|
||||||
frequency: data.frequency, // 'monthly' or 'one_time'
|
|
||||||
tier: data.tier, // '5', '15', '50', or 'custom'
|
|
||||||
|
|
||||||
// Donor information (private)
|
|
||||||
donor: {
|
|
||||||
name: data.donor?.name || 'Anonymous',
|
|
||||||
email: data.donor?.email, // Required for receipt, kept private
|
|
||||||
country: data.donor?.country,
|
|
||||||
// Do NOT store full address unless required for tax purposes
|
|
||||||
},
|
|
||||||
|
|
||||||
// Public acknowledgement (opt-in)
|
|
||||||
public_acknowledgement: data.public_acknowledgement || false,
|
|
||||||
public_name: data.public_name || null, // Name to show publicly if opted in
|
|
||||||
|
|
||||||
// Stripe integration
|
|
||||||
stripe: {
|
|
||||||
customer_id: data.stripe?.customer_id,
|
|
||||||
subscription_id: data.stripe?.subscription_id, // For monthly donations
|
|
||||||
payment_intent_id: data.stripe?.payment_intent_id,
|
|
||||||
charge_id: data.stripe?.charge_id,
|
|
||||||
invoice_id: data.stripe?.invoice_id
|
|
||||||
},
|
|
||||||
|
|
||||||
// Status tracking
|
|
||||||
status: data.status || 'pending', // pending, completed, failed, cancelled, refunded
|
|
||||||
payment_date: data.payment_date || new Date(),
|
|
||||||
|
|
||||||
// Receipt tracking
|
|
||||||
receipt: {
|
|
||||||
sent: false,
|
|
||||||
sent_date: null,
|
|
||||||
receipt_number: null
|
|
||||||
},
|
|
||||||
|
|
||||||
// Metadata
|
|
||||||
metadata: {
|
|
||||||
source: data.metadata?.source || 'website', // website, api, manual
|
|
||||||
campaign: data.metadata?.campaign,
|
|
||||||
referrer: data.metadata?.referrer,
|
|
||||||
user_agent: data.metadata?.user_agent,
|
|
||||||
ip_country: data.metadata?.ip_country
|
|
||||||
},
|
|
||||||
|
|
||||||
// Timestamps
|
|
||||||
created_at: new Date(),
|
|
||||||
updated_at: new Date()
|
|
||||||
};
|
|
||||||
|
|
||||||
const result = await collection.insertOne(donation);
|
|
||||||
return { ...donation, _id: result.insertedId };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find donation by ID
|
|
||||||
*/
|
|
||||||
static async findById(id) {
|
|
||||||
const collection = await getCollection('koha_donations');
|
|
||||||
return await collection.findOne({ _id: new ObjectId(id) });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find donation by Stripe subscription ID
|
|
||||||
*/
|
|
||||||
static async findBySubscriptionId(subscriptionId) {
|
|
||||||
const collection = await getCollection('koha_donations');
|
|
||||||
return await collection.findOne({ 'stripe.subscription_id': subscriptionId });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find donation by Stripe payment intent ID
|
|
||||||
*/
|
|
||||||
static async findByPaymentIntentId(paymentIntentId) {
|
|
||||||
const collection = await getCollection('koha_donations');
|
|
||||||
return await collection.findOne({ 'stripe.payment_intent_id': paymentIntentId });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find all donations by donor email (for admin/receipt purposes)
|
|
||||||
*/
|
|
||||||
static async findByDonorEmail(email) {
|
|
||||||
const collection = await getCollection('koha_donations');
|
|
||||||
return await collection.find({ 'donor.email': email }).sort({ created_at: -1 }).toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update donation status
|
|
||||||
*/
|
|
||||||
static async updateStatus(id, status, additionalData = {}) {
|
|
||||||
const collection = await getCollection('koha_donations');
|
|
||||||
|
|
||||||
const updateData = {
|
|
||||||
status,
|
|
||||||
updated_at: new Date(),
|
|
||||||
...additionalData
|
|
||||||
};
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{ $set: updateData }
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Mark receipt as sent
|
|
||||||
*/
|
|
||||||
static async markReceiptSent(id, receiptNumber) {
|
|
||||||
const collection = await getCollection('koha_donations');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
'receipt.sent': true,
|
|
||||||
'receipt.sent_date': new Date(),
|
|
||||||
'receipt.receipt_number': receiptNumber,
|
|
||||||
updated_at: new Date()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Cancel recurring donation (subscription)
|
|
||||||
*/
|
|
||||||
static async cancelSubscription(subscriptionId) {
|
|
||||||
const collection = await getCollection('koha_donations');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ 'stripe.subscription_id': subscriptionId },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
status: 'cancelled',
|
|
||||||
updated_at: new Date()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get transparency metrics (PUBLIC DATA)
|
|
||||||
* Returns aggregated data for public transparency dashboard
|
|
||||||
*/
|
|
||||||
static async getTransparencyMetrics() {
|
|
||||||
const collection = await getCollection('koha_donations');
|
|
||||||
|
|
||||||
// Get all completed donations
|
|
||||||
const completedDonations = await collection.find({
|
|
||||||
status: 'completed'
|
|
||||||
}).toArray();
|
|
||||||
|
|
||||||
// Calculate totals (convert all to NZD for consistent totals)
|
|
||||||
const totalReceived = completedDonations.reduce((sum, d) => {
|
|
||||||
// Use amount_nzd if available, otherwise use amount (backwards compatibility)
|
|
||||||
const nzdAmount = d.amount_nzd || d.amount;
|
|
||||||
return sum + nzdAmount;
|
|
||||||
}, 0) / 100; // Convert cents to dollars
|
|
||||||
|
|
||||||
// Count monthly supporters (active subscriptions)
|
|
||||||
const monthlyDonations = completedDonations.filter(d => d.frequency === 'monthly');
|
|
||||||
const activeSubscriptions = monthlyDonations.filter(d => d.status === 'completed');
|
|
||||||
const monthlySupporters = new Set(activeSubscriptions.map(d => d.stripe.customer_id)).size;
|
|
||||||
|
|
||||||
// Count one-time donations
|
|
||||||
const oneTimeDonations = completedDonations.filter(d => d.frequency === 'one_time').length;
|
|
||||||
|
|
||||||
// Get public acknowledgements (donors who opted in)
|
|
||||||
const publicDonors = completedDonations
|
|
||||||
.filter(d => d.public_acknowledgement && d.public_name)
|
|
||||||
.sort((a, b) => b.created_at - a.created_at)
|
|
||||||
.slice(0, 20) // Latest 20 donors
|
|
||||||
.map(d => ({
|
|
||||||
name: d.public_name,
|
|
||||||
amount: d.amount / 100,
|
|
||||||
currency: d.currency || 'nzd',
|
|
||||||
amount_nzd: (d.amount_nzd || d.amount) / 100,
|
|
||||||
date: d.created_at,
|
|
||||||
frequency: d.frequency
|
|
||||||
}));
|
|
||||||
|
|
||||||
// Calculate monthly recurring revenue (in NZD)
|
|
||||||
const monthlyRevenue = activeSubscriptions.reduce((sum, d) => {
|
|
||||||
const nzdAmount = d.amount_nzd || d.amount;
|
|
||||||
return sum + nzdAmount;
|
|
||||||
}, 0) / 100;
|
|
||||||
|
|
||||||
// Allocation breakdown (as per specification)
|
|
||||||
const allocation = {
|
|
||||||
hosting: 0.30,
|
|
||||||
development: 0.40,
|
|
||||||
research: 0.20,
|
|
||||||
community: 0.10
|
|
||||||
};
|
|
||||||
|
|
||||||
return {
|
|
||||||
total_received: totalReceived,
|
|
||||||
monthly_supporters: monthlySupporters,
|
|
||||||
one_time_donations: oneTimeDonations,
|
|
||||||
monthly_recurring_revenue: monthlyRevenue,
|
|
||||||
allocation: allocation,
|
|
||||||
recent_donors: publicDonors,
|
|
||||||
last_updated: new Date()
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get donation statistics (ADMIN ONLY)
|
|
||||||
*/
|
|
||||||
static async getStatistics(startDate = null, endDate = null) {
|
|
||||||
const collection = await getCollection('koha_donations');
|
|
||||||
|
|
||||||
const query = { status: 'completed' };
|
|
||||||
if (startDate || endDate) {
|
|
||||||
query.created_at = {};
|
|
||||||
if (startDate) query.created_at.$gte = new Date(startDate);
|
|
||||||
if (endDate) query.created_at.$lte = new Date(endDate);
|
|
||||||
}
|
|
||||||
|
|
||||||
const donations = await collection.find(query).toArray();
|
|
||||||
|
|
||||||
return {
|
|
||||||
total_count: donations.length,
|
|
||||||
total_amount: donations.reduce((sum, d) => sum + d.amount, 0) / 100,
|
|
||||||
by_frequency: {
|
|
||||||
monthly: donations.filter(d => d.frequency === 'monthly').length,
|
|
||||||
one_time: donations.filter(d => d.frequency === 'one_time').length
|
|
||||||
},
|
|
||||||
by_tier: {
|
|
||||||
tier_5: donations.filter(d => d.tier === '5').length,
|
|
||||||
tier_15: donations.filter(d => d.tier === '15').length,
|
|
||||||
tier_50: donations.filter(d => d.tier === '50').length,
|
|
||||||
custom: donations.filter(d => d.tier === 'custom').length
|
|
||||||
},
|
|
||||||
average_donation: donations.length > 0
|
|
||||||
? (donations.reduce((sum, d) => sum + d.amount, 0) / donations.length) / 100
|
|
||||||
: 0,
|
|
||||||
public_acknowledgements: donations.filter(d => d.public_acknowledgement).length
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get all donations (ADMIN ONLY - paginated)
|
|
||||||
*/
|
|
||||||
static async findAll(options = {}) {
|
|
||||||
const collection = await getCollection('koha_donations');
|
|
||||||
|
|
||||||
const {
|
|
||||||
page = 1,
|
|
||||||
limit = 20,
|
|
||||||
status = null,
|
|
||||||
frequency = null,
|
|
||||||
sortBy = 'created_at',
|
|
||||||
sortOrder = -1
|
|
||||||
} = options;
|
|
||||||
|
|
||||||
const query = {};
|
|
||||||
if (status) query.status = status;
|
|
||||||
if (frequency) query.frequency = frequency;
|
|
||||||
|
|
||||||
const skip = (page - 1) * limit;
|
|
||||||
|
|
||||||
const donations = await collection
|
|
||||||
.find(query)
|
|
||||||
.sort({ [sortBy]: sortOrder })
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
|
|
||||||
const total = await collection.countDocuments(query);
|
|
||||||
|
|
||||||
return {
|
|
||||||
donations,
|
|
||||||
pagination: {
|
|
||||||
page,
|
|
||||||
limit,
|
|
||||||
total,
|
|
||||||
pages: Math.ceil(total / limit)
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create database indexes for performance
|
|
||||||
*/
|
|
||||||
static async createIndexes() {
|
|
||||||
const collection = await getCollection('koha_donations');
|
|
||||||
|
|
||||||
await collection.createIndex({ status: 1 });
|
|
||||||
await collection.createIndex({ frequency: 1 });
|
|
||||||
await collection.createIndex({ 'stripe.subscription_id': 1 });
|
|
||||||
await collection.createIndex({ 'stripe.payment_intent_id': 1 });
|
|
||||||
await collection.createIndex({ 'donor.email': 1 });
|
|
||||||
await collection.createIndex({ created_at: -1 });
|
|
||||||
await collection.createIndex({ public_acknowledgement: 1 });
|
|
||||||
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = Donation;
|
|
||||||
|
|
@ -1,163 +0,0 @@
|
||||||
/**
|
|
||||||
* MediaInquiry Model
|
|
||||||
* Press/media inquiries with AI triage
|
|
||||||
*/
|
|
||||||
|
|
||||||
const { ObjectId } = require('mongodb');
|
|
||||||
const { getCollection } = require('../utils/db.util');
|
|
||||||
|
|
||||||
class MediaInquiry {
|
|
||||||
/**
|
|
||||||
* Create a new media inquiry
|
|
||||||
*/
|
|
||||||
static async create(data) {
|
|
||||||
const collection = await getCollection('media_inquiries');
|
|
||||||
|
|
||||||
const inquiry = {
|
|
||||||
contact: {
|
|
||||||
name: data.contact.name,
|
|
||||||
email: data.contact.email,
|
|
||||||
outlet: data.contact.outlet,
|
|
||||||
phone: data.contact.phone
|
|
||||||
},
|
|
||||||
inquiry: {
|
|
||||||
subject: data.inquiry.subject,
|
|
||||||
message: data.inquiry.message,
|
|
||||||
deadline: data.inquiry.deadline ? new Date(data.inquiry.deadline) : null,
|
|
||||||
topic_areas: data.inquiry.topic_areas || []
|
|
||||||
},
|
|
||||||
ai_triage: {
|
|
||||||
urgency: data.ai_triage?.urgency, // high/medium/low
|
|
||||||
topic_sensitivity: data.ai_triage?.topic_sensitivity,
|
|
||||||
suggested_response_time: data.ai_triage?.suggested_response_time,
|
|
||||||
involves_values: data.ai_triage?.involves_values || false,
|
|
||||||
claude_summary: data.ai_triage?.claude_summary,
|
|
||||||
suggested_talking_points: data.ai_triage?.suggested_talking_points || []
|
|
||||||
},
|
|
||||||
status: data.status || 'new', // new/triaged/responded/closed
|
|
||||||
assigned_to: data.assigned_to,
|
|
||||||
response: {
|
|
||||||
sent_at: data.response?.sent_at,
|
|
||||||
content: data.response?.content,
|
|
||||||
responder: data.response?.responder
|
|
||||||
},
|
|
||||||
created_at: new Date()
|
|
||||||
};
|
|
||||||
|
|
||||||
const result = await collection.insertOne(inquiry);
|
|
||||||
return { ...inquiry, _id: result.insertedId };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find inquiry by ID
|
|
||||||
*/
|
|
||||||
static async findById(id) {
|
|
||||||
const collection = await getCollection('media_inquiries');
|
|
||||||
return await collection.findOne({ _id: new ObjectId(id) });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find inquiries by status
|
|
||||||
*/
|
|
||||||
static async findByStatus(status, options = {}) {
|
|
||||||
const collection = await getCollection('media_inquiries');
|
|
||||||
const { limit = 20, skip = 0 } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({ status })
|
|
||||||
.sort({ created_at: -1 })
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find high urgency inquiries
|
|
||||||
*/
|
|
||||||
static async findUrgent(options = {}) {
|
|
||||||
const collection = await getCollection('media_inquiries');
|
|
||||||
const { limit = 10 } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({
|
|
||||||
'ai_triage.urgency': 'high',
|
|
||||||
status: { $in: ['new', 'triaged'] }
|
|
||||||
})
|
|
||||||
.sort({ created_at: -1 })
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update inquiry
|
|
||||||
*/
|
|
||||||
static async update(id, updates) {
|
|
||||||
const collection = await getCollection('media_inquiries');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{ $set: updates }
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Assign inquiry to user
|
|
||||||
*/
|
|
||||||
static async assign(id, userId) {
|
|
||||||
const collection = await getCollection('media_inquiries');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
assigned_to: new ObjectId(userId),
|
|
||||||
status: 'triaged'
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Mark as responded
|
|
||||||
*/
|
|
||||||
static async respond(id, responseData) {
|
|
||||||
const collection = await getCollection('media_inquiries');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
status: 'responded',
|
|
||||||
'response.sent_at': new Date(),
|
|
||||||
'response.content': responseData.content,
|
|
||||||
'response.responder': responseData.responder
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Count by status
|
|
||||||
*/
|
|
||||||
static async countByStatus(status) {
|
|
||||||
const collection = await getCollection('media_inquiries');
|
|
||||||
return await collection.countDocuments({ status });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete inquiry
|
|
||||||
*/
|
|
||||||
static async delete(id) {
|
|
||||||
const collection = await getCollection('media_inquiries');
|
|
||||||
const result = await collection.deleteOne({ _id: new ObjectId(id) });
|
|
||||||
return result.deletedCount > 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = MediaInquiry;
|
|
||||||
|
|
@ -1,242 +0,0 @@
|
||||||
/**
|
|
||||||
* ModerationQueue Model
|
|
||||||
* Human oversight queue for AI actions
|
|
||||||
*/
|
|
||||||
|
|
||||||
const { ObjectId } = require('mongodb');
|
|
||||||
const { getCollection } = require('../utils/db.util');
|
|
||||||
|
|
||||||
class ModerationQueue {
|
|
||||||
/**
|
|
||||||
* Add item to moderation queue
|
|
||||||
*/
|
|
||||||
static async create(data) {
|
|
||||||
const collection = await getCollection('moderation_queue');
|
|
||||||
|
|
||||||
const item = {
|
|
||||||
// Type of moderation (NEW flexible field)
|
|
||||||
type: data.type, // BLOG_TOPIC_SUGGESTION/MEDIA_INQUIRY/CASE_STUDY/etc.
|
|
||||||
|
|
||||||
// Reference to specific item (optional - not needed for suggestions)
|
|
||||||
reference_collection: data.reference_collection || null, // blog_posts/media_inquiries/etc.
|
|
||||||
reference_id: data.reference_id ? new ObjectId(data.reference_id) : null,
|
|
||||||
|
|
||||||
// Tractatus quadrant
|
|
||||||
quadrant: data.quadrant || null, // STR/OPS/TAC/SYS/STO
|
|
||||||
|
|
||||||
// AI action data (flexible object)
|
|
||||||
data: data.data || {}, // Flexible data field for AI outputs
|
|
||||||
|
|
||||||
// AI metadata
|
|
||||||
ai_generated: data.ai_generated || false,
|
|
||||||
ai_version: data.ai_version || 'claude-sonnet-4-5',
|
|
||||||
|
|
||||||
// Human oversight
|
|
||||||
requires_human_approval: data.requires_human_approval || true,
|
|
||||||
human_required_reason: data.human_required_reason || 'AI-generated content requires human review',
|
|
||||||
|
|
||||||
// Priority and assignment
|
|
||||||
priority: data.priority || 'medium', // high/medium/low
|
|
||||||
assigned_to: data.assigned_to || null,
|
|
||||||
|
|
||||||
// Status tracking
|
|
||||||
status: data.status || 'PENDING_APPROVAL', // PENDING_APPROVAL/APPROVED/REJECTED
|
|
||||||
created_at: data.created_at || new Date(),
|
|
||||||
created_by: data.created_by ? new ObjectId(data.created_by) : null,
|
|
||||||
reviewed_at: null,
|
|
||||||
|
|
||||||
// Review decision
|
|
||||||
review_decision: {
|
|
||||||
action: null, // approve/reject/modify/escalate
|
|
||||||
notes: null,
|
|
||||||
reviewer: null
|
|
||||||
},
|
|
||||||
|
|
||||||
// Metadata
|
|
||||||
metadata: data.metadata || {},
|
|
||||||
|
|
||||||
// Legacy fields for backwards compatibility
|
|
||||||
item_type: data.item_type || null,
|
|
||||||
item_id: data.item_id ? new ObjectId(data.item_id) : null
|
|
||||||
};
|
|
||||||
|
|
||||||
const result = await collection.insertOne(item);
|
|
||||||
return { ...item, _id: result.insertedId };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find item by ID
|
|
||||||
*/
|
|
||||||
static async findById(id) {
|
|
||||||
const collection = await getCollection('moderation_queue');
|
|
||||||
return await collection.findOne({ _id: new ObjectId(id) });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find pending items
|
|
||||||
*/
|
|
||||||
static async findPending(options = {}) {
|
|
||||||
const collection = await getCollection('moderation_queue');
|
|
||||||
const { limit = 20, skip = 0, priority } = options;
|
|
||||||
|
|
||||||
const filter = { status: 'pending' };
|
|
||||||
if (priority) filter.priority = priority;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find(filter)
|
|
||||||
.sort({
|
|
||||||
priority: -1, // high first
|
|
||||||
created_at: 1 // oldest first
|
|
||||||
})
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find by item type
|
|
||||||
*/
|
|
||||||
static async findByType(itemType, options = {}) {
|
|
||||||
const collection = await getCollection('moderation_queue');
|
|
||||||
const { limit = 20, skip = 0 } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({ item_type: itemType, status: 'pending' })
|
|
||||||
.sort({ created_at: -1 })
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find by quadrant
|
|
||||||
*/
|
|
||||||
static async findByQuadrant(quadrant, options = {}) {
|
|
||||||
const collection = await getCollection('moderation_queue');
|
|
||||||
const { limit = 20, skip = 0 } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({ quadrant, status: 'pending' })
|
|
||||||
.sort({ created_at: -1 })
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Review item (approve/reject/modify/escalate)
|
|
||||||
*/
|
|
||||||
static async review(id, decision) {
|
|
||||||
const collection = await getCollection('moderation_queue');
|
|
||||||
|
|
||||||
// Map action to status
|
|
||||||
const statusMap = {
|
|
||||||
'approve': 'approved',
|
|
||||||
'reject': 'rejected',
|
|
||||||
'escalate': 'escalated'
|
|
||||||
};
|
|
||||||
const status = statusMap[decision.action] || 'reviewed';
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
status: status,
|
|
||||||
reviewed_at: new Date(),
|
|
||||||
'review_decision.action': decision.action,
|
|
||||||
'review_decision.notes': decision.notes,
|
|
||||||
'review_decision.reviewer': decision.reviewer
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Approve item
|
|
||||||
*/
|
|
||||||
static async approve(id, reviewerId, notes = '') {
|
|
||||||
return await this.review(id, {
|
|
||||||
action: 'approve',
|
|
||||||
notes,
|
|
||||||
reviewer: reviewerId
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Reject item
|
|
||||||
*/
|
|
||||||
static async reject(id, reviewerId, notes) {
|
|
||||||
return await this.review(id, {
|
|
||||||
action: 'reject',
|
|
||||||
notes,
|
|
||||||
reviewer: reviewerId
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Escalate to strategic review
|
|
||||||
*/
|
|
||||||
static async escalate(id, reviewerId, reason) {
|
|
||||||
const collection = await getCollection('moderation_queue');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
quadrant: 'STRATEGIC',
|
|
||||||
priority: 'high',
|
|
||||||
human_required_reason: `ESCALATED: ${reason}`,
|
|
||||||
'review_decision.action': 'escalate',
|
|
||||||
'review_decision.notes': reason,
|
|
||||||
'review_decision.reviewer': reviewerId
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Count pending items
|
|
||||||
*/
|
|
||||||
static async countPending(filter = {}) {
|
|
||||||
const collection = await getCollection('moderation_queue');
|
|
||||||
return await collection.countDocuments({
|
|
||||||
...filter,
|
|
||||||
status: 'pending'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get stats by quadrant
|
|
||||||
*/
|
|
||||||
static async getStatsByQuadrant() {
|
|
||||||
const collection = await getCollection('moderation_queue');
|
|
||||||
|
|
||||||
return await collection.aggregate([
|
|
||||||
{ $match: { status: 'pending' } },
|
|
||||||
{
|
|
||||||
$group: {
|
|
||||||
_id: '$quadrant',
|
|
||||||
count: { $sum: 1 },
|
|
||||||
high_priority: {
|
|
||||||
$sum: { $cond: [{ $eq: ['$priority', 'high'] }, 1, 0] }
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
]).toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete item
|
|
||||||
*/
|
|
||||||
static async delete(id) {
|
|
||||||
const collection = await getCollection('moderation_queue');
|
|
||||||
const result = await collection.deleteOne({ _id: new ObjectId(id) });
|
|
||||||
return result.deletedCount > 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = ModerationQueue;
|
|
||||||
|
|
@ -1,235 +0,0 @@
|
||||||
/**
|
|
||||||
* Newsletter Subscription Model
|
|
||||||
* Manages email subscriptions for blog updates and framework news
|
|
||||||
*/
|
|
||||||
|
|
||||||
const { ObjectId } = require('mongodb');
|
|
||||||
const { getCollection } = require('../utils/db.util');
|
|
||||||
|
|
||||||
class NewsletterSubscription {
|
|
||||||
/**
|
|
||||||
* Subscribe a new email address
|
|
||||||
*/
|
|
||||||
static async subscribe(data) {
|
|
||||||
const collection = await getCollection('newsletter_subscriptions');
|
|
||||||
|
|
||||||
// Check if already subscribed
|
|
||||||
const existing = await collection.findOne({
|
|
||||||
email: data.email.toLowerCase()
|
|
||||||
});
|
|
||||||
|
|
||||||
if (existing) {
|
|
||||||
// If previously unsubscribed, reactivate
|
|
||||||
if (!existing.active) {
|
|
||||||
await collection.updateOne(
|
|
||||||
{ _id: existing._id },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
active: true,
|
|
||||||
resubscribed_at: new Date(),
|
|
||||||
updated_at: new Date()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
return { ...existing, active: true };
|
|
||||||
}
|
|
||||||
// Already subscribed and active
|
|
||||||
return existing;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Create new subscription
|
|
||||||
const subscription = {
|
|
||||||
email: data.email.toLowerCase(),
|
|
||||||
name: data.name || null,
|
|
||||||
source: data.source || 'blog', // blog/homepage/docs/etc
|
|
||||||
interests: data.interests || [], // e.g., ['framework-updates', 'case-studies', 'research']
|
|
||||||
verification_token: this._generateToken(),
|
|
||||||
verified: false, // Will be true after email verification
|
|
||||||
active: true,
|
|
||||||
subscribed_at: new Date(),
|
|
||||||
created_at: new Date(),
|
|
||||||
updated_at: new Date(),
|
|
||||||
metadata: {
|
|
||||||
ip_address: data.ip_address || null,
|
|
||||||
user_agent: data.user_agent || null,
|
|
||||||
referrer: data.referrer || null
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
const result = await collection.insertOne(subscription);
|
|
||||||
return { ...subscription, _id: result.insertedId };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Verify email subscription
|
|
||||||
*/
|
|
||||||
static async verify(token) {
|
|
||||||
const collection = await getCollection('newsletter_subscriptions');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ verification_token: token, active: true },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
verified: true,
|
|
||||||
verified_at: new Date(),
|
|
||||||
updated_at: new Date()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Unsubscribe an email address
|
|
||||||
*/
|
|
||||||
static async unsubscribe(email, token = null) {
|
|
||||||
const collection = await getCollection('newsletter_subscriptions');
|
|
||||||
|
|
||||||
const filter = token
|
|
||||||
? { verification_token: token }
|
|
||||||
: { email: email.toLowerCase() };
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
filter,
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
active: false,
|
|
||||||
unsubscribed_at: new Date(),
|
|
||||||
updated_at: new Date()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find subscription by email
|
|
||||||
*/
|
|
||||||
static async findByEmail(email) {
|
|
||||||
const collection = await getCollection('newsletter_subscriptions');
|
|
||||||
return await collection.findOne({ email: email.toLowerCase() });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find subscription by ID
|
|
||||||
*/
|
|
||||||
static async findById(id) {
|
|
||||||
const collection = await getCollection('newsletter_subscriptions');
|
|
||||||
return await collection.findOne({ _id: new ObjectId(id) });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List all subscriptions
|
|
||||||
*/
|
|
||||||
static async list(options = {}) {
|
|
||||||
const collection = await getCollection('newsletter_subscriptions');
|
|
||||||
const {
|
|
||||||
limit = 100,
|
|
||||||
skip = 0,
|
|
||||||
active = true,
|
|
||||||
verified = null,
|
|
||||||
source = null
|
|
||||||
} = options;
|
|
||||||
|
|
||||||
const filter = {};
|
|
||||||
if (active !== null) filter.active = active;
|
|
||||||
if (verified !== null) filter.verified = verified;
|
|
||||||
if (source) filter.source = source;
|
|
||||||
|
|
||||||
const subscriptions = await collection
|
|
||||||
.find(filter)
|
|
||||||
.sort({ created_at: -1 })
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
|
|
||||||
return subscriptions;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Count subscriptions
|
|
||||||
*/
|
|
||||||
static async count(filter = {}) {
|
|
||||||
const collection = await getCollection('newsletter_subscriptions');
|
|
||||||
return await collection.countDocuments(filter);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update subscription preferences
|
|
||||||
*/
|
|
||||||
static async updatePreferences(email, preferences) {
|
|
||||||
const collection = await getCollection('newsletter_subscriptions');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ email: email.toLowerCase(), active: true },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
interests: preferences.interests || [],
|
|
||||||
name: preferences.name || null,
|
|
||||||
updated_at: new Date()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get subscription statistics
|
|
||||||
*/
|
|
||||||
static async getStats() {
|
|
||||||
const collection = await getCollection('newsletter_subscriptions');
|
|
||||||
|
|
||||||
const [
|
|
||||||
totalSubscribers,
|
|
||||||
activeSubscribers,
|
|
||||||
verifiedSubscribers,
|
|
||||||
recentSubscribers
|
|
||||||
] = await Promise.all([
|
|
||||||
collection.countDocuments({}),
|
|
||||||
collection.countDocuments({ active: true }),
|
|
||||||
collection.countDocuments({ active: true, verified: true }),
|
|
||||||
collection.countDocuments({
|
|
||||||
active: true,
|
|
||||||
created_at: { $gte: new Date(Date.now() - 30 * 24 * 60 * 60 * 1000) }
|
|
||||||
})
|
|
||||||
]);
|
|
||||||
|
|
||||||
// Get source breakdown
|
|
||||||
const sourceBreakdown = await collection.aggregate([
|
|
||||||
{ $match: { active: true } },
|
|
||||||
{ $group: { _id: '$source', count: { $sum: 1 } } }
|
|
||||||
]).toArray();
|
|
||||||
|
|
||||||
return {
|
|
||||||
total: totalSubscribers,
|
|
||||||
active: activeSubscribers,
|
|
||||||
verified: verifiedSubscribers,
|
|
||||||
recent_30_days: recentSubscribers,
|
|
||||||
by_source: sourceBreakdown.reduce((acc, item) => {
|
|
||||||
acc[item._id || 'unknown'] = item.count;
|
|
||||||
return acc;
|
|
||||||
}, {})
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete subscription (admin only)
|
|
||||||
*/
|
|
||||||
static async delete(id) {
|
|
||||||
const collection = await getCollection('newsletter_subscriptions');
|
|
||||||
const result = await collection.deleteOne({ _id: new ObjectId(id) });
|
|
||||||
return result.deletedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate verification token
|
|
||||||
*/
|
|
||||||
static _generateToken() {
|
|
||||||
return require('crypto').randomBytes(32).toString('hex');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = NewsletterSubscription;
|
|
||||||
|
|
@ -1,221 +0,0 @@
|
||||||
/**
|
|
||||||
* Resource Model
|
|
||||||
* Curated directory of aligned resources
|
|
||||||
*/
|
|
||||||
|
|
||||||
const { ObjectId } = require('mongodb');
|
|
||||||
const { getCollection } = require('../utils/db.util');
|
|
||||||
|
|
||||||
class Resource {
|
|
||||||
/**
|
|
||||||
* Create a new resource
|
|
||||||
*/
|
|
||||||
static async create(data) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
|
|
||||||
const resource = {
|
|
||||||
url: data.url,
|
|
||||||
title: data.title,
|
|
||||||
description: data.description,
|
|
||||||
category: data.category, // framework/tool/research/organization/educational
|
|
||||||
subcategory: data.subcategory,
|
|
||||||
alignment_score: data.alignment_score, // 0-1 alignment with Tractatus values
|
|
||||||
ai_analysis: {
|
|
||||||
summary: data.ai_analysis?.summary,
|
|
||||||
relevance: data.ai_analysis?.relevance,
|
|
||||||
quality_indicators: data.ai_analysis?.quality_indicators || [],
|
|
||||||
concerns: data.ai_analysis?.concerns || [],
|
|
||||||
claude_reasoning: data.ai_analysis?.claude_reasoning
|
|
||||||
},
|
|
||||||
status: data.status || 'pending', // pending/approved/rejected
|
|
||||||
reviewed_by: data.reviewed_by,
|
|
||||||
reviewed_at: data.reviewed_at,
|
|
||||||
tags: data.tags || [],
|
|
||||||
featured: data.featured || false,
|
|
||||||
added_at: new Date(),
|
|
||||||
last_checked: new Date()
|
|
||||||
};
|
|
||||||
|
|
||||||
const result = await collection.insertOne(resource);
|
|
||||||
return { ...resource, _id: result.insertedId };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find resource by ID
|
|
||||||
*/
|
|
||||||
static async findById(id) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
return await collection.findOne({ _id: new ObjectId(id) });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find resource by URL
|
|
||||||
*/
|
|
||||||
static async findByUrl(url) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
return await collection.findOne({ url });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find approved resources
|
|
||||||
*/
|
|
||||||
static async findApproved(options = {}) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
const { limit = 50, skip = 0, category } = options;
|
|
||||||
|
|
||||||
const filter = { status: 'approved' };
|
|
||||||
if (category) filter.category = category;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find(filter)
|
|
||||||
.sort({ alignment_score: -1, added_at: -1 })
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find featured resources
|
|
||||||
*/
|
|
||||||
static async findFeatured(options = {}) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
const { limit = 10 } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({ status: 'approved', featured: true })
|
|
||||||
.sort({ alignment_score: -1 })
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find by category
|
|
||||||
*/
|
|
||||||
static async findByCategory(category, options = {}) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
const { limit = 30, skip = 0 } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({ category, status: 'approved' })
|
|
||||||
.sort({ alignment_score: -1 })
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find high-alignment pending resources
|
|
||||||
*/
|
|
||||||
static async findHighAlignment(options = {}) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
const { limit = 10 } = options;
|
|
||||||
|
|
||||||
return await collection
|
|
||||||
.find({
|
|
||||||
status: 'pending',
|
|
||||||
alignment_score: { $gte: 0.8 }
|
|
||||||
})
|
|
||||||
.sort({ alignment_score: -1 })
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update resource
|
|
||||||
*/
|
|
||||||
static async update(id, updates) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{ $set: updates }
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Approve resource
|
|
||||||
*/
|
|
||||||
static async approve(id, reviewerId) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
status: 'approved',
|
|
||||||
reviewed_by: reviewerId,
|
|
||||||
reviewed_at: new Date()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Reject resource
|
|
||||||
*/
|
|
||||||
static async reject(id, reviewerId) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{
|
|
||||||
$set: {
|
|
||||||
status: 'rejected',
|
|
||||||
reviewed_by: reviewerId,
|
|
||||||
reviewed_at: new Date()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Mark as featured
|
|
||||||
*/
|
|
||||||
static async setFeatured(id, featured = true) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{ $set: { featured } }
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update last checked timestamp
|
|
||||||
*/
|
|
||||||
static async updateLastChecked(id) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
|
|
||||||
await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{ $set: { last_checked: new Date() } }
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Count by status
|
|
||||||
*/
|
|
||||||
static async countByStatus(status) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
return await collection.countDocuments({ status });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete resource
|
|
||||||
*/
|
|
||||||
static async delete(id) {
|
|
||||||
const collection = await getCollection('resources');
|
|
||||||
const result = await collection.deleteOne({ _id: new ObjectId(id) });
|
|
||||||
return result.deletedCount > 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = Resource;
|
|
||||||
|
|
@ -1,177 +0,0 @@
|
||||||
/**
|
|
||||||
* User Model
|
|
||||||
* Admin user accounts
|
|
||||||
*/
|
|
||||||
|
|
||||||
const { ObjectId } = require('mongodb');
|
|
||||||
const bcrypt = require('bcrypt');
|
|
||||||
const { getCollection } = require('../utils/db.util');
|
|
||||||
|
|
||||||
class User {
|
|
||||||
/**
|
|
||||||
* Create a new user
|
|
||||||
*/
|
|
||||||
static async create(data) {
|
|
||||||
const collection = await getCollection('users');
|
|
||||||
|
|
||||||
// Hash password
|
|
||||||
const hashedPassword = await bcrypt.hash(data.password, 10);
|
|
||||||
|
|
||||||
const user = {
|
|
||||||
email: data.email,
|
|
||||||
password: hashedPassword,
|
|
||||||
name: data.name,
|
|
||||||
role: data.role || 'admin', // admin/moderator/viewer
|
|
||||||
created_at: new Date(),
|
|
||||||
last_login: null,
|
|
||||||
active: data.active !== undefined ? data.active : true
|
|
||||||
};
|
|
||||||
|
|
||||||
const result = await collection.insertOne(user);
|
|
||||||
|
|
||||||
// Return user without password
|
|
||||||
const { password, ...userWithoutPassword } = { ...user, _id: result.insertedId };
|
|
||||||
return userWithoutPassword;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find user by ID
|
|
||||||
*/
|
|
||||||
static async findById(id) {
|
|
||||||
const collection = await getCollection('users');
|
|
||||||
const user = await collection.findOne({ _id: new ObjectId(id) });
|
|
||||||
|
|
||||||
if (user) {
|
|
||||||
const { password, ...userWithoutPassword } = user;
|
|
||||||
return userWithoutPassword;
|
|
||||||
}
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Find user by email
|
|
||||||
*/
|
|
||||||
static async findByEmail(email) {
|
|
||||||
const collection = await getCollection('users');
|
|
||||||
return await collection.findOne({ email: email.toLowerCase() });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Authenticate user
|
|
||||||
*/
|
|
||||||
static async authenticate(email, password) {
|
|
||||||
const user = await this.findByEmail(email);
|
|
||||||
|
|
||||||
if (!user || !user.active) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
const isValid = await bcrypt.compare(password, user.password);
|
|
||||||
|
|
||||||
if (!isValid) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Update last login
|
|
||||||
await this.updateLastLogin(user._id);
|
|
||||||
|
|
||||||
// Return user without password
|
|
||||||
const { password: _, ...userWithoutPassword } = user;
|
|
||||||
return userWithoutPassword;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update last login timestamp
|
|
||||||
*/
|
|
||||||
static async updateLastLogin(id) {
|
|
||||||
const collection = await getCollection('users');
|
|
||||||
|
|
||||||
await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{ $set: { last_login: new Date() } }
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Update user
|
|
||||||
*/
|
|
||||||
static async update(id, updates) {
|
|
||||||
const collection = await getCollection('users');
|
|
||||||
|
|
||||||
// Remove password from updates (use changePassword for that)
|
|
||||||
const { password, ...safeUpdates } = updates;
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{ $set: safeUpdates }
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Change password
|
|
||||||
*/
|
|
||||||
static async changePassword(id, newPassword) {
|
|
||||||
const collection = await getCollection('users');
|
|
||||||
|
|
||||||
const hashedPassword = await bcrypt.hash(newPassword, 10);
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{ $set: { password: hashedPassword } }
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Deactivate user
|
|
||||||
*/
|
|
||||||
static async deactivate(id) {
|
|
||||||
const collection = await getCollection('users');
|
|
||||||
|
|
||||||
const result = await collection.updateOne(
|
|
||||||
{ _id: new ObjectId(id) },
|
|
||||||
{ $set: { active: false } }
|
|
||||||
);
|
|
||||||
|
|
||||||
return result.modifiedCount > 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* List all users
|
|
||||||
*/
|
|
||||||
static async list(options = {}) {
|
|
||||||
const collection = await getCollection('users');
|
|
||||||
const { limit = 50, skip = 0 } = options;
|
|
||||||
|
|
||||||
const users = await collection
|
|
||||||
.find({}, { projection: { password: 0 } })
|
|
||||||
.sort({ created_at: -1 })
|
|
||||||
.skip(skip)
|
|
||||||
.limit(limit)
|
|
||||||
.toArray();
|
|
||||||
|
|
||||||
return users;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Count users
|
|
||||||
*/
|
|
||||||
static async count(filter = {}) {
|
|
||||||
const collection = await getCollection('users');
|
|
||||||
return await collection.countDocuments(filter);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Delete user
|
|
||||||
*/
|
|
||||||
static async delete(id) {
|
|
||||||
const collection = await getCollection('users');
|
|
||||||
const result = await collection.deleteOne({ _id: new ObjectId(id) });
|
|
||||||
return result.deletedCount > 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = User;
|
|
||||||
|
|
@ -1,64 +0,0 @@
|
||||||
/**
|
|
||||||
* Admin Routes
|
|
||||||
* Moderation queue and system management
|
|
||||||
*/
|
|
||||||
|
|
||||||
const express = require('express');
|
|
||||||
const router = express.Router();
|
|
||||||
|
|
||||||
const adminController = require('../controllers/admin.controller');
|
|
||||||
const { authenticateToken, requireRole } = require('../middleware/auth.middleware');
|
|
||||||
const { validateRequired, validateObjectId } = require('../middleware/validation.middleware');
|
|
||||||
const { asyncHandler } = require('../middleware/error.middleware');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* All admin routes require authentication
|
|
||||||
*/
|
|
||||||
router.use(authenticateToken);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Moderation Queue
|
|
||||||
*/
|
|
||||||
|
|
||||||
// GET /api/admin/moderation - List moderation queue items
|
|
||||||
router.get('/moderation',
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
asyncHandler(adminController.getModerationQueue)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/admin/moderation/:id - Get single moderation item
|
|
||||||
router.get('/moderation/:id',
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(adminController.getModerationItem)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/admin/moderation/:id/review - Review item (approve/reject/escalate)
|
|
||||||
router.post('/moderation/:id/review',
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
validateRequired(['action']),
|
|
||||||
asyncHandler(adminController.reviewModerationItem)
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* System Statistics
|
|
||||||
*/
|
|
||||||
|
|
||||||
// GET /api/admin/stats - Get system statistics
|
|
||||||
router.get('/stats',
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
asyncHandler(adminController.getSystemStats)
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Activity Log
|
|
||||||
*/
|
|
||||||
|
|
||||||
// GET /api/admin/activity - Get recent activity log
|
|
||||||
router.get('/activity',
|
|
||||||
requireRole('admin'),
|
|
||||||
asyncHandler(adminController.getActivityLog)
|
|
||||||
);
|
|
||||||
|
|
||||||
module.exports = router;
|
|
||||||
|
|
@ -1,54 +0,0 @@
|
||||||
/**
|
|
||||||
* Authentication Routes
|
|
||||||
*/
|
|
||||||
|
|
||||||
const express = require('express');
|
|
||||||
const rateLimit = require('express-rate-limit');
|
|
||||||
const router = express.Router();
|
|
||||||
|
|
||||||
const authController = require('../controllers/auth.controller');
|
|
||||||
const { authenticateToken } = require('../middleware/auth.middleware');
|
|
||||||
const { validateEmail, validateRequired } = require('../middleware/validation.middleware');
|
|
||||||
const { asyncHandler } = require('../middleware/error.middleware');
|
|
||||||
|
|
||||||
// Rate limiter for login attempts (brute-force protection)
|
|
||||||
const loginLimiter = rateLimit({
|
|
||||||
windowMs: 15 * 60 * 1000, // 15 minutes
|
|
||||||
max: 5, // 5 attempts per 15 minutes per IP
|
|
||||||
message: 'Too many login attempts from this IP. Please try again in 15 minutes.',
|
|
||||||
standardHeaders: true,
|
|
||||||
legacyHeaders: false,
|
|
||||||
skipSuccessfulRequests: false // Count successful logins too (prevents credential stuffing)
|
|
||||||
});
|
|
||||||
|
|
||||||
/**
|
|
||||||
* POST /api/auth/login
|
|
||||||
* Login with email and password
|
|
||||||
* Rate limited: 5 attempts per 15 minutes per IP
|
|
||||||
*/
|
|
||||||
router.post('/login',
|
|
||||||
loginLimiter,
|
|
||||||
validateRequired(['email', 'password']),
|
|
||||||
validateEmail('email'),
|
|
||||||
asyncHandler(authController.login)
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* GET /api/auth/me
|
|
||||||
* Get current authenticated user
|
|
||||||
*/
|
|
||||||
router.get('/me',
|
|
||||||
authenticateToken,
|
|
||||||
asyncHandler(authController.getCurrentUser)
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* POST /api/auth/logout
|
|
||||||
* Logout (logs the event, client removes token)
|
|
||||||
*/
|
|
||||||
router.post('/logout',
|
|
||||||
authenticateToken,
|
|
||||||
asyncHandler(authController.logout)
|
|
||||||
);
|
|
||||||
|
|
||||||
module.exports = router;
|
|
||||||
|
|
@ -1,117 +0,0 @@
|
||||||
/**
|
|
||||||
* Blog Routes
|
|
||||||
* AI-curated blog endpoints
|
|
||||||
*/
|
|
||||||
|
|
||||||
const express = require('express');
|
|
||||||
const router = express.Router();
|
|
||||||
|
|
||||||
const blogController = require('../controllers/blog.controller');
|
|
||||||
const { authenticateToken, requireRole } = require('../middleware/auth.middleware');
|
|
||||||
const { validateRequired, validateObjectId, validateSlug } = require('../middleware/validation.middleware');
|
|
||||||
const { asyncHandler } = require('../middleware/error.middleware');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Public routes
|
|
||||||
*/
|
|
||||||
|
|
||||||
// GET /api/blog/rss - RSS feed (must be before /:slug to avoid conflict)
|
|
||||||
router.get('/rss',
|
|
||||||
asyncHandler(blogController.generateRSSFeed)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/blog - List published posts
|
|
||||||
router.get('/',
|
|
||||||
asyncHandler(blogController.listPublishedPosts)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/blog/:slug - Get published post by slug
|
|
||||||
router.get('/:slug',
|
|
||||||
asyncHandler(blogController.getPublishedPost)
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Admin routes
|
|
||||||
*/
|
|
||||||
|
|
||||||
// POST /api/blog/suggest-topics - AI-powered topic suggestions (TRA-OPS-0002)
|
|
||||||
router.post('/suggest-topics',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateRequired(['audience']),
|
|
||||||
asyncHandler(blogController.suggestTopics)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/blog/draft-post - AI-powered blog post drafting (TRA-OPS-0002)
|
|
||||||
// Enforces inst_016, inst_017, inst_018
|
|
||||||
router.post('/draft-post',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateRequired(['topic', 'audience']),
|
|
||||||
asyncHandler(blogController.draftBlogPost)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/blog/analyze-content - Analyze content for Tractatus compliance
|
|
||||||
router.post('/analyze-content',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateRequired(['title', 'body']),
|
|
||||||
asyncHandler(blogController.analyzeContent)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/blog/editorial-guidelines - Get editorial guidelines
|
|
||||||
router.get('/editorial-guidelines',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
asyncHandler(blogController.getEditorialGuidelines)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/blog/admin/posts?status=draft
|
|
||||||
router.get('/admin/posts',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
asyncHandler(blogController.listPostsByStatus)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/blog/admin/:id - Get any post by ID
|
|
||||||
router.get('/admin/:id',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(blogController.getPostById)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/blog - Create new post
|
|
||||||
router.post('/',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateRequired(['title', 'slug', 'content']),
|
|
||||||
validateSlug,
|
|
||||||
asyncHandler(blogController.createPost)
|
|
||||||
);
|
|
||||||
|
|
||||||
// PUT /api/blog/:id - Update post
|
|
||||||
router.put('/:id',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(blogController.updatePost)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/blog/:id/publish - Publish post
|
|
||||||
router.post('/:id/publish',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(blogController.publishPost)
|
|
||||||
);
|
|
||||||
|
|
||||||
// DELETE /api/blog/:id - Delete post
|
|
||||||
router.delete('/:id',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(blogController.deletePost)
|
|
||||||
);
|
|
||||||
|
|
||||||
module.exports = router;
|
|
||||||
|
|
@ -1,117 +0,0 @@
|
||||||
/**
|
|
||||||
* Case Study Routes
|
|
||||||
* Community case study submission endpoints
|
|
||||||
*/
|
|
||||||
|
|
||||||
const express = require('express');
|
|
||||||
const router = express.Router();
|
|
||||||
|
|
||||||
const casesController = require('../controllers/cases.controller');
|
|
||||||
const { authenticateToken, requireRole } = require('../middleware/auth.middleware');
|
|
||||||
const { validateRequired, validateEmail, validateObjectId } = require('../middleware/validation.middleware');
|
|
||||||
const { asyncHandler } = require('../middleware/error.middleware');
|
|
||||||
const { createInputValidationMiddleware } = require('../middleware/input-validation.middleware');
|
|
||||||
const { formRateLimiter } = require('../middleware/rate-limit.middleware');
|
|
||||||
const { csrfProtection } = require('../middleware/csrf-protection.middleware');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Public routes
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Validation schema for case study submission
|
|
||||||
const caseSubmissionSchema = {
|
|
||||||
'submitter.name': { required: true, type: 'name', maxLength: 100 },
|
|
||||||
'submitter.email': { required: true, type: 'email', maxLength: 254 },
|
|
||||||
'submitter.organization': { required: false, type: 'default', maxLength: 200 },
|
|
||||||
'case_study.title': { required: true, type: 'title', maxLength: 200 },
|
|
||||||
'case_study.description': { required: true, type: 'description', maxLength: 50000 },
|
|
||||||
'case_study.failure_mode': { required: true, type: 'default', maxLength: 500 },
|
|
||||||
'case_study.context': { required: false, type: 'default', maxLength: 5000 },
|
|
||||||
'case_study.impact': { required: false, type: 'default', maxLength: 5000 },
|
|
||||||
'case_study.lessons_learned': { required: false, type: 'default', maxLength: 5000 }
|
|
||||||
};
|
|
||||||
|
|
||||||
// POST /api/cases/submit - Submit case study (public)
|
|
||||||
router.post('/submit',
|
|
||||||
formRateLimiter, // 5 requests per minute
|
|
||||||
csrfProtection, // CSRF validation
|
|
||||||
createInputValidationMiddleware(caseSubmissionSchema),
|
|
||||||
validateRequired([
|
|
||||||
'submitter.name',
|
|
||||||
'submitter.email',
|
|
||||||
'case_study.title',
|
|
||||||
'case_study.description',
|
|
||||||
'case_study.failure_mode'
|
|
||||||
]),
|
|
||||||
validateEmail('submitter.email'),
|
|
||||||
asyncHandler(casesController.submitCase)
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Admin routes
|
|
||||||
*/
|
|
||||||
|
|
||||||
// GET /api/cases/submissions/stats - Get submission statistics (admin)
|
|
||||||
router.get('/submissions/stats',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
asyncHandler(casesController.getStats)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/cases/submissions - List all submissions (admin)
|
|
||||||
router.get('/submissions',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
asyncHandler(casesController.listSubmissions)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/cases/submissions/high-relevance - List high-relevance pending (admin)
|
|
||||||
router.get('/submissions/high-relevance',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
asyncHandler(casesController.listHighRelevance)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/cases/submissions/:id - Get submission by ID (admin)
|
|
||||||
router.get('/submissions/:id',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(casesController.getSubmission)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/cases/submissions/:id/approve - Approve submission (admin)
|
|
||||||
router.post('/submissions/:id/approve',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(casesController.approveSubmission)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/cases/submissions/:id/reject - Reject submission (admin)
|
|
||||||
router.post('/submissions/:id/reject',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
validateRequired(['reason']),
|
|
||||||
asyncHandler(casesController.rejectSubmission)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/cases/submissions/:id/request-info - Request more information (admin)
|
|
||||||
router.post('/submissions/:id/request-info',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
validateRequired(['requested_info']),
|
|
||||||
asyncHandler(casesController.requestMoreInfo)
|
|
||||||
);
|
|
||||||
|
|
||||||
// DELETE /api/cases/submissions/:id - Delete submission (admin)
|
|
||||||
router.delete('/submissions/:id',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(casesController.deleteSubmission)
|
|
||||||
);
|
|
||||||
|
|
||||||
module.exports = router;
|
|
||||||
|
|
@ -1,242 +0,0 @@
|
||||||
/**
|
|
||||||
* Demo Routes
|
|
||||||
* Public API endpoints for interactive demos
|
|
||||||
* Rate-limited to prevent abuse
|
|
||||||
*/
|
|
||||||
|
|
||||||
const express = require('express');
|
|
||||||
const router = express.Router();
|
|
||||||
const { asyncHandler } = require('../middleware/error.middleware');
|
|
||||||
|
|
||||||
// Import services
|
|
||||||
const {
|
|
||||||
classifier,
|
|
||||||
validator,
|
|
||||||
enforcer,
|
|
||||||
monitor
|
|
||||||
} = require('../services');
|
|
||||||
|
|
||||||
// Simple in-memory rate limiting for demos
|
|
||||||
const rateLimiter = new Map();
|
|
||||||
const RATE_LIMIT = 20; // requests per minute
|
|
||||||
const RATE_WINDOW = 60000; // 1 minute
|
|
||||||
|
|
||||||
function checkRateLimit(ip) {
|
|
||||||
const now = Date.now();
|
|
||||||
const userRequests = rateLimiter.get(ip) || [];
|
|
||||||
|
|
||||||
// Remove expired requests
|
|
||||||
const validRequests = userRequests.filter(time => now - time < RATE_WINDOW);
|
|
||||||
|
|
||||||
if (validRequests.length >= RATE_LIMIT) {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
validRequests.push(now);
|
|
||||||
rateLimiter.set(ip, validRequests);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Rate limiting middleware
|
|
||||||
const demoRateLimit = (req, res, next) => {
|
|
||||||
const ip = req.ip || req.connection.remoteAddress;
|
|
||||||
|
|
||||||
if (!checkRateLimit(ip)) {
|
|
||||||
return res.status(429).json({
|
|
||||||
error: 'Too Many Requests',
|
|
||||||
message: 'Rate limit exceeded. Please try again in a minute.',
|
|
||||||
retryAfter: 60
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
next();
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* POST /api/demo/classify
|
|
||||||
* Public instruction classification for demo
|
|
||||||
*/
|
|
||||||
router.post('/classify',
|
|
||||||
demoRateLimit,
|
|
||||||
asyncHandler(async (req, res) => {
|
|
||||||
const { instruction } = req.body;
|
|
||||||
|
|
||||||
if (!instruction || typeof instruction !== 'string') {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'instruction field is required and must be a string'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
if (instruction.length > 500) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'instruction must be 500 characters or less'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const classification = classifier.classify({
|
|
||||||
text: instruction,
|
|
||||||
context: {},
|
|
||||||
timestamp: new Date(),
|
|
||||||
source: 'demo'
|
|
||||||
});
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
classification: {
|
|
||||||
quadrant: classification.quadrant,
|
|
||||||
persistence: classification.persistence,
|
|
||||||
temporal_scope: classification.temporal_scope || 'session',
|
|
||||||
verification_required: classification.verification_required || 'MANDATORY',
|
|
||||||
explicitness: classification.explicitness || 0.7,
|
|
||||||
human_oversight: classification.human_oversight || 'RECOMMENDED',
|
|
||||||
reasoning: classification.reasoning || generateReasoning(classification)
|
|
||||||
}
|
|
||||||
});
|
|
||||||
})
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* POST /api/demo/boundary-check
|
|
||||||
* Public boundary enforcement check for demo
|
|
||||||
*/
|
|
||||||
router.post('/boundary-check',
|
|
||||||
demoRateLimit,
|
|
||||||
asyncHandler(async (req, res) => {
|
|
||||||
const { decision, description } = req.body;
|
|
||||||
|
|
||||||
if (!decision || typeof decision !== 'string') {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'decision field is required'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const action = {
|
|
||||||
type: 'decision',
|
|
||||||
decision: decision,
|
|
||||||
description: description || '',
|
|
||||||
timestamp: new Date()
|
|
||||||
};
|
|
||||||
|
|
||||||
const enforcement = enforcer.enforce(action, { source: 'demo' });
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
enforcement: {
|
|
||||||
allowed: enforcement.allowed,
|
|
||||||
boundary_violated: enforcement.boundary_violated || null,
|
|
||||||
reasoning: enforcement.reasoning || generateBoundaryReasoning(enforcement, decision),
|
|
||||||
alternatives: enforcement.alternatives || [],
|
|
||||||
human_approval_required: !enforcement.allowed
|
|
||||||
}
|
|
||||||
});
|
|
||||||
})
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* POST /api/demo/pressure-check
|
|
||||||
* Public pressure analysis for demo
|
|
||||||
*/
|
|
||||||
router.post('/pressure-check',
|
|
||||||
demoRateLimit,
|
|
||||||
asyncHandler(async (req, res) => {
|
|
||||||
const { tokens, messages, errors } = req.body;
|
|
||||||
|
|
||||||
if (typeof tokens !== 'number' || typeof messages !== 'number') {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'tokens and messages must be numbers'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const context = {
|
|
||||||
tokenUsage: tokens,
|
|
||||||
tokenBudget: 200000,
|
|
||||||
messageCount: messages,
|
|
||||||
errorCount: errors || 0,
|
|
||||||
source: 'demo'
|
|
||||||
};
|
|
||||||
|
|
||||||
const pressure = monitor.analyzePressure(context);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
pressure: {
|
|
||||||
level: pressure.level,
|
|
||||||
score: pressure.score,
|
|
||||||
percentage: Math.round(pressure.score * 100),
|
|
||||||
recommendations: pressure.recommendations || generatePressureRecommendations(pressure),
|
|
||||||
factors: pressure.factors || {}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
})
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Helper: Generate reasoning for classification
|
|
||||||
*/
|
|
||||||
function generateReasoning(classification) {
|
|
||||||
const { quadrant, persistence } = classification;
|
|
||||||
|
|
||||||
const quadrantReasons = {
|
|
||||||
'STRATEGIC': 'This appears to involve long-term values, mission, or organizational direction.',
|
|
||||||
'OPERATIONAL': 'This relates to processes, policies, or project-level decisions.',
|
|
||||||
'TACTICAL': 'This is an immediate implementation or action-level instruction.',
|
|
||||||
'SYSTEM': 'This involves technical infrastructure or architectural decisions.',
|
|
||||||
'STOCHASTIC': 'This relates to exploration, innovation, or experimentation.'
|
|
||||||
};
|
|
||||||
|
|
||||||
const persistenceReasons = {
|
|
||||||
'HIGH': 'Should remain active for the duration of the project or longer.',
|
|
||||||
'MEDIUM': 'Should remain active for this phase or session.',
|
|
||||||
'LOW': 'Single-use or temporary instruction.',
|
|
||||||
'VARIABLE': 'Applies conditionally based on context.'
|
|
||||||
};
|
|
||||||
|
|
||||||
return `${quadrantReasons[quadrant] || 'Classification based on instruction content.'} ${persistenceReasons[persistence] || ''}`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Helper: Generate boundary enforcement reasoning
|
|
||||||
*/
|
|
||||||
function generateBoundaryReasoning(enforcement, decision) {
|
|
||||||
if (enforcement.allowed) {
|
|
||||||
return 'This is a technical decision that can be automated with appropriate verification.';
|
|
||||||
}
|
|
||||||
|
|
||||||
const boundaryReasons = {
|
|
||||||
'VALUES': 'Values decisions cannot be automated - they require human judgment.',
|
|
||||||
'USER_AGENCY': 'Decisions affecting user agency require explicit consent.',
|
|
||||||
'IRREVERSIBLE': 'Irreversible actions require human approval before execution.',
|
|
||||||
'STRATEGIC': 'Strategic direction decisions must be made by humans.',
|
|
||||||
'ETHICAL': 'Ethical considerations require human moral judgment.'
|
|
||||||
};
|
|
||||||
|
|
||||||
return boundaryReasons[enforcement.boundary_violated] ||
|
|
||||||
'This decision crosses into territory requiring human judgment.';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Helper: Generate pressure recommendations
|
|
||||||
*/
|
|
||||||
function generatePressureRecommendations(pressure) {
|
|
||||||
const { level, score } = pressure;
|
|
||||||
|
|
||||||
if (level === 'NORMAL') {
|
|
||||||
return 'Operating normally. All systems green.';
|
|
||||||
} else if (level === 'ELEVATED') {
|
|
||||||
return 'Elevated pressure detected. Increased verification recommended.';
|
|
||||||
} else if (level === 'HIGH') {
|
|
||||||
return 'High pressure. Mandatory verification required for all actions.';
|
|
||||||
} else if (level === 'CRITICAL') {
|
|
||||||
return 'Critical pressure! Recommend context refresh or session restart.';
|
|
||||||
} else if (level === 'DANGEROUS') {
|
|
||||||
return 'DANGEROUS CONDITIONS. Human intervention required. Action execution blocked.';
|
|
||||||
}
|
|
||||||
|
|
||||||
return 'Pressure analysis complete.';
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = router;
|
|
||||||
|
|
@ -1,100 +0,0 @@
|
||||||
/**
|
|
||||||
* Documents Routes
|
|
||||||
* Framework documentation endpoints
|
|
||||||
*/
|
|
||||||
|
|
||||||
const express = require('express');
|
|
||||||
const router = express.Router();
|
|
||||||
|
|
||||||
const documentsController = require('../controllers/documents.controller');
|
|
||||||
const { authenticateToken, requireRole } = require('../middleware/auth.middleware');
|
|
||||||
const { validateRequired, validateObjectId, validateSlug } = require('../middleware/validation.middleware');
|
|
||||||
const { asyncHandler } = require('../middleware/error.middleware');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Public routes (read-only)
|
|
||||||
*/
|
|
||||||
|
|
||||||
// GET /api/documents/search?q=query
|
|
||||||
router.get('/search',
|
|
||||||
asyncHandler(documentsController.searchDocuments)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/documents/archived
|
|
||||||
router.get('/archived',
|
|
||||||
asyncHandler(documentsController.listArchivedDocuments)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/documents/drafts (admin only)
|
|
||||||
router.get('/drafts',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
asyncHandler(documentsController.listDraftDocuments)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/documents
|
|
||||||
router.get('/', (req, res, next) => {
|
|
||||||
// Redirect browser requests to API documentation
|
|
||||||
const acceptsHtml = req.accepts('html');
|
|
||||||
const acceptsJson = req.accepts('json');
|
|
||||||
|
|
||||||
if (acceptsHtml && !acceptsJson) {
|
|
||||||
return res.redirect(302, '/api-reference.html#documents');
|
|
||||||
}
|
|
||||||
|
|
||||||
next();
|
|
||||||
}, asyncHandler(documentsController.listDocuments));
|
|
||||||
|
|
||||||
// GET /api/documents/:identifier (ID or slug)
|
|
||||||
router.get('/:identifier',
|
|
||||||
asyncHandler(documentsController.getDocument)
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Admin routes (protected)
|
|
||||||
*/
|
|
||||||
|
|
||||||
// POST /api/documents
|
|
||||||
router.post('/',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateRequired(['title', 'slug', 'quadrant', 'content_markdown']),
|
|
||||||
validateSlug,
|
|
||||||
asyncHandler(documentsController.createDocument)
|
|
||||||
);
|
|
||||||
|
|
||||||
// PUT /api/documents/:id
|
|
||||||
router.put('/:id',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(documentsController.updateDocument)
|
|
||||||
);
|
|
||||||
|
|
||||||
// DELETE /api/documents/:id
|
|
||||||
router.delete('/:id',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(documentsController.deleteDocument)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/documents/:id/publish (admin only)
|
|
||||||
// SECURITY: Explicit publish workflow with validation
|
|
||||||
router.post('/:id/publish',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
validateRequired(['category']),
|
|
||||||
asyncHandler(documentsController.publishDocument)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/documents/:id/unpublish (admin only)
|
|
||||||
router.post('/:id/unpublish',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(documentsController.unpublishDocument)
|
|
||||||
);
|
|
||||||
|
|
||||||
module.exports = router;
|
|
||||||
|
|
@ -1,74 +0,0 @@
|
||||||
/**
|
|
||||||
* Koha Routes
|
|
||||||
* Donation system API endpoints
|
|
||||||
*/
|
|
||||||
|
|
||||||
const express = require('express');
|
|
||||||
const router = express.Router();
|
|
||||||
const rateLimit = require('express-rate-limit');
|
|
||||||
const kohaController = require('../controllers/koha.controller');
|
|
||||||
const { authenticateToken, requireAdmin } = require('../middleware/auth.middleware');
|
|
||||||
const { asyncHandler } = require('../middleware/error.middleware');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Rate limiting for donation endpoints
|
|
||||||
* More restrictive than general API limit to prevent abuse
|
|
||||||
*/
|
|
||||||
const donationLimiter = rateLimit({
|
|
||||||
windowMs: 60 * 60 * 1000, // 1 hour
|
|
||||||
max: 10, // 10 requests per hour per IP
|
|
||||||
message: 'Too many donation attempts from this IP. Please try again in an hour.',
|
|
||||||
standardHeaders: true,
|
|
||||||
legacyHeaders: false,
|
|
||||||
// Skip rate limiting for webhook endpoint (Stripe needs reliable access)
|
|
||||||
skip: (req) => req.path === '/webhook'
|
|
||||||
});
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Public routes
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Create checkout session for donation
|
|
||||||
// POST /api/koha/checkout
|
|
||||||
// Body: { amount, frequency, tier, donor: { name, email, country }, public_acknowledgement, public_name }
|
|
||||||
router.post('/checkout', donationLimiter, kohaController.createCheckout);
|
|
||||||
|
|
||||||
// Stripe webhook endpoint
|
|
||||||
// POST /api/koha/webhook
|
|
||||||
// Note: Requires raw body, configured in app.js
|
|
||||||
router.post('/webhook', kohaController.handleWebhook);
|
|
||||||
|
|
||||||
// Get public transparency metrics
|
|
||||||
// GET /api/koha/transparency
|
|
||||||
router.get('/transparency', kohaController.getTransparency);
|
|
||||||
|
|
||||||
// Cancel recurring donation
|
|
||||||
// POST /api/koha/cancel
|
|
||||||
// Body: { subscriptionId, email }
|
|
||||||
// Rate limited to prevent abuse/guessing of subscription IDs
|
|
||||||
router.post('/cancel', donationLimiter, kohaController.cancelDonation);
|
|
||||||
|
|
||||||
// Create Stripe Customer Portal session
|
|
||||||
// POST /api/koha/portal
|
|
||||||
// Body: { email }
|
|
||||||
// Rate limited to prevent abuse
|
|
||||||
router.post('/portal', donationLimiter, kohaController.createPortalSession);
|
|
||||||
|
|
||||||
// Verify donation session (after Stripe redirect)
|
|
||||||
// GET /api/koha/verify/:sessionId
|
|
||||||
router.get('/verify/:sessionId', kohaController.verifySession);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Admin-only routes
|
|
||||||
* Requires JWT authentication with admin role
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Get donation statistics
|
|
||||||
// GET /api/koha/statistics?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD
|
|
||||||
router.get('/statistics',
|
|
||||||
authenticateToken,
|
|
||||||
requireAdmin,
|
|
||||||
asyncHandler(kohaController.getStatistics)
|
|
||||||
);
|
|
||||||
|
|
||||||
module.exports = router;
|
|
||||||
|
|
@ -1,107 +0,0 @@
|
||||||
/**
|
|
||||||
* Media Inquiry Routes
|
|
||||||
* Press/media inquiry submission and triage endpoints
|
|
||||||
*/
|
|
||||||
|
|
||||||
const express = require('express');
|
|
||||||
const router = express.Router();
|
|
||||||
|
|
||||||
const mediaController = require('../controllers/media.controller');
|
|
||||||
const { authenticateToken, requireRole } = require('../middleware/auth.middleware');
|
|
||||||
const { validateRequired, validateEmail, validateObjectId } = require('../middleware/validation.middleware');
|
|
||||||
const { asyncHandler } = require('../middleware/error.middleware');
|
|
||||||
const { createInputValidationMiddleware } = require('../middleware/input-validation.middleware');
|
|
||||||
const { formRateLimiter } = require('../middleware/rate-limit.middleware');
|
|
||||||
const { csrfProtection } = require('../middleware/csrf-protection.middleware');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Public routes
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Validation schema for media inquiry submission
|
|
||||||
const mediaInquirySchema = {
|
|
||||||
'contact.name': { required: true, type: 'name', maxLength: 100 },
|
|
||||||
'contact.email': { required: true, type: 'email', maxLength: 254 },
|
|
||||||
'contact.outlet': { required: true, type: 'default', maxLength: 200 },
|
|
||||||
'contact.phone': { required: false, type: 'phone', maxLength: 20 },
|
|
||||||
'contact.role': { required: false, type: 'default', maxLength: 100 },
|
|
||||||
'inquiry.subject': { required: true, type: 'title', maxLength: 200 },
|
|
||||||
'inquiry.message': { required: true, type: 'description', maxLength: 5000 },
|
|
||||||
'inquiry.deadline': { required: false, type: 'default', maxLength: 100 }
|
|
||||||
};
|
|
||||||
|
|
||||||
// POST /api/media/inquiries - Submit media inquiry (public)
|
|
||||||
router.post('/inquiries',
|
|
||||||
formRateLimiter, // 5 requests per minute
|
|
||||||
csrfProtection, // CSRF validation
|
|
||||||
createInputValidationMiddleware(mediaInquirySchema),
|
|
||||||
validateRequired(['contact.name', 'contact.email', 'contact.outlet', 'inquiry.subject', 'inquiry.message']),
|
|
||||||
validateEmail('contact.email'),
|
|
||||||
asyncHandler(mediaController.submitInquiry)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/media/triage-stats - Get triage statistics (public, transparency)
|
|
||||||
router.get('/triage-stats',
|
|
||||||
asyncHandler(mediaController.getTriageStats)
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Admin routes
|
|
||||||
*/
|
|
||||||
|
|
||||||
// GET /api/media/inquiries - List all inquiries (admin)
|
|
||||||
router.get('/inquiries',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
asyncHandler(mediaController.listInquiries)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/media/inquiries/urgent - List high urgency inquiries (admin)
|
|
||||||
router.get('/inquiries/urgent',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
asyncHandler(mediaController.listUrgentInquiries)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/media/inquiries/:id - Get inquiry by ID (admin)
|
|
||||||
router.get('/inquiries/:id',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(mediaController.getInquiry)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/media/inquiries/:id/assign - Assign inquiry to user (admin)
|
|
||||||
router.post('/inquiries/:id/assign',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(mediaController.assignInquiry)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/media/inquiries/:id/triage - Run AI triage (admin)
|
|
||||||
router.post('/inquiries/:id/triage',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(mediaController.triageInquiry)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/media/inquiries/:id/respond - Mark as responded (admin)
|
|
||||||
router.post('/inquiries/:id/respond',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
validateRequired(['content']),
|
|
||||||
asyncHandler(mediaController.respondToInquiry)
|
|
||||||
);
|
|
||||||
|
|
||||||
// DELETE /api/media/inquiries/:id - Delete inquiry (admin)
|
|
||||||
router.delete('/inquiries/:id',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
validateObjectId('id'),
|
|
||||||
asyncHandler(mediaController.deleteInquiry)
|
|
||||||
);
|
|
||||||
|
|
||||||
module.exports = router;
|
|
||||||
|
|
@ -1,84 +0,0 @@
|
||||||
/**
|
|
||||||
* Newsletter Routes
|
|
||||||
* Public subscription management and admin endpoints
|
|
||||||
*/
|
|
||||||
|
|
||||||
const express = require('express');
|
|
||||||
const router = express.Router();
|
|
||||||
|
|
||||||
const newsletterController = require('../controllers/newsletter.controller');
|
|
||||||
const { authenticateToken, requireRole } = require('../middleware/auth.middleware');
|
|
||||||
const { validateRequired } = require('../middleware/validation.middleware');
|
|
||||||
const { asyncHandler } = require('../middleware/error.middleware');
|
|
||||||
const { createInputValidationMiddleware } = require('../middleware/input-validation.middleware');
|
|
||||||
const { formRateLimiter } = require('../middleware/rate-limit.middleware');
|
|
||||||
const { csrfProtection } = require('../middleware/csrf-protection.middleware');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Public Routes
|
|
||||||
*/
|
|
||||||
|
|
||||||
// Validation schema for newsletter subscription
|
|
||||||
const newsletterSubscribeSchema = {
|
|
||||||
'email': { required: true, type: 'email', maxLength: 254 },
|
|
||||||
'name': { required: false, type: 'name', maxLength: 100 }
|
|
||||||
};
|
|
||||||
|
|
||||||
// POST /api/newsletter/subscribe - Subscribe to newsletter
|
|
||||||
router.post('/subscribe',
|
|
||||||
formRateLimiter, // 5 requests per minute
|
|
||||||
csrfProtection, // CSRF validation
|
|
||||||
createInputValidationMiddleware(newsletterSubscribeSchema),
|
|
||||||
validateRequired(['email']),
|
|
||||||
asyncHandler(newsletterController.subscribe)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/newsletter/verify/:token - Verify email subscription
|
|
||||||
router.get('/verify/:token',
|
|
||||||
asyncHandler(newsletterController.verify)
|
|
||||||
);
|
|
||||||
|
|
||||||
// POST /api/newsletter/unsubscribe - Unsubscribe from newsletter
|
|
||||||
router.post('/unsubscribe',
|
|
||||||
asyncHandler(newsletterController.unsubscribe)
|
|
||||||
);
|
|
||||||
|
|
||||||
// PUT /api/newsletter/preferences - Update subscription preferences
|
|
||||||
router.put('/preferences',
|
|
||||||
validateRequired(['email']),
|
|
||||||
asyncHandler(newsletterController.updatePreferences)
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Admin Routes (require authentication)
|
|
||||||
*/
|
|
||||||
|
|
||||||
// GET /api/newsletter/admin/stats - Get newsletter statistics
|
|
||||||
router.get('/admin/stats',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
asyncHandler(newsletterController.getStats)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/newsletter/admin/subscriptions - List all subscriptions
|
|
||||||
router.get('/admin/subscriptions',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin', 'moderator'),
|
|
||||||
asyncHandler(newsletterController.listSubscriptions)
|
|
||||||
);
|
|
||||||
|
|
||||||
// GET /api/newsletter/admin/export - Export subscriptions as CSV
|
|
||||||
router.get('/admin/export',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
asyncHandler(newsletterController.exportSubscriptions)
|
|
||||||
);
|
|
||||||
|
|
||||||
// DELETE /api/newsletter/admin/subscriptions/:id - Delete subscription
|
|
||||||
router.delete('/admin/subscriptions/:id',
|
|
||||||
authenticateToken,
|
|
||||||
requireRole('admin'),
|
|
||||||
asyncHandler(newsletterController.deleteSubscription)
|
|
||||||
);
|
|
||||||
|
|
||||||
module.exports = router;
|
|
||||||
|
|
@ -1,110 +0,0 @@
|
||||||
/**
|
|
||||||
* Test Routes
|
|
||||||
* Development and testing endpoints
|
|
||||||
*/
|
|
||||||
|
|
||||||
const express = require('express');
|
|
||||||
const router = express.Router();
|
|
||||||
const { createSecureUpload, ALLOWED_MIME_TYPES } = require('../middleware/file-security.middleware');
|
|
||||||
const { asyncHandler } = require('../middleware/error.middleware');
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Test file upload endpoint
|
|
||||||
* POST /api/test/upload
|
|
||||||
*
|
|
||||||
* Tests the complete file security pipeline:
|
|
||||||
* - Multer upload
|
|
||||||
* - MIME type validation
|
|
||||||
* - Magic number validation
|
|
||||||
* - ClamAV malware scanning
|
|
||||||
* - Quarantine system
|
|
||||||
*/
|
|
||||||
router.post('/upload',
|
|
||||||
...createSecureUpload({
|
|
||||||
fileType: 'document',
|
|
||||||
maxFileSize: 10 * 1024 * 1024, // 10MB
|
|
||||||
allowedMimeTypes: ALLOWED_MIME_TYPES.document,
|
|
||||||
fieldName: 'file'
|
|
||||||
}),
|
|
||||||
asyncHandler(async (req, res) => {
|
|
||||||
if (!req.file) {
|
|
||||||
return res.status(400).json({
|
|
||||||
error: 'Bad Request',
|
|
||||||
message: 'No file uploaded'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
logger.info(`Test file upload successful: ${req.file.originalname}`);
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
message: 'File uploaded and validated successfully',
|
|
||||||
file: {
|
|
||||||
originalName: req.file.originalname,
|
|
||||||
filename: req.file.filename,
|
|
||||||
mimetype: req.file.mimetype,
|
|
||||||
size: req.file.size,
|
|
||||||
path: req.file.path
|
|
||||||
},
|
|
||||||
security: {
|
|
||||||
mimeValidated: true,
|
|
||||||
malwareScan: 'passed',
|
|
||||||
quarantined: false
|
|
||||||
}
|
|
||||||
});
|
|
||||||
})
|
|
||||||
);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get upload statistics
|
|
||||||
* GET /api/test/upload-stats
|
|
||||||
*/
|
|
||||||
router.get('/upload-stats',
|
|
||||||
asyncHandler(async (req, res) => {
|
|
||||||
const fs = require('fs').promises;
|
|
||||||
const path = require('path');
|
|
||||||
|
|
||||||
try {
|
|
||||||
const uploadDir = process.env.UPLOAD_DIR || '/tmp/tractatus-uploads';
|
|
||||||
const quarantineDir = process.env.QUARANTINE_DIR || '/var/quarantine/tractatus';
|
|
||||||
|
|
||||||
const uploadFiles = await fs.readdir(uploadDir).catch(() => []);
|
|
||||||
const quarantineFiles = await fs.readdir(quarantineDir).catch(() => []);
|
|
||||||
|
|
||||||
// Get quarantine details
|
|
||||||
const quarantineDetails = [];
|
|
||||||
for (const file of quarantineFiles) {
|
|
||||||
if (file.endsWith('.json')) {
|
|
||||||
const metadataPath = path.join(quarantineDir, file);
|
|
||||||
const metadata = JSON.parse(await fs.readFile(metadataPath, 'utf8'));
|
|
||||||
quarantineDetails.push(metadata);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
res.json({
|
|
||||||
success: true,
|
|
||||||
stats: {
|
|
||||||
uploads: {
|
|
||||||
directory: uploadDir,
|
|
||||||
count: uploadFiles.length,
|
|
||||||
files: uploadFiles
|
|
||||||
},
|
|
||||||
quarantine: {
|
|
||||||
directory: quarantineDir,
|
|
||||||
count: Math.floor(quarantineFiles.length / 2), // Each quarantined file has .json metadata
|
|
||||||
items: quarantineDetails
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Upload stats error:', error);
|
|
||||||
res.status(500).json({
|
|
||||||
error: 'Internal Server Error',
|
|
||||||
message: 'Failed to retrieve upload statistics'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
})
|
|
||||||
);
|
|
||||||
|
|
||||||
module.exports = router;
|
|
||||||
|
|
@ -1,407 +0,0 @@
|
||||||
/*
|
|
||||||
* Copyright 2025 John G Stroh
|
|
||||||
*
|
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
||||||
* you may not use this file except in compliance with the License.
|
|
||||||
* You may obtain a copy of the License at
|
|
||||||
*
|
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
*
|
|
||||||
* Unless required by applicable law or agreed to in writing, software
|
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
* See the License for the specific language governing permissions and
|
|
||||||
* limitations under the License.
|
|
||||||
*/
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Adaptive Communication Orchestrator Service
|
|
||||||
* Prevents linguistic hierarchy in pluralistic deliberation
|
|
||||||
*
|
|
||||||
* Support Service for PluralisticDeliberationOrchestrator
|
|
||||||
*
|
|
||||||
* Implements:
|
|
||||||
* - inst_029: Adaptive Communication Tone (detect and mirror stakeholder style)
|
|
||||||
* - inst_030: Anti-Patronizing Language Filter (blocks condescending terms)
|
|
||||||
* - inst_031: Regional Communication Norms (Australian/NZ, Japanese, Māori protocols)
|
|
||||||
* - inst_032: Multilingual Engagement Protocol (language barrier accommodation)
|
|
||||||
*
|
|
||||||
* Core Principle:
|
|
||||||
* If Tractatus facilitates "non-hierarchical deliberation" but only communicates
|
|
||||||
* in formal academic English, it imposes Western liberal norms and excludes
|
|
||||||
* non-academics, non-English speakers, and working-class communities.
|
|
||||||
*
|
|
||||||
* Solution: Same deliberation outcome, culturally appropriate communication.
|
|
||||||
*/
|
|
||||||
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Communication style profiles
|
|
||||||
*/
|
|
||||||
const COMMUNICATION_STYLES = {
|
|
||||||
FORMAL_ACADEMIC: {
|
|
||||||
name: 'Formal Academic',
|
|
||||||
characteristics: ['citations', 'technical terms', 'formal register', 'hedging'],
|
|
||||||
tone: 'formal',
|
|
||||||
example: 'Thank you for your principled contribution grounded in privacy rights theory.'
|
|
||||||
},
|
|
||||||
CASUAL_DIRECT: {
|
|
||||||
name: 'Casual Direct (Australian/NZ)',
|
|
||||||
characteristics: ['directness', 'anti-tall-poppy', 'informal', 'pragmatic'],
|
|
||||||
tone: 'casual',
|
|
||||||
pub_test: true, // Would this sound awkward in casual pub conversation?
|
|
||||||
example: 'Right, here\'s where we landed: Save lives first, but only when it\'s genuinely urgent.'
|
|
||||||
},
|
|
||||||
MAORI_PROTOCOL: {
|
|
||||||
name: 'Te Reo Māori Protocol',
|
|
||||||
characteristics: ['mihi', 'whanaungatanga', 'collective framing', 'taonga respect'],
|
|
||||||
tone: 'respectful',
|
|
||||||
cultural_elements: ['kia ora', 'ngā mihi', 'whānau', 'kōrero', 'whakaaro', 'kei te pai'],
|
|
||||||
example: 'Kia ora [Name]. Ngā mihi for bringing the voice of your whānau to this kōrero.'
|
|
||||||
},
|
|
||||||
JAPANESE_FORMAL: {
|
|
||||||
name: 'Japanese Formal (Honne/Tatemae aware)',
|
|
||||||
characteristics: ['indirect', 'high context', 'relationship-focused', 'face-saving'],
|
|
||||||
tone: 'formal',
|
|
||||||
cultural_concepts: ['honne', 'tatemae', 'wa', 'uchi/soto'],
|
|
||||||
example: 'We have carefully considered your valued perspective in reaching this decision.'
|
|
||||||
},
|
|
||||||
PLAIN_LANGUAGE: {
|
|
||||||
name: 'Plain Language',
|
|
||||||
characteristics: ['simple', 'clear', 'accessible', 'non-jargon'],
|
|
||||||
tone: 'neutral',
|
|
||||||
example: 'We decided to prioritize safety in this case. Here\'s why...'
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Patronizing terms to filter (inst_030)
|
|
||||||
*/
|
|
||||||
const PATRONIZING_PATTERNS = [
|
|
||||||
{ pattern: /\bsimply\b/gi, reason: 'Implies task is trivial' },
|
|
||||||
{ pattern: /\bobviously\b/gi, reason: 'Dismisses difficulty' },
|
|
||||||
{ pattern: /\bclearly\b/gi, reason: 'Assumes shared understanding' },
|
|
||||||
{ pattern: /\bas you may know\b/gi, reason: 'Condescending hedge' },
|
|
||||||
{ pattern: /\bof course\b/gi, reason: 'Assumes obviousness' },
|
|
||||||
{ pattern: /\bjust\b(?= (do|make|use|try))/gi, reason: 'Minimizes complexity' },
|
|
||||||
{ pattern: /\bbasically\b/gi, reason: 'Can be condescending' }
|
|
||||||
];
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Language detection patterns (basic - production would use proper i18n library)
|
|
||||||
*/
|
|
||||||
const LANGUAGE_PATTERNS = {
|
|
||||||
'te-reo-maori': /\b(kia ora|ngā mihi|whānau|kōrero|aroha|mana|taonga)\b/i,
|
|
||||||
'japanese': /[\u3040-\u309F\u30A0-\u30FF\u4E00-\u9FAF]/,
|
|
||||||
'spanish': /\b(hola|gracias|por favor|señor|señora)\b/i,
|
|
||||||
'french': /\b(bonjour|merci|monsieur|madame)\b/i,
|
|
||||||
'german': /\b(guten tag|danke|herr|frau)\b/i
|
|
||||||
};
|
|
||||||
|
|
||||||
class AdaptiveCommunicationOrchestrator {
|
|
||||||
constructor() {
|
|
||||||
this.styles = COMMUNICATION_STYLES;
|
|
||||||
this.patronizingPatterns = PATRONIZING_PATTERNS;
|
|
||||||
this.languagePatterns = LANGUAGE_PATTERNS;
|
|
||||||
|
|
||||||
// Statistics tracking
|
|
||||||
this.stats = {
|
|
||||||
total_adaptations: 0,
|
|
||||||
by_style: {
|
|
||||||
FORMAL_ACADEMIC: 0,
|
|
||||||
CASUAL_DIRECT: 0,
|
|
||||||
MAORI_PROTOCOL: 0,
|
|
||||||
JAPANESE_FORMAL: 0,
|
|
||||||
PLAIN_LANGUAGE: 0
|
|
||||||
},
|
|
||||||
patronizing_terms_removed: 0,
|
|
||||||
languages_detected: {}
|
|
||||||
};
|
|
||||||
|
|
||||||
logger.info('AdaptiveCommunicationOrchestrator initialized');
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Adapt communication to target audience style
|
|
||||||
* @param {String} message - The message to adapt
|
|
||||||
* @param {Object} context - Audience context
|
|
||||||
* @returns {String} Adapted message
|
|
||||||
*/
|
|
||||||
adaptCommunication(message, context = {}) {
|
|
||||||
try {
|
|
||||||
let adaptedMessage = message;
|
|
||||||
|
|
||||||
// 1. Detect input language (inst_032)
|
|
||||||
const detectedLanguage = this._detectLanguage(message);
|
|
||||||
if (detectedLanguage && detectedLanguage !== 'english') {
|
|
||||||
logger.info('Non-English language detected', { language: detectedLanguage });
|
|
||||||
// In production, would trigger translation workflow
|
|
||||||
}
|
|
||||||
|
|
||||||
// 2. Apply anti-patronizing filter (inst_030)
|
|
||||||
adaptedMessage = this._removePatronizingLanguage(adaptedMessage);
|
|
||||||
|
|
||||||
// 3. Adapt to target communication style (inst_029)
|
|
||||||
const targetStyle = context.audience || 'PLAIN_LANGUAGE';
|
|
||||||
adaptedMessage = this._adaptToStyle(adaptedMessage, targetStyle, context);
|
|
||||||
|
|
||||||
// 4. Apply regional/cultural adaptations (inst_031)
|
|
||||||
if (context.cultural_context) {
|
|
||||||
adaptedMessage = this._applyCulturalContext(adaptedMessage, context.cultural_context);
|
|
||||||
}
|
|
||||||
|
|
||||||
this.stats.total_adaptations++;
|
|
||||||
if (this.stats.by_style[targetStyle] !== undefined) {
|
|
||||||
this.stats.by_style[targetStyle]++;
|
|
||||||
}
|
|
||||||
|
|
||||||
return adaptedMessage;
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Communication adaptation error:', error);
|
|
||||||
// Fallback: return original message
|
|
||||||
return message;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Check if message passes pub test (inst_029)
|
|
||||||
* Would this sound awkward in casual Australian/NZ pub conversation?
|
|
||||||
* @param {String} message - The message to check
|
|
||||||
* @returns {Object} Pub test result
|
|
||||||
*/
|
|
||||||
pubTest(message) {
|
|
||||||
const awkwardIndicators = [
|
|
||||||
{ pattern: /\bhereby\b/gi, reason: 'Too formal/legal' },
|
|
||||||
{ pattern: /\bforthwith\b/gi, reason: 'Archaic formal' },
|
|
||||||
{ pattern: /\bnotwithstanding\b/gi, reason: 'Unnecessarily complex' },
|
|
||||||
{ pattern: /\bpursuant to\b/gi, reason: 'Overly legal' },
|
|
||||||
{ pattern: /\bin accordance with\b/gi, reason: 'Bureaucratic' },
|
|
||||||
{ pattern: /\bas per\b/gi, reason: 'Business jargon' }
|
|
||||||
];
|
|
||||||
|
|
||||||
const violations = [];
|
|
||||||
|
|
||||||
for (const indicator of awkwardIndicators) {
|
|
||||||
const matches = message.match(indicator.pattern);
|
|
||||||
if (matches) {
|
|
||||||
violations.push({
|
|
||||||
term: matches[0],
|
|
||||||
reason: indicator.reason,
|
|
||||||
suggestion: 'Use simpler, conversational language'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return {
|
|
||||||
passes: violations.length === 0,
|
|
||||||
violations,
|
|
||||||
message: violations.length === 0
|
|
||||||
? 'Message passes pub test - sounds natural in casual conversation'
|
|
||||||
: 'Message would sound awkward in casual pub conversation'
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Detect communication style from incoming message
|
|
||||||
* @param {String} message - The message to analyze
|
|
||||||
* @returns {String} Detected style key
|
|
||||||
*/
|
|
||||||
detectStyle(message) {
|
|
||||||
const lowerMessage = message.toLowerCase();
|
|
||||||
|
|
||||||
// Check for Māori protocol indicators
|
|
||||||
if (this.languagePatterns['te-reo-maori'].test(message)) {
|
|
||||||
return 'MAORI_PROTOCOL';
|
|
||||||
}
|
|
||||||
|
|
||||||
// Check for formal academic indicators
|
|
||||||
const formalIndicators = ['furthermore', 'notwithstanding', 'pursuant to', 'hereby', 'therefore'];
|
|
||||||
const formalCount = formalIndicators.filter(term => lowerMessage.includes(term)).length;
|
|
||||||
if (formalCount >= 2) {
|
|
||||||
return 'FORMAL_ACADEMIC';
|
|
||||||
}
|
|
||||||
|
|
||||||
// Check for casual/direct indicators
|
|
||||||
const casualIndicators = ['right,', 'ok,', 'yeah,', 'fair?', 'reckon', 'mate'];
|
|
||||||
const casualCount = casualIndicators.filter(term => lowerMessage.includes(term)).length;
|
|
||||||
if (casualCount >= 1) {
|
|
||||||
return 'CASUAL_DIRECT';
|
|
||||||
}
|
|
||||||
|
|
||||||
// Default to plain language
|
|
||||||
return 'PLAIN_LANGUAGE';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate culturally-adapted greeting
|
|
||||||
* @param {String} recipientName - Name of recipient
|
|
||||||
* @param {Object} context - Cultural context
|
|
||||||
* @returns {String} Appropriate greeting
|
|
||||||
*/
|
|
||||||
generateGreeting(recipientName, context = {}) {
|
|
||||||
const style = context.communication_style || 'PLAIN_LANGUAGE';
|
|
||||||
|
|
||||||
switch (style) {
|
|
||||||
case 'MAORI_PROTOCOL':
|
|
||||||
return `Kia ora ${recipientName}`;
|
|
||||||
case 'JAPANESE_FORMAL':
|
|
||||||
return `${recipientName}様、いつもお世話になっております。`; // Formal Japanese greeting
|
|
||||||
case 'CASUAL_DIRECT':
|
|
||||||
return `Hi ${recipientName}`;
|
|
||||||
case 'FORMAL_ACADEMIC':
|
|
||||||
return `Dear ${recipientName},`;
|
|
||||||
default:
|
|
||||||
return `Hello ${recipientName}`;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Private helper methods
|
|
||||||
*/
|
|
||||||
|
|
||||||
_detectLanguage(message) {
|
|
||||||
for (const [language, pattern] of Object.entries(this.languagePatterns)) {
|
|
||||||
if (pattern.test(message)) {
|
|
||||||
// Track language detection
|
|
||||||
if (!this.stats.languages_detected[language]) {
|
|
||||||
this.stats.languages_detected[language] = 0;
|
|
||||||
}
|
|
||||||
this.stats.languages_detected[language]++;
|
|
||||||
|
|
||||||
return language;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return 'english'; // Default assumption
|
|
||||||
}
|
|
||||||
|
|
||||||
_removePatronizingLanguage(message) {
|
|
||||||
let cleaned = message;
|
|
||||||
let removedCount = 0;
|
|
||||||
|
|
||||||
for (const { pattern, reason } of this.patronizingPatterns) {
|
|
||||||
const beforeLength = cleaned.length;
|
|
||||||
cleaned = cleaned.replace(pattern, '');
|
|
||||||
const afterLength = cleaned.length;
|
|
||||||
|
|
||||||
if (beforeLength !== afterLength) {
|
|
||||||
removedCount++;
|
|
||||||
logger.debug('Removed patronizing term', { reason });
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if (removedCount > 0) {
|
|
||||||
this.stats.patronizing_terms_removed += removedCount;
|
|
||||||
// Clean up extra spaces left by removals
|
|
||||||
cleaned = cleaned.replace(/\s{2,}/g, ' ').trim();
|
|
||||||
}
|
|
||||||
|
|
||||||
return cleaned;
|
|
||||||
}
|
|
||||||
|
|
||||||
_adaptToStyle(message, styleKey, context) {
|
|
||||||
const style = this.styles[styleKey];
|
|
||||||
|
|
||||||
if (!style) {
|
|
||||||
logger.warn('Unknown communication style', { styleKey });
|
|
||||||
return message;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Style-specific adaptations
|
|
||||||
switch (styleKey) {
|
|
||||||
case 'FORMAL_ACADEMIC':
|
|
||||||
return this._adaptToFormalAcademic(message, context);
|
|
||||||
case 'CASUAL_DIRECT':
|
|
||||||
return this._adaptToCasualDirect(message, context);
|
|
||||||
case 'MAORI_PROTOCOL':
|
|
||||||
return this._adaptToMaoriProtocol(message, context);
|
|
||||||
case 'JAPANESE_FORMAL':
|
|
||||||
return this._adaptToJapaneseFormal(message, context);
|
|
||||||
case 'PLAIN_LANGUAGE':
|
|
||||||
return this._adaptToPlainLanguage(message, context);
|
|
||||||
default:
|
|
||||||
return message;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
_adaptToFormalAcademic(message, context) {
|
|
||||||
// Add formal register, hedge appropriately
|
|
||||||
// (In production, would use NLP transformation)
|
|
||||||
return message;
|
|
||||||
}
|
|
||||||
|
|
||||||
_adaptToCasualDirect(message, context) {
|
|
||||||
// Remove unnecessary formality, make direct
|
|
||||||
let adapted = message;
|
|
||||||
|
|
||||||
// Replace formal phrases with casual equivalents
|
|
||||||
const replacements = [
|
|
||||||
{ formal: /I would like to inform you that/gi, casual: 'Just so you know,' },
|
|
||||||
{ formal: /It is important to note that/gi, casual: 'Key thing:' },
|
|
||||||
{ formal: /We have determined that/gi, casual: 'We figured' },
|
|
||||||
{ formal: /In accordance with/gi, casual: 'Following' }
|
|
||||||
];
|
|
||||||
|
|
||||||
for (const { formal, casual } of replacements) {
|
|
||||||
adapted = adapted.replace(formal, casual);
|
|
||||||
}
|
|
||||||
|
|
||||||
return adapted;
|
|
||||||
}
|
|
||||||
|
|
||||||
_adaptToMaoriProtocol(message, context) {
|
|
||||||
// Add appropriate te reo Māori protocol elements
|
|
||||||
// (In production, would consult with Māori language experts)
|
|
||||||
return message;
|
|
||||||
}
|
|
||||||
|
|
||||||
_adaptToJapaneseFormal(message, context) {
|
|
||||||
// Add appropriate Japanese formal register elements
|
|
||||||
// (In production, would use Japanese language processing)
|
|
||||||
return message;
|
|
||||||
}
|
|
||||||
|
|
||||||
_adaptToPlainLanguage(message, context) {
|
|
||||||
// Simplify jargon, use clear language
|
|
||||||
let adapted = message;
|
|
||||||
|
|
||||||
// Replace jargon with plain equivalents
|
|
||||||
const jargonReplacements = [
|
|
||||||
{ jargon: /utilize/gi, plain: 'use' },
|
|
||||||
{ jargon: /facilitate/gi, plain: 'help' },
|
|
||||||
{ jargon: /implement/gi, plain: 'do' },
|
|
||||||
{ jargon: /endeavor/gi, plain: 'try' }
|
|
||||||
];
|
|
||||||
|
|
||||||
for (const { jargon, plain } of jargonReplacements) {
|
|
||||||
adapted = adapted.replace(jargon, plain);
|
|
||||||
}
|
|
||||||
|
|
||||||
return adapted;
|
|
||||||
}
|
|
||||||
|
|
||||||
_applyCulturalContext(message, culturalContext) {
|
|
||||||
// Apply cultural adaptations based on context
|
|
||||||
// (In production, would be much more sophisticated)
|
|
||||||
return message;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get communication adaptation statistics
|
|
||||||
* @returns {Object} Statistics object
|
|
||||||
*/
|
|
||||||
getStats() {
|
|
||||||
return {
|
|
||||||
...this.stats,
|
|
||||||
timestamp: new Date()
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Singleton instance
|
|
||||||
const orchestrator = new AdaptiveCommunicationOrchestrator();
|
|
||||||
|
|
||||||
// Export both singleton (default) and class (for testing)
|
|
||||||
module.exports = orchestrator;
|
|
||||||
module.exports.AdaptiveCommunicationOrchestrator = AdaptiveCommunicationOrchestrator;
|
|
||||||
|
|
@ -1,609 +0,0 @@
|
||||||
/**
|
|
||||||
* Blog Curation Service
|
|
||||||
*
|
|
||||||
* AI-assisted blog content curation with mandatory human oversight.
|
|
||||||
* Implements Tractatus framework boundary enforcement for content generation.
|
|
||||||
*
|
|
||||||
* Governance: TRA-OPS-0002 (AI suggests, human decides)
|
|
||||||
* Boundary Rules:
|
|
||||||
* - inst_016: NEVER fabricate statistics or make unverifiable claims
|
|
||||||
* - inst_017: NEVER use absolute assurance terms (guarantee, ensures 100%, etc.)
|
|
||||||
* - inst_018: NEVER claim production-ready status without evidence
|
|
||||||
*
|
|
||||||
* All AI-generated content MUST be reviewed and approved by a human before publication.
|
|
||||||
*/
|
|
||||||
|
|
||||||
const claudeAPI = require('./ClaudeAPI.service');
|
|
||||||
const BoundaryEnforcer = require('./BoundaryEnforcer.service');
|
|
||||||
const { getMemoryProxy } = require('./MemoryProxy.service');
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
|
|
||||||
class BlogCurationService {
|
|
||||||
constructor() {
|
|
||||||
// Initialize MemoryProxy for governance rule persistence and audit logging
|
|
||||||
this.memoryProxy = getMemoryProxy();
|
|
||||||
this.enforcementRules = {}; // Will load inst_016, inst_017, inst_018
|
|
||||||
this.memoryProxyInitialized = false;
|
|
||||||
|
|
||||||
// Editorial guidelines - core principles for blog content
|
|
||||||
this.editorialGuidelines = {
|
|
||||||
tone: 'Professional, informative, evidence-based',
|
|
||||||
voice: 'Third-person objective (AI safety framework documentation)',
|
|
||||||
style: 'Clear, accessible technical writing',
|
|
||||||
principles: [
|
|
||||||
'Transparency: Cite sources for all claims',
|
|
||||||
'Honesty: Acknowledge limitations and unknowns',
|
|
||||||
'Evidence: No fabricated statistics or unverifiable claims',
|
|
||||||
'Humility: No absolute guarantees or 100% assurances',
|
|
||||||
'Accuracy: Production status claims must have evidence'
|
|
||||||
],
|
|
||||||
forbiddenPatterns: [
|
|
||||||
'Fabricated statistics without sources',
|
|
||||||
'Absolute terms: guarantee, ensures 100%, never fails, always works',
|
|
||||||
'Unverified production claims: battle-tested (without evidence), industry-standard (without adoption metrics)',
|
|
||||||
'Emotional manipulation or fear-mongering',
|
|
||||||
'Misleading comparisons or false dichotomies'
|
|
||||||
],
|
|
||||||
targetWordCounts: {
|
|
||||||
short: '600-900 words',
|
|
||||||
medium: '1000-1500 words',
|
|
||||||
long: '1800-2500 words'
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Initialize MemoryProxy and load enforcement rules
|
|
||||||
* @returns {Promise<Object>} Initialization result
|
|
||||||
*/
|
|
||||||
async initialize() {
|
|
||||||
try {
|
|
||||||
await this.memoryProxy.initialize();
|
|
||||||
|
|
||||||
// Load critical enforcement rules from memory
|
|
||||||
const criticalRuleIds = ['inst_016', 'inst_017', 'inst_018'];
|
|
||||||
let rulesLoaded = 0;
|
|
||||||
|
|
||||||
for (const ruleId of criticalRuleIds) {
|
|
||||||
const rule = await this.memoryProxy.getRule(ruleId);
|
|
||||||
if (rule) {
|
|
||||||
this.enforcementRules[ruleId] = rule;
|
|
||||||
rulesLoaded++;
|
|
||||||
} else {
|
|
||||||
logger.warn(`[BlogCuration] Enforcement rule ${ruleId} not found in memory`);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
this.memoryProxyInitialized = true;
|
|
||||||
|
|
||||||
logger.info('[BlogCuration] MemoryProxy initialized', {
|
|
||||||
rulesLoaded,
|
|
||||||
totalCriticalRules: criticalRuleIds.length
|
|
||||||
});
|
|
||||||
|
|
||||||
return {
|
|
||||||
success: true,
|
|
||||||
rulesLoaded,
|
|
||||||
enforcementRules: Object.keys(this.enforcementRules)
|
|
||||||
};
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[BlogCuration] Failed to initialize MemoryProxy', {
|
|
||||||
error: error.message
|
|
||||||
});
|
|
||||||
// Continue with existing validation logic even if memory fails
|
|
||||||
return {
|
|
||||||
success: false,
|
|
||||||
error: error.message,
|
|
||||||
rulesLoaded: 0
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Draft a full blog post using AI
|
|
||||||
*
|
|
||||||
* @param {Object} params - Blog post parameters
|
|
||||||
* @param {string} params.topic - Blog post topic/title
|
|
||||||
* @param {string} params.audience - Target audience (researcher/implementer/advocate)
|
|
||||||
* @param {string} params.length - Desired length (short/medium/long)
|
|
||||||
* @param {string} params.focus - Optional focus area or angle
|
|
||||||
* @returns {Promise<Object>} Draft blog post with metadata
|
|
||||||
*/
|
|
||||||
async draftBlogPost(params) {
|
|
||||||
const { topic, audience, length = 'medium', focus } = params;
|
|
||||||
|
|
||||||
logger.info(`[BlogCuration] Drafting blog post: "${topic}" for ${audience}`);
|
|
||||||
|
|
||||||
// 1. Boundary check - content generation requires human oversight
|
|
||||||
const boundaryCheck = BoundaryEnforcer.enforce({
|
|
||||||
description: 'Generate AI-drafted blog content for human review',
|
|
||||||
text: 'Blog post will be queued for mandatory human approval before publication',
|
|
||||||
classification: { quadrant: 'OPERATIONAL' },
|
|
||||||
type: 'content_generation'
|
|
||||||
});
|
|
||||||
|
|
||||||
if (!boundaryCheck.allowed) {
|
|
||||||
logger.warn(`[BlogCuration] Boundary check failed: ${boundaryCheck.reasoning}`);
|
|
||||||
throw new Error(`Boundary violation: ${boundaryCheck.reasoning}`);
|
|
||||||
}
|
|
||||||
|
|
||||||
// 2. Build system prompt with editorial guidelines and Tractatus constraints
|
|
||||||
const systemPrompt = this._buildSystemPrompt(audience);
|
|
||||||
|
|
||||||
// 3. Build user prompt for blog post generation
|
|
||||||
const userPrompt = this._buildDraftPrompt(topic, audience, length, focus);
|
|
||||||
|
|
||||||
// 4. Call Claude API
|
|
||||||
const messages = [{ role: 'user', content: userPrompt }];
|
|
||||||
|
|
||||||
try {
|
|
||||||
const response = await claudeAPI.sendMessage(messages, {
|
|
||||||
system: systemPrompt,
|
|
||||||
max_tokens: this._getMaxTokens(length),
|
|
||||||
temperature: 0.7 // Balanced creativity and consistency
|
|
||||||
});
|
|
||||||
|
|
||||||
const content = claudeAPI.extractJSON(response);
|
|
||||||
|
|
||||||
// 5. Validate generated content against Tractatus principles
|
|
||||||
const validation = await this._validateContent(content);
|
|
||||||
|
|
||||||
// 6. Return draft with validation results
|
|
||||||
return {
|
|
||||||
draft: content,
|
|
||||||
validation,
|
|
||||||
boundary_check: boundaryCheck,
|
|
||||||
metadata: {
|
|
||||||
generated_at: new Date(),
|
|
||||||
model: response.model,
|
|
||||||
usage: response.usage,
|
|
||||||
audience,
|
|
||||||
length,
|
|
||||||
requires_human_approval: true
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[BlogCuration] Draft generation failed:', error);
|
|
||||||
throw new Error(`Blog draft generation failed: ${error.message}`);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Suggest blog topics based on audience and existing documents
|
|
||||||
* (Fetches documents from site as context for topic generation)
|
|
||||||
*
|
|
||||||
* @param {string} audience - Target audience
|
|
||||||
* @param {string} theme - Optional theme/focus
|
|
||||||
* @returns {Promise<Array>} Topic suggestions with metadata
|
|
||||||
*/
|
|
||||||
async suggestTopics(audience, theme = null) {
|
|
||||||
logger.info(`[BlogCuration] Suggesting topics: audience=${audience}, theme=${theme || 'general'}`);
|
|
||||||
|
|
||||||
try {
|
|
||||||
// Fetch existing documents as context
|
|
||||||
const Document = require('../models/Document.model');
|
|
||||||
const documents = await Document.list({ limit: 20, skip: 0 });
|
|
||||||
|
|
||||||
// Build context from document titles and summaries
|
|
||||||
const documentContext = documents.map(doc => ({
|
|
||||||
title: doc.title,
|
|
||||||
slug: doc.slug,
|
|
||||||
summary: doc.summary || doc.description || ''
|
|
||||||
}));
|
|
||||||
|
|
||||||
// Generate topics with document context
|
|
||||||
const systemPrompt = `You are a content strategist for the Tractatus AI Safety Framework.
|
|
||||||
Your role is to suggest blog post topics that educate audiences about AI safety through sovereignty,
|
|
||||||
transparency, harmlessness, and community principles.
|
|
||||||
|
|
||||||
The framework prevents AI from making irreducible human decisions and requires human oversight
|
|
||||||
for all values-sensitive choices.
|
|
||||||
|
|
||||||
EXISTING DOCUMENTS ON SITE:
|
|
||||||
${documentContext.map(d => `- ${d.title}: ${d.summary}`).join('\n')}
|
|
||||||
|
|
||||||
Suggest topics that:
|
|
||||||
1. Complement existing content (don't duplicate)
|
|
||||||
2. Address gaps in current documentation
|
|
||||||
3. Provide practical insights for ${audience} audience
|
|
||||||
4. Maintain Tractatus principles (no fabricated stats, no absolute guarantees)`;
|
|
||||||
|
|
||||||
const userPrompt = theme
|
|
||||||
? `Based on the existing documents above, suggest 5-7 NEW blog post topics for ${audience} audience focused on: ${theme}
|
|
||||||
|
|
||||||
For each topic, provide:
|
|
||||||
{
|
|
||||||
"title": "compelling, specific title",
|
|
||||||
"rationale": "why this topic fills a gap or complements existing content",
|
|
||||||
"target_word_count": 800-1500,
|
|
||||||
"key_points": ["3-5 bullet points"],
|
|
||||||
"tractatus_angle": "how it relates to framework principles"
|
|
||||||
}
|
|
||||||
|
|
||||||
Respond with JSON array.`
|
|
||||||
: `Based on the existing documents above, suggest 5-7 NEW blog post topics for ${audience} audience about the Tractatus AI Safety Framework.
|
|
||||||
|
|
||||||
For each topic, provide:
|
|
||||||
{
|
|
||||||
"title": "compelling, specific title",
|
|
||||||
"rationale": "why this topic fills a gap or complements existing content",
|
|
||||||
"target_word_count": 800-1500,
|
|
||||||
"key_points": ["3-5 bullet points"],
|
|
||||||
"tractatus_angle": "how it relates to framework principles"
|
|
||||||
}
|
|
||||||
|
|
||||||
Respond with JSON array.`;
|
|
||||||
|
|
||||||
const messages = [{ role: 'user', content: userPrompt }];
|
|
||||||
|
|
||||||
const response = await claudeAPI.sendMessage(messages, {
|
|
||||||
system: systemPrompt,
|
|
||||||
max_tokens: 2048
|
|
||||||
});
|
|
||||||
|
|
||||||
const topics = claudeAPI.extractJSON(response);
|
|
||||||
|
|
||||||
// Validate topics don't contain forbidden patterns
|
|
||||||
const validatedTopics = topics.map(topic => ({
|
|
||||||
...topic,
|
|
||||||
validation: this._validateTopicTitle(topic.title)
|
|
||||||
}));
|
|
||||||
|
|
||||||
return validatedTopics;
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[BlogCuration] Topic suggestion failed:', error);
|
|
||||||
throw new Error(`Topic suggestion failed: ${error.message}`);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Analyze existing blog content for Tractatus compliance
|
|
||||||
*
|
|
||||||
* @param {Object} content - Blog post content {title, body}
|
|
||||||
* @returns {Promise<Object>} Compliance analysis
|
|
||||||
*/
|
|
||||||
async analyzeContentCompliance(content) {
|
|
||||||
const { title, body } = content;
|
|
||||||
|
|
||||||
logger.info(`[BlogCuration] Analyzing content compliance: "${title}"`);
|
|
||||||
|
|
||||||
const systemPrompt = `You are a Tractatus Framework compliance auditor.
|
|
||||||
Analyze content for violations of these principles:
|
|
||||||
|
|
||||||
1. NEVER fabricate statistics or make unverifiable claims
|
|
||||||
2. NEVER use absolute assurance terms (guarantee, ensures 100%, never fails, always works)
|
|
||||||
3. NEVER claim production-ready status without concrete evidence
|
|
||||||
4. ALWAYS cite sources for statistics and claims
|
|
||||||
5. ALWAYS acknowledge limitations and unknowns
|
|
||||||
|
|
||||||
Return JSON with compliance analysis.`;
|
|
||||||
|
|
||||||
const userPrompt = `Analyze this blog post for Tractatus compliance:
|
|
||||||
|
|
||||||
Title: ${title}
|
|
||||||
|
|
||||||
Content:
|
|
||||||
${body}
|
|
||||||
|
|
||||||
Respond with JSON:
|
|
||||||
{
|
|
||||||
"compliant": true/false,
|
|
||||||
"violations": [
|
|
||||||
{
|
|
||||||
"type": "FABRICATED_STAT|ABSOLUTE_CLAIM|UNVERIFIED_PRODUCTION|OTHER",
|
|
||||||
"severity": "HIGH|MEDIUM|LOW",
|
|
||||||
"excerpt": "problematic text snippet",
|
|
||||||
"reasoning": "why this violates principles",
|
|
||||||
"suggested_fix": "how to correct it"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"warnings": ["..."],
|
|
||||||
"strengths": ["..."],
|
|
||||||
"overall_score": 0-100,
|
|
||||||
"recommendation": "PUBLISH|EDIT_REQUIRED|REJECT"
|
|
||||||
}`;
|
|
||||||
|
|
||||||
const messages = [{ role: 'user', content: userPrompt }];
|
|
||||||
|
|
||||||
try {
|
|
||||||
const response = await claudeAPI.sendMessage(messages, {
|
|
||||||
system: systemPrompt,
|
|
||||||
max_tokens: 2048
|
|
||||||
});
|
|
||||||
|
|
||||||
return claudeAPI.extractJSON(response);
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[BlogCuration] Compliance analysis failed:', error);
|
|
||||||
throw new Error(`Compliance analysis failed: ${error.message}`);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate SEO-friendly slug from title
|
|
||||||
*
|
|
||||||
* @param {string} title - Blog post title
|
|
||||||
* @returns {string} URL-safe slug
|
|
||||||
*/
|
|
||||||
generateSlug(title) {
|
|
||||||
return title
|
|
||||||
.toLowerCase()
|
|
||||||
.replace(/[^a-z0-9]+/g, '-')
|
|
||||||
.replace(/^-|-$/g, '')
|
|
||||||
.substring(0, 100);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Extract excerpt from blog content
|
|
||||||
*
|
|
||||||
* @param {string} content - Full blog content (HTML or markdown)
|
|
||||||
* @param {number} maxLength - Maximum excerpt length (default 200)
|
|
||||||
* @returns {string} Excerpt
|
|
||||||
*/
|
|
||||||
extractExcerpt(content, maxLength = 200) {
|
|
||||||
// Strip HTML/markdown tags
|
|
||||||
const plainText = content
|
|
||||||
.replace(/<[^>]*>/g, '')
|
|
||||||
.replace(/[#*_`]/g, '')
|
|
||||||
.trim();
|
|
||||||
|
|
||||||
if (plainText.length <= maxLength) {
|
|
||||||
return plainText;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Find last complete sentence within maxLength
|
|
||||||
const excerpt = plainText.substring(0, maxLength);
|
|
||||||
const lastPeriod = excerpt.lastIndexOf('.');
|
|
||||||
|
|
||||||
if (lastPeriod > maxLength * 0.5) {
|
|
||||||
return excerpt.substring(0, lastPeriod + 1);
|
|
||||||
}
|
|
||||||
|
|
||||||
return excerpt.substring(0, maxLength).trim() + '...';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Build system prompt with editorial guidelines
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
_buildSystemPrompt(audience) {
|
|
||||||
const audienceContext = {
|
|
||||||
researcher: 'Academic researchers, AI safety specialists, technical analysts',
|
|
||||||
implementer: 'Software engineers, system architects, technical decision-makers',
|
|
||||||
advocate: 'Policy makers, ethicists, public stakeholders, non-technical audiences',
|
|
||||||
general: 'Mixed audience with varying technical backgrounds'
|
|
||||||
};
|
|
||||||
|
|
||||||
return `You are a professional technical writer creating content for the Tractatus AI Safety Framework blog.
|
|
||||||
|
|
||||||
AUDIENCE: ${audienceContext[audience] || audienceContext.general}
|
|
||||||
|
|
||||||
TRACTATUS FRAMEWORK CORE PRINCIPLES:
|
|
||||||
1. What cannot be systematized must not be automated
|
|
||||||
2. AI must never make irreducible human decisions
|
|
||||||
3. Sovereignty: User agency over values and goals
|
|
||||||
4. Transparency: Explicit instructions, audit trails, governance logs
|
|
||||||
5. Harmlessness: Boundary enforcement prevents values automation
|
|
||||||
6. Community: Open frameworks, shared governance patterns
|
|
||||||
|
|
||||||
EDITORIAL GUIDELINES:
|
|
||||||
- Tone: ${this.editorialGuidelines.tone}
|
|
||||||
- Voice: ${this.editorialGuidelines.voice}
|
|
||||||
- Style: ${this.editorialGuidelines.style}
|
|
||||||
|
|
||||||
MANDATORY CONSTRAINTS (inst_016, inst_017, inst_018):
|
|
||||||
${this.editorialGuidelines.principles.map(p => `- ${p}`).join('\n')}
|
|
||||||
|
|
||||||
FORBIDDEN PATTERNS:
|
|
||||||
${this.editorialGuidelines.forbiddenPatterns.map(p => `- ${p}`).join('\n')}
|
|
||||||
|
|
||||||
OUTPUT FORMAT: JSON with structure:
|
|
||||||
{
|
|
||||||
"title": "SEO-friendly title (60 chars max)",
|
|
||||||
"subtitle": "Compelling subtitle (120 chars max)",
|
|
||||||
"content": "Full blog post content in Markdown format",
|
|
||||||
"excerpt": "Brief excerpt (150-200 chars)",
|
|
||||||
"tags": ["tag1", "tag2", "tag3"],
|
|
||||||
"tractatus_angle": "How this relates to framework principles",
|
|
||||||
"sources": ["URL or reference for claims made"],
|
|
||||||
"word_count": actual_word_count
|
|
||||||
}`;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Build user prompt for blog post draft
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
_buildDraftPrompt(topic, audience, length, focus) {
|
|
||||||
const wordCount = {
|
|
||||||
short: '600-900',
|
|
||||||
medium: '1000-1500',
|
|
||||||
long: '1800-2500'
|
|
||||||
}[length] || '1000-1500';
|
|
||||||
|
|
||||||
let prompt = `Write a blog post about: ${topic}
|
|
||||||
|
|
||||||
Target word count: ${wordCount} words
|
|
||||||
Audience: ${audience}`;
|
|
||||||
|
|
||||||
if (focus) {
|
|
||||||
prompt += `\nSpecific focus: ${focus}`;
|
|
||||||
}
|
|
||||||
|
|
||||||
prompt += `
|
|
||||||
|
|
||||||
Requirements:
|
|
||||||
1. Evidence-based: Cite sources for all statistics and claims
|
|
||||||
2. Honest: Acknowledge limitations, unknowns, trade-offs
|
|
||||||
3. No fabricated data or unverifiable claims
|
|
||||||
4. No absolute guarantees or 100% assurances
|
|
||||||
5. Clear connection to Tractatus framework principles
|
|
||||||
6. Actionable insights or takeaways for the ${audience} audience
|
|
||||||
7. SEO-friendly structure with headers, lists, and clear sections
|
|
||||||
|
|
||||||
Respond with JSON as specified in the system prompt.`;
|
|
||||||
|
|
||||||
return prompt;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get max tokens based on target length
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
_getMaxTokens(length) {
|
|
||||||
const tokenMap = {
|
|
||||||
short: 2048,
|
|
||||||
medium: 3072,
|
|
||||||
long: 4096
|
|
||||||
};
|
|
||||||
return tokenMap[length] || 3072;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Validate content against Tractatus principles
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
async _validateContent(content) {
|
|
||||||
const violations = [];
|
|
||||||
const warnings = [];
|
|
||||||
|
|
||||||
const textToCheck = `${content.title} ${content.subtitle} ${content.content}`.toLowerCase();
|
|
||||||
|
|
||||||
// Check for forbidden patterns (inst_016, inst_017, inst_018)
|
|
||||||
const forbiddenTerms = {
|
|
||||||
absolute_guarantees: ['guarantee', 'guarantees', 'guaranteed', 'ensures 100%', 'never fails', 'always works', '100% safe', '100% secure'],
|
|
||||||
fabricated_stats: [], // Can't detect without external validation
|
|
||||||
unverified_production: ['battle-tested', 'production-proven', 'industry-standard']
|
|
||||||
};
|
|
||||||
|
|
||||||
// Check absolute guarantees (inst_017)
|
|
||||||
forbiddenTerms.absolute_guarantees.forEach(term => {
|
|
||||||
if (textToCheck.includes(term)) {
|
|
||||||
violations.push({
|
|
||||||
type: 'ABSOLUTE_GUARANTEE',
|
|
||||||
severity: 'HIGH',
|
|
||||||
term,
|
|
||||||
instruction: 'inst_017',
|
|
||||||
message: `Forbidden absolute assurance term: "${term}"`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Check unverified production claims (inst_018)
|
|
||||||
forbiddenTerms.unverified_production.forEach(term => {
|
|
||||||
if (textToCheck.includes(term) && (!content.sources || content.sources.length === 0)) {
|
|
||||||
warnings.push({
|
|
||||||
type: 'UNVERIFIED_CLAIM',
|
|
||||||
severity: 'MEDIUM',
|
|
||||||
term,
|
|
||||||
instruction: 'inst_018',
|
|
||||||
message: `Production claim "${term}" requires citation`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Check for uncited statistics (inst_016)
|
|
||||||
const statPattern = /\d+(\.\d+)?%/g;
|
|
||||||
const statsFound = (content.content.match(statPattern) || []).length;
|
|
||||||
|
|
||||||
if (statsFound > 0 && (!content.sources || content.sources.length === 0)) {
|
|
||||||
warnings.push({
|
|
||||||
type: 'UNCITED_STATISTICS',
|
|
||||||
severity: 'HIGH',
|
|
||||||
instruction: 'inst_016',
|
|
||||||
message: `Found ${statsFound} statistics without sources - verify these are not fabricated`
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
const isValid = violations.length === 0;
|
|
||||||
|
|
||||||
const validationResult = {
|
|
||||||
valid: isValid,
|
|
||||||
violations,
|
|
||||||
warnings,
|
|
||||||
stats_found: statsFound,
|
|
||||||
sources_provided: content.sources?.length || 0,
|
|
||||||
recommendation: violations.length > 0 ? 'REJECT' :
|
|
||||||
warnings.length > 0 ? 'REVIEW_REQUIRED' :
|
|
||||||
'APPROVED'
|
|
||||||
};
|
|
||||||
|
|
||||||
// Audit validation decision
|
|
||||||
this._auditValidationDecision(content, validationResult);
|
|
||||||
|
|
||||||
return validationResult;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Audit content validation decision to memory (async, non-blocking)
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
_auditValidationDecision(content, validationResult) {
|
|
||||||
// Only audit if MemoryProxy is initialized
|
|
||||||
if (!this.memoryProxyInitialized) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Extract violation instruction IDs
|
|
||||||
const violatedRules = [
|
|
||||||
...validationResult.violations.map(v => v.instruction),
|
|
||||||
...validationResult.warnings.map(w => w.instruction)
|
|
||||||
].filter(Boolean);
|
|
||||||
|
|
||||||
// Audit asynchronously (don't block validation)
|
|
||||||
this.memoryProxy.auditDecision({
|
|
||||||
sessionId: 'blog-curation-service',
|
|
||||||
action: 'content_validation',
|
|
||||||
rulesChecked: Object.keys(this.enforcementRules),
|
|
||||||
violations: violatedRules,
|
|
||||||
allowed: validationResult.valid,
|
|
||||||
metadata: {
|
|
||||||
content_title: content.title,
|
|
||||||
violation_count: validationResult.violations.length,
|
|
||||||
warning_count: validationResult.warnings.length,
|
|
||||||
stats_found: validationResult.stats_found,
|
|
||||||
sources_provided: validationResult.sources_provided,
|
|
||||||
recommendation: validationResult.recommendation
|
|
||||||
}
|
|
||||||
}).catch(error => {
|
|
||||||
logger.error('[BlogCuration] Failed to audit validation decision', {
|
|
||||||
error: error.message,
|
|
||||||
title: content.title
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Validate topic title for forbidden patterns
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
_validateTopicTitle(title) {
|
|
||||||
const textToCheck = title.toLowerCase();
|
|
||||||
const issues = [];
|
|
||||||
|
|
||||||
// Check for absolute guarantees
|
|
||||||
if (textToCheck.match(/guarantee|100%|never fail|always work/)) {
|
|
||||||
issues.push('Contains absolute assurance language');
|
|
||||||
}
|
|
||||||
|
|
||||||
return {
|
|
||||||
valid: issues.length === 0,
|
|
||||||
issues
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get editorial guidelines (for display in admin UI)
|
|
||||||
*
|
|
||||||
* @returns {Object} Editorial guidelines
|
|
||||||
*/
|
|
||||||
getEditorialGuidelines() {
|
|
||||||
return this.editorialGuidelines;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Export singleton instance
|
|
||||||
module.exports = new BlogCurationService();
|
|
||||||
|
|
@ -1,425 +0,0 @@
|
||||||
/**
|
|
||||||
* Claude API Service
|
|
||||||
*
|
|
||||||
* Provides interface to Anthropic's Claude API for AI-powered features.
|
|
||||||
* All AI operations go through this service to ensure consistent error handling,
|
|
||||||
* rate limiting, and governance compliance.
|
|
||||||
*
|
|
||||||
* Usage:
|
|
||||||
* const claudeAPI = require('./ClaudeAPI.service');
|
|
||||||
* const response = await claudeAPI.sendMessage(messages, options);
|
|
||||||
*/
|
|
||||||
|
|
||||||
const https = require('https');
|
|
||||||
|
|
||||||
class ClaudeAPIService {
|
|
||||||
constructor() {
|
|
||||||
this.apiKey = process.env.CLAUDE_API_KEY;
|
|
||||||
this.model = process.env.CLAUDE_MODEL || 'claude-sonnet-4-5-20250929';
|
|
||||||
this.maxTokens = parseInt(process.env.CLAUDE_MAX_TOKENS) || 4096;
|
|
||||||
this.apiVersion = '2023-06-01';
|
|
||||||
this.hostname = 'api.anthropic.com';
|
|
||||||
|
|
||||||
if (!this.apiKey) {
|
|
||||||
console.error('WARNING: CLAUDE_API_KEY not set in environment variables');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Send a message to Claude API
|
|
||||||
*
|
|
||||||
* @param {Array} messages - Array of message objects [{role: 'user', content: '...'}]
|
|
||||||
* @param {Object} options - Optional overrides (model, max_tokens, temperature)
|
|
||||||
* @returns {Promise<Object>} API response
|
|
||||||
*/
|
|
||||||
async sendMessage(messages, options = {}) {
|
|
||||||
if (!this.apiKey) {
|
|
||||||
throw new Error('Claude API key not configured');
|
|
||||||
}
|
|
||||||
|
|
||||||
const payload = {
|
|
||||||
model: options.model || this.model,
|
|
||||||
max_tokens: options.max_tokens || this.maxTokens,
|
|
||||||
messages: messages,
|
|
||||||
...(options.system && { system: options.system }),
|
|
||||||
...(options.temperature && { temperature: options.temperature })
|
|
||||||
};
|
|
||||||
|
|
||||||
try {
|
|
||||||
const response = await this._makeRequest(payload);
|
|
||||||
|
|
||||||
// Log usage for monitoring
|
|
||||||
if (response.usage) {
|
|
||||||
console.log(`[ClaudeAPI] Usage: ${response.usage.input_tokens} in, ${response.usage.output_tokens} out`);
|
|
||||||
}
|
|
||||||
|
|
||||||
return response;
|
|
||||||
} catch (error) {
|
|
||||||
console.error('[ClaudeAPI] Error:', error.message);
|
|
||||||
throw error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Make HTTP request to Claude API
|
|
||||||
*
|
|
||||||
* @private
|
|
||||||
* @param {Object} payload - Request payload
|
|
||||||
* @returns {Promise<Object>} Parsed response
|
|
||||||
*/
|
|
||||||
_makeRequest(payload) {
|
|
||||||
return new Promise((resolve, reject) => {
|
|
||||||
const postData = JSON.stringify(payload);
|
|
||||||
|
|
||||||
const options = {
|
|
||||||
hostname: this.hostname,
|
|
||||||
port: 443,
|
|
||||||
path: '/v1/messages',
|
|
||||||
method: 'POST',
|
|
||||||
headers: {
|
|
||||||
'Content-Type': 'application/json',
|
|
||||||
'x-api-key': this.apiKey,
|
|
||||||
'anthropic-version': this.apiVersion,
|
|
||||||
'Content-Length': Buffer.byteLength(postData)
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
const req = https.request(options, (res) => {
|
|
||||||
let data = '';
|
|
||||||
|
|
||||||
res.on('data', (chunk) => {
|
|
||||||
data += chunk;
|
|
||||||
});
|
|
||||||
|
|
||||||
res.on('end', () => {
|
|
||||||
if (res.statusCode === 200) {
|
|
||||||
try {
|
|
||||||
const response = JSON.parse(data);
|
|
||||||
resolve(response);
|
|
||||||
} catch (error) {
|
|
||||||
reject(new Error(`Failed to parse API response: ${error.message}`));
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
reject(new Error(`API request failed with status ${res.statusCode}: ${data}`));
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
req.on('error', (error) => {
|
|
||||||
reject(new Error(`Request error: ${error.message}`));
|
|
||||||
});
|
|
||||||
|
|
||||||
req.write(postData);
|
|
||||||
req.end();
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Extract text content from Claude API response
|
|
||||||
*
|
|
||||||
* @param {Object} response - Claude API response
|
|
||||||
* @returns {string} Extracted text content
|
|
||||||
*/
|
|
||||||
extractTextContent(response) {
|
|
||||||
if (!response || !response.content || !Array.isArray(response.content)) {
|
|
||||||
throw new Error('Invalid Claude API response format');
|
|
||||||
}
|
|
||||||
|
|
||||||
const textBlock = response.content.find(block => block.type === 'text');
|
|
||||||
if (!textBlock) {
|
|
||||||
throw new Error('No text content in Claude API response');
|
|
||||||
}
|
|
||||||
|
|
||||||
return textBlock.text;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Parse JSON from Claude response (handles markdown code blocks)
|
|
||||||
*
|
|
||||||
* @param {Object} response - Claude API response
|
|
||||||
* @returns {Object} Parsed JSON
|
|
||||||
*/
|
|
||||||
extractJSON(response) {
|
|
||||||
const text = this.extractTextContent(response);
|
|
||||||
|
|
||||||
// Remove markdown code blocks if present
|
|
||||||
let jsonText = text.trim();
|
|
||||||
if (jsonText.startsWith('```json')) {
|
|
||||||
jsonText = jsonText.replace(/^```json\n/, '').replace(/\n```$/, '');
|
|
||||||
} else if (jsonText.startsWith('```')) {
|
|
||||||
jsonText = jsonText.replace(/^```\n/, '').replace(/\n```$/, '');
|
|
||||||
}
|
|
||||||
|
|
||||||
try {
|
|
||||||
return JSON.parse(jsonText);
|
|
||||||
} catch (error) {
|
|
||||||
throw new Error(`Failed to parse JSON from Claude response: ${error.message}\nText: ${jsonText}`);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Classify an instruction into Tractatus quadrants
|
|
||||||
*
|
|
||||||
* @param {string} instructionText - The instruction to classify
|
|
||||||
* @returns {Promise<Object>} Classification result
|
|
||||||
*/
|
|
||||||
async classifyInstruction(instructionText) {
|
|
||||||
const messages = [{
|
|
||||||
role: 'user',
|
|
||||||
content: `Classify the following instruction into one of these quadrants: STRATEGIC, OPERATIONAL, TACTICAL, SYSTEM, or STOCHASTIC.
|
|
||||||
|
|
||||||
Instruction: "${instructionText}"
|
|
||||||
|
|
||||||
Respond with JSON only:
|
|
||||||
{
|
|
||||||
"quadrant": "...",
|
|
||||||
"persistence": "HIGH/MEDIUM/LOW",
|
|
||||||
"temporal_scope": "PROJECT/SESSION/TASK",
|
|
||||||
"verification_required": "MANDATORY/RECOMMENDED/NONE",
|
|
||||||
"explicitness": 0.0-1.0,
|
|
||||||
"reasoning": "brief explanation"
|
|
||||||
}`
|
|
||||||
}];
|
|
||||||
|
|
||||||
const response = await this.sendMessage(messages, { max_tokens: 1024 });
|
|
||||||
return this.extractJSON(response);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate blog topic suggestions
|
|
||||||
*
|
|
||||||
* @param {string} audience - Target audience (researcher/implementer/advocate)
|
|
||||||
* @param {string} theme - Optional theme or focus area
|
|
||||||
* @returns {Promise<Array>} Array of topic suggestions
|
|
||||||
*/
|
|
||||||
async generateBlogTopics(audience, theme = null) {
|
|
||||||
const systemPrompt = `You are a content strategist for the Tractatus AI Safety Framework.
|
|
||||||
Your role is to suggest blog post topics that educate audiences about AI safety through sovereignty,
|
|
||||||
transparency, harmlessness, and community principles.
|
|
||||||
|
|
||||||
The framework prevents AI from making irreducible human decisions and requires human oversight
|
|
||||||
for all values-sensitive choices.`;
|
|
||||||
|
|
||||||
const userPrompt = theme
|
|
||||||
? `Suggest 5-7 blog post topics for ${audience} audience focused on: ${theme}
|
|
||||||
|
|
||||||
For each topic, provide:
|
|
||||||
- Title (compelling, specific)
|
|
||||||
- Subtitle (1 sentence)
|
|
||||||
- Target word count (800-1500)
|
|
||||||
- Key points to cover (3-5 bullets)
|
|
||||||
- Tractatus angle (how it relates to framework)
|
|
||||||
|
|
||||||
Respond with JSON array.`
|
|
||||||
: `Suggest 5-7 blog post topics for ${audience} audience about the Tractatus AI Safety Framework.
|
|
||||||
|
|
||||||
For each topic, provide:
|
|
||||||
- Title (compelling, specific)
|
|
||||||
- Subtitle (1 sentence)
|
|
||||||
- Target word count (800-1500)
|
|
||||||
- Key points to cover (3-5 bullets)
|
|
||||||
- Tractatus angle (how it relates to framework)
|
|
||||||
|
|
||||||
Respond with JSON array.`;
|
|
||||||
|
|
||||||
const messages = [{ role: 'user', content: userPrompt }];
|
|
||||||
|
|
||||||
const response = await this.sendMessage(messages, {
|
|
||||||
system: systemPrompt,
|
|
||||||
max_tokens: 2048
|
|
||||||
});
|
|
||||||
|
|
||||||
return this.extractJSON(response);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Classify media inquiry by priority
|
|
||||||
*
|
|
||||||
* @param {Object} inquiry - Media inquiry object {outlet, request, deadline}
|
|
||||||
* @returns {Promise<Object>} Classification with priority and reasoning
|
|
||||||
*/
|
|
||||||
async classifyMediaInquiry(inquiry) {
|
|
||||||
const { outlet, request, deadline } = inquiry;
|
|
||||||
|
|
||||||
const systemPrompt = `You are a media relations assistant for the Tractatus AI Safety Framework.
|
|
||||||
Classify media inquiries by priority (HIGH/MEDIUM/LOW) based on:
|
|
||||||
- Outlet credibility and reach
|
|
||||||
- Request type (interview, comment, feature)
|
|
||||||
- Deadline urgency
|
|
||||||
- Topic relevance to framework`;
|
|
||||||
|
|
||||||
const userPrompt = `Classify this media inquiry:
|
|
||||||
|
|
||||||
Outlet: ${outlet}
|
|
||||||
Request: ${request}
|
|
||||||
Deadline: ${deadline || 'Not specified'}
|
|
||||||
|
|
||||||
Respond with JSON:
|
|
||||||
{
|
|
||||||
"priority": "HIGH/MEDIUM/LOW",
|
|
||||||
"reasoning": "brief explanation",
|
|
||||||
"recommended_response_time": "hours or days",
|
|
||||||
"suggested_spokesperson": "technical expert, policy lead, or framework creator"
|
|
||||||
}`;
|
|
||||||
|
|
||||||
const messages = [{ role: 'user', content: userPrompt }];
|
|
||||||
|
|
||||||
const response = await this.sendMessage(messages, {
|
|
||||||
system: systemPrompt,
|
|
||||||
max_tokens: 1024
|
|
||||||
});
|
|
||||||
|
|
||||||
return this.extractJSON(response);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Draft suggested response to media inquiry
|
|
||||||
* (ALWAYS requires human approval before sending - TRA-OPS-0003)
|
|
||||||
*
|
|
||||||
* @param {Object} inquiry - Media inquiry object
|
|
||||||
* @param {string} priority - Priority classification
|
|
||||||
* @returns {Promise<string>} Draft response text
|
|
||||||
*/
|
|
||||||
async draftMediaResponse(inquiry, priority) {
|
|
||||||
const { outlet, request } = inquiry;
|
|
||||||
|
|
||||||
const systemPrompt = `You are drafting a suggested response to a media inquiry about the Tractatus AI Safety Framework.
|
|
||||||
|
|
||||||
IMPORTANT: This is a DRAFT only. A human will review and approve before sending.
|
|
||||||
|
|
||||||
Framework Core Principles:
|
|
||||||
1. What cannot be systematized must not be automated
|
|
||||||
2. AI must never make irreducible human decisions
|
|
||||||
3. Sovereignty: User agency over values and goals
|
|
||||||
4. Transparency: Explicit instructions, audit trails
|
|
||||||
5. Harmlessness: Boundary enforcement prevents values automation
|
|
||||||
6. Community: Open frameworks, shared governance`;
|
|
||||||
|
|
||||||
const userPrompt = `Draft a ${priority} priority response to:
|
|
||||||
|
|
||||||
Outlet: ${outlet}
|
|
||||||
Request: ${request}
|
|
||||||
|
|
||||||
Requirements:
|
|
||||||
- Professional, informative tone
|
|
||||||
- 150-250 words
|
|
||||||
- Offer specific value (interview, technical details, case studies)
|
|
||||||
- Mention framework website: agenticgovernance.digital
|
|
||||||
- Include contact for follow-up
|
|
||||||
|
|
||||||
Respond with plain text (not JSON).`;
|
|
||||||
|
|
||||||
const messages = [{ role: 'user', content: userPrompt }];
|
|
||||||
|
|
||||||
const response = await this.sendMessage(messages, {
|
|
||||||
system: systemPrompt,
|
|
||||||
max_tokens: 1024
|
|
||||||
});
|
|
||||||
|
|
||||||
return this.extractTextContent(response);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Analyze case study relevance
|
|
||||||
*
|
|
||||||
* @param {Object} caseStudy - Case study object {title, description, evidence}
|
|
||||||
* @returns {Promise<Object>} Analysis with relevance score
|
|
||||||
*/
|
|
||||||
async analyzeCaseRelevance(caseStudy) {
|
|
||||||
const { title, description, evidence } = caseStudy;
|
|
||||||
|
|
||||||
const systemPrompt = `You are evaluating case study submissions for the Tractatus AI Safety Framework.
|
|
||||||
|
|
||||||
Assess relevance based on:
|
|
||||||
1. Demonstrates framework principles (sovereignty, transparency, harmlessness)
|
|
||||||
2. Shows AI safety concerns addressed by Tractatus
|
|
||||||
3. Provides concrete evidence or examples
|
|
||||||
4. Offers insights valuable to community
|
|
||||||
5. Ethical considerations (privacy, consent, impact)
|
|
||||||
|
|
||||||
Score 0-100 where:
|
|
||||||
- 80-100: Highly relevant, publish with minor edits
|
|
||||||
- 60-79: Relevant, needs some editing
|
|
||||||
- 40-59: Somewhat relevant, major editing needed
|
|
||||||
- 0-39: Not relevant or low quality`;
|
|
||||||
|
|
||||||
const userPrompt = `Analyze this case study submission:
|
|
||||||
|
|
||||||
Title: ${title}
|
|
||||||
Description: ${description}
|
|
||||||
Evidence: ${evidence || 'Not provided'}
|
|
||||||
|
|
||||||
Respond with JSON:
|
|
||||||
{
|
|
||||||
"relevance_score": 0-100,
|
|
||||||
"strengths": ["..."],
|
|
||||||
"weaknesses": ["..."],
|
|
||||||
"recommended_action": "PUBLISH/EDIT/REJECT",
|
|
||||||
"ethical_concerns": ["..."] or null,
|
|
||||||
"suggested_improvements": ["..."]
|
|
||||||
}`;
|
|
||||||
|
|
||||||
const messages = [{ role: 'user', content: userPrompt }];
|
|
||||||
|
|
||||||
const response = await this.sendMessage(messages, {
|
|
||||||
system: systemPrompt,
|
|
||||||
max_tokens: 1536
|
|
||||||
});
|
|
||||||
|
|
||||||
return this.extractJSON(response);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Curate external resources (websites, papers, tools)
|
|
||||||
*
|
|
||||||
* @param {Object} resource - Resource object {url, title, description}
|
|
||||||
* @returns {Promise<Object>} Curation analysis
|
|
||||||
*/
|
|
||||||
async curateResource(resource) {
|
|
||||||
const { url, title, description } = resource;
|
|
||||||
|
|
||||||
const systemPrompt = `You are curating external resources for the Tractatus AI Safety Framework resource directory.
|
|
||||||
|
|
||||||
Evaluate based on:
|
|
||||||
1. Alignment with framework values (sovereignty, transparency, harmlessness)
|
|
||||||
2. Quality and credibility of source
|
|
||||||
3. Relevance to AI safety, governance, or ethics
|
|
||||||
4. Usefulness to target audiences (researchers, implementers, advocates)
|
|
||||||
|
|
||||||
Categorize into:
|
|
||||||
- PAPERS: Academic research, technical documentation
|
|
||||||
- TOOLS: Software, frameworks, libraries
|
|
||||||
- ORGANIZATIONS: Aligned groups, communities
|
|
||||||
- STANDARDS: Regulatory frameworks, best practices
|
|
||||||
- ARTICLES: Blog posts, essays, commentaries`;
|
|
||||||
|
|
||||||
const userPrompt = `Evaluate this resource for inclusion:
|
|
||||||
|
|
||||||
URL: ${url}
|
|
||||||
Title: ${title}
|
|
||||||
Description: ${description}
|
|
||||||
|
|
||||||
Respond with JSON:
|
|
||||||
{
|
|
||||||
"recommended": true/false,
|
|
||||||
"category": "PAPERS/TOOLS/ORGANIZATIONS/STANDARDS/ARTICLES",
|
|
||||||
"alignment_score": 0-100,
|
|
||||||
"target_audience": ["researcher", "implementer", "advocate"],
|
|
||||||
"tags": ["..."],
|
|
||||||
"reasoning": "brief explanation",
|
|
||||||
"concerns": ["..."] or null
|
|
||||||
}`;
|
|
||||||
|
|
||||||
const messages = [{ role: 'user', content: userPrompt }];
|
|
||||||
|
|
||||||
const response = await this.sendMessage(messages, {
|
|
||||||
system: systemPrompt,
|
|
||||||
max_tokens: 1024
|
|
||||||
});
|
|
||||||
|
|
||||||
return this.extractJSON(response);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Export singleton instance
|
|
||||||
module.exports = new ClaudeAPIService();
|
|
||||||
|
|
@ -1,442 +0,0 @@
|
||||||
/**
|
|
||||||
* CLAUDE.md Analyzer Service
|
|
||||||
*
|
|
||||||
* Parses CLAUDE.md files and extracts candidate governance rules.
|
|
||||||
* Classifies statements by quality and provides migration recommendations.
|
|
||||||
*
|
|
||||||
* Part of Phase 2: AI Rule Optimizer & CLAUDE.md Analyzer
|
|
||||||
*/
|
|
||||||
|
|
||||||
const RuleOptimizer = require('./RuleOptimizer.service');
|
|
||||||
|
|
||||||
class ClaudeMdAnalyzer {
|
|
||||||
constructor() {
|
|
||||||
// Keywords for quadrant classification
|
|
||||||
this.quadrantKeywords = {
|
|
||||||
STRATEGIC: ['architecture', 'design', 'philosophy', 'approach', 'values', 'mission', 'vision', 'goal'],
|
|
||||||
OPERATIONAL: ['workflow', 'process', 'procedure', 'convention', 'standard', 'practice', 'guideline'],
|
|
||||||
TACTICAL: ['implementation', 'code', 'function', 'class', 'variable', 'syntax', 'pattern'],
|
|
||||||
SYSTEM: ['port', 'database', 'server', 'infrastructure', 'deployment', 'environment', 'service'],
|
|
||||||
STORAGE: ['state', 'session', 'cache', 'persistence', 'data', 'storage', 'memory']
|
|
||||||
};
|
|
||||||
|
|
||||||
// Imperative indicators (for HIGH persistence)
|
|
||||||
this.imperatives = ['MUST', 'SHALL', 'REQUIRED', 'PROHIBITED', 'NEVER', 'ALWAYS', 'MANDATORY'];
|
|
||||||
|
|
||||||
// Preference indicators (for MEDIUM persistence)
|
|
||||||
this.preferences = ['SHOULD', 'RECOMMENDED', 'PREFERRED', 'ENCOURAGED'];
|
|
||||||
|
|
||||||
// Suggestion indicators (for LOW persistence)
|
|
||||||
this.suggestions = ['MAY', 'CAN', 'CONSIDER', 'TRY', 'MIGHT'];
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Parse CLAUDE.md content into structured sections
|
|
||||||
*
|
|
||||||
* @param {string} content - Raw CLAUDE.md content
|
|
||||||
* @returns {Object} Parsed structure with sections
|
|
||||||
*/
|
|
||||||
parse(content) {
|
|
||||||
const lines = content.split('\n');
|
|
||||||
const sections = [];
|
|
||||||
let currentSection = null;
|
|
||||||
|
|
||||||
lines.forEach((line, index) => {
|
|
||||||
// Detect headings (# or ##)
|
|
||||||
const headingMatch = line.match(/^(#{1,6})\s+(.+)/);
|
|
||||||
if (headingMatch) {
|
|
||||||
if (currentSection) {
|
|
||||||
sections.push(currentSection);
|
|
||||||
}
|
|
||||||
currentSection = {
|
|
||||||
level: headingMatch[1].length,
|
|
||||||
title: headingMatch[2].trim(),
|
|
||||||
content: [],
|
|
||||||
lineStart: index
|
|
||||||
};
|
|
||||||
} else if (currentSection && line.trim()) {
|
|
||||||
currentSection.content.push(line.trim());
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
if (currentSection) {
|
|
||||||
sections.push(currentSection);
|
|
||||||
}
|
|
||||||
|
|
||||||
return {
|
|
||||||
totalLines: lines.length,
|
|
||||||
sections,
|
|
||||||
content: content
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Extract candidate rules from parsed content
|
|
||||||
*
|
|
||||||
* @param {Object} parsedContent - Output from parse()
|
|
||||||
* @returns {Array<Object>} Array of candidate rules
|
|
||||||
*/
|
|
||||||
extractCandidateRules(parsedContent) {
|
|
||||||
const candidates = [];
|
|
||||||
|
|
||||||
parsedContent.sections.forEach(section => {
|
|
||||||
section.content.forEach(statement => {
|
|
||||||
// Skip very short statements
|
|
||||||
if (statement.length < 15) return;
|
|
||||||
|
|
||||||
// Detect if statement has imperative language
|
|
||||||
const hasImperative = this.imperatives.some(word =>
|
|
||||||
new RegExp(`\\b${word}\\b`).test(statement)
|
|
||||||
);
|
|
||||||
|
|
||||||
const hasPreference = this.preferences.some(word =>
|
|
||||||
new RegExp(`\\b${word}\\b`, 'i').test(statement)
|
|
||||||
);
|
|
||||||
|
|
||||||
const hasSuggestion = this.suggestions.some(word =>
|
|
||||||
new RegExp(`\\b${word}\\b`, 'i').test(statement)
|
|
||||||
);
|
|
||||||
|
|
||||||
// Only process statements with governance language
|
|
||||||
if (!hasImperative && !hasPreference && !hasSuggestion) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Classify quadrant based on keywords
|
|
||||||
const quadrant = this._classifyQuadrant(statement);
|
|
||||||
|
|
||||||
// Classify persistence based on language strength
|
|
||||||
let persistence = 'LOW';
|
|
||||||
if (hasImperative) persistence = 'HIGH';
|
|
||||||
else if (hasPreference) persistence = 'MEDIUM';
|
|
||||||
|
|
||||||
// Detect parameters (ports, paths, etc.)
|
|
||||||
const parameters = this._extractParameters(statement);
|
|
||||||
|
|
||||||
// Analyze quality using RuleOptimizer
|
|
||||||
const analysis = RuleOptimizer.analyzeRule(statement);
|
|
||||||
|
|
||||||
// Determine quality tier
|
|
||||||
let quality = 'TOO_NEBULOUS';
|
|
||||||
let autoConvert = false;
|
|
||||||
|
|
||||||
if (analysis.overallScore >= 80) {
|
|
||||||
quality = 'HIGH';
|
|
||||||
autoConvert = true;
|
|
||||||
} else if (analysis.overallScore >= 60) {
|
|
||||||
quality = 'NEEDS_CLARIFICATION';
|
|
||||||
autoConvert = false;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Generate optimized version
|
|
||||||
const optimized = RuleOptimizer.optimize(statement, { mode: 'aggressive' });
|
|
||||||
|
|
||||||
candidates.push({
|
|
||||||
originalText: statement,
|
|
||||||
sectionTitle: section.title,
|
|
||||||
quadrant,
|
|
||||||
persistence,
|
|
||||||
parameters,
|
|
||||||
quality,
|
|
||||||
autoConvert,
|
|
||||||
analysis: {
|
|
||||||
clarityScore: analysis.clarity.score,
|
|
||||||
specificityScore: analysis.specificity.score,
|
|
||||||
actionabilityScore: analysis.actionability.score,
|
|
||||||
overallScore: analysis.overallScore,
|
|
||||||
issues: [
|
|
||||||
...analysis.clarity.issues,
|
|
||||||
...analysis.specificity.issues,
|
|
||||||
...analysis.actionability.issues
|
|
||||||
]
|
|
||||||
},
|
|
||||||
suggestedRule: {
|
|
||||||
text: optimized.optimized,
|
|
||||||
scope: this._determineScope(optimized.optimized),
|
|
||||||
quadrant,
|
|
||||||
persistence,
|
|
||||||
variables: this._detectVariables(optimized.optimized),
|
|
||||||
clarityScore: RuleOptimizer.analyzeRule(optimized.optimized).overallScore
|
|
||||||
},
|
|
||||||
improvements: analysis.suggestions.map(s => s.reason)
|
|
||||||
});
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
return candidates;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Detect redundant rules
|
|
||||||
*
|
|
||||||
* @param {Array<Object>} candidates - Candidate rules
|
|
||||||
* @returns {Array<Object>} Redundancy groups with merge suggestions
|
|
||||||
*/
|
|
||||||
detectRedundancies(candidates) {
|
|
||||||
const redundancies = [];
|
|
||||||
const processed = new Set();
|
|
||||||
|
|
||||||
for (let i = 0; i < candidates.length; i++) {
|
|
||||||
if (processed.has(i)) continue;
|
|
||||||
|
|
||||||
const similar = [];
|
|
||||||
for (let j = i + 1; j < candidates.length; j++) {
|
|
||||||
if (processed.has(j)) continue;
|
|
||||||
|
|
||||||
const similarity = this._calculateSimilarity(
|
|
||||||
candidates[i].originalText,
|
|
||||||
candidates[j].originalText
|
|
||||||
);
|
|
||||||
|
|
||||||
if (similarity > 0.7) {
|
|
||||||
similar.push(j);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if (similar.length > 0) {
|
|
||||||
const group = [candidates[i], ...similar.map(idx => candidates[idx])];
|
|
||||||
similar.forEach(idx => processed.add(idx));
|
|
||||||
processed.add(i);
|
|
||||||
|
|
||||||
redundancies.push({
|
|
||||||
rules: group.map(c => c.originalText),
|
|
||||||
mergeSuggestion: this._suggestMerge(group)
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return redundancies;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate migration plan from analysis
|
|
||||||
*
|
|
||||||
* @param {Object} analysis - Complete analysis with candidates and redundancies
|
|
||||||
* @returns {Object} Migration plan
|
|
||||||
*/
|
|
||||||
generateMigrationPlan(analysis) {
|
|
||||||
const { candidates, redundancies } = analysis;
|
|
||||||
|
|
||||||
const highQuality = candidates.filter(c => c.quality === 'HIGH');
|
|
||||||
const needsClarification = candidates.filter(c => c.quality === 'NEEDS_CLARIFICATION');
|
|
||||||
const tooNebulous = candidates.filter(c => c.quality === 'TOO_NEBULOUS');
|
|
||||||
|
|
||||||
return {
|
|
||||||
summary: {
|
|
||||||
totalStatements: candidates.length,
|
|
||||||
highQuality: highQuality.length,
|
|
||||||
needsClarification: needsClarification.length,
|
|
||||||
tooNebulous: tooNebulous.length,
|
|
||||||
redundancies: redundancies.length,
|
|
||||||
autoConvertable: candidates.filter(c => c.autoConvert).length
|
|
||||||
},
|
|
||||||
steps: [
|
|
||||||
{
|
|
||||||
phase: 'Auto-Convert',
|
|
||||||
count: highQuality.length,
|
|
||||||
description: 'High-quality rules that can be auto-converted',
|
|
||||||
rules: highQuality.map(c => c.suggestedRule)
|
|
||||||
},
|
|
||||||
{
|
|
||||||
phase: 'Review & Clarify',
|
|
||||||
count: needsClarification.length,
|
|
||||||
description: 'Rules needing clarification before conversion',
|
|
||||||
rules: needsClarification.map(c => ({
|
|
||||||
original: c.originalText,
|
|
||||||
suggested: c.suggestedRule,
|
|
||||||
issues: c.analysis.issues,
|
|
||||||
improvements: c.improvements
|
|
||||||
}))
|
|
||||||
},
|
|
||||||
{
|
|
||||||
phase: 'Manual Rewrite',
|
|
||||||
count: tooNebulous.length,
|
|
||||||
description: 'Statements too vague - require manual rewrite',
|
|
||||||
rules: tooNebulous.map(c => ({
|
|
||||||
original: c.originalText,
|
|
||||||
suggestions: c.improvements
|
|
||||||
}))
|
|
||||||
},
|
|
||||||
{
|
|
||||||
phase: 'Merge Redundancies',
|
|
||||||
count: redundancies.length,
|
|
||||||
description: 'Similar rules that should be merged',
|
|
||||||
groups: redundancies
|
|
||||||
}
|
|
||||||
],
|
|
||||||
estimatedTime: this._estimateMigrationTime(candidates, redundancies)
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Analyze complete CLAUDE.md file
|
|
||||||
*
|
|
||||||
* @param {string} content - CLAUDE.md content
|
|
||||||
* @returns {Object} Complete analysis
|
|
||||||
*/
|
|
||||||
analyze(content) {
|
|
||||||
const parsed = this.parse(content);
|
|
||||||
const candidates = this.extractCandidateRules(parsed);
|
|
||||||
const redundancies = this.detectRedundancies(candidates);
|
|
||||||
const migrationPlan = this.generateMigrationPlan({ candidates, redundancies });
|
|
||||||
|
|
||||||
return {
|
|
||||||
parsed,
|
|
||||||
candidates,
|
|
||||||
redundancies,
|
|
||||||
migrationPlan,
|
|
||||||
quality: {
|
|
||||||
highQuality: candidates.filter(c => c.quality === 'HIGH').length,
|
|
||||||
needsClarification: candidates.filter(c => c.quality === 'NEEDS_CLARIFICATION').length,
|
|
||||||
tooNebulous: candidates.filter(c => c.quality === 'TOO_NEBULOUS').length,
|
|
||||||
averageScore: Math.round(
|
|
||||||
candidates.reduce((sum, c) => sum + c.analysis.overallScore, 0) / candidates.length
|
|
||||||
)
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
// ========== PRIVATE HELPER METHODS ==========
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Classify statement into Tractatus quadrant
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
_classifyQuadrant(statement) {
|
|
||||||
const lower = statement.toLowerCase();
|
|
||||||
let bestMatch = 'TACTICAL';
|
|
||||||
let maxMatches = 0;
|
|
||||||
|
|
||||||
for (const [quadrant, keywords] of Object.entries(this.quadrantKeywords)) {
|
|
||||||
const matches = keywords.filter(keyword => lower.includes(keyword)).length;
|
|
||||||
if (matches > maxMatches) {
|
|
||||||
maxMatches = matches;
|
|
||||||
bestMatch = quadrant;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return bestMatch;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Extract parameters from statement (ports, paths, etc.)
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
_extractParameters(statement) {
|
|
||||||
const parameters = {};
|
|
||||||
|
|
||||||
// Port numbers
|
|
||||||
const portMatch = statement.match(/port\s+(\d+)/i);
|
|
||||||
if (portMatch) {
|
|
||||||
parameters.port = portMatch[1];
|
|
||||||
}
|
|
||||||
|
|
||||||
// Database types
|
|
||||||
const dbMatch = statement.match(/\b(mongodb|postgresql|mysql|redis)\b/i);
|
|
||||||
if (dbMatch) {
|
|
||||||
parameters.database = dbMatch[1];
|
|
||||||
}
|
|
||||||
|
|
||||||
// Paths
|
|
||||||
const pathMatch = statement.match(/[\/\\][\w\/\\.-]+/);
|
|
||||||
if (pathMatch) {
|
|
||||||
parameters.path = pathMatch[0];
|
|
||||||
}
|
|
||||||
|
|
||||||
// Environment
|
|
||||||
const envMatch = statement.match(/\b(production|development|staging|test)\b/i);
|
|
||||||
if (envMatch) {
|
|
||||||
parameters.environment = envMatch[1];
|
|
||||||
}
|
|
||||||
|
|
||||||
return parameters;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Detect variables in optimized text
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
_detectVariables(text) {
|
|
||||||
const matches = text.matchAll(/\$\{([A-Z_]+)\}/g);
|
|
||||||
return Array.from(matches, m => m[1]);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Determine if rule should be universal or project-specific
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
_determineScope(text) {
|
|
||||||
// If has variables, likely universal
|
|
||||||
if (this._detectVariables(text).length > 0) {
|
|
||||||
return 'UNIVERSAL';
|
|
||||||
}
|
|
||||||
|
|
||||||
// If references specific project name, project-specific
|
|
||||||
if (/\b(tractatus|family-history|sydigital)\b/i.test(text)) {
|
|
||||||
return 'PROJECT_SPECIFIC';
|
|
||||||
}
|
|
||||||
|
|
||||||
// Default to universal for reusability
|
|
||||||
return 'UNIVERSAL';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Calculate text similarity (Jaccard coefficient)
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
_calculateSimilarity(text1, text2) {
|
|
||||||
const words1 = new Set(text1.toLowerCase().split(/\s+/));
|
|
||||||
const words2 = new Set(text2.toLowerCase().split(/\s+/));
|
|
||||||
|
|
||||||
const intersection = new Set([...words1].filter(w => words2.has(w)));
|
|
||||||
const union = new Set([...words1, ...words2]);
|
|
||||||
|
|
||||||
return intersection.size / union.size;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Suggest merged rule from similar rules
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
_suggestMerge(group) {
|
|
||||||
// Take the most specific rule as base
|
|
||||||
const sorted = group.sort((a, b) =>
|
|
||||||
b.analysis.specificityScore - a.analysis.specificityScore
|
|
||||||
);
|
|
||||||
|
|
||||||
return sorted[0].suggestedRule.text;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Estimate time needed for migration
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
_estimateMigrationTime(candidates, redundancies) {
|
|
||||||
const autoConvert = candidates.filter(c => c.autoConvert).length;
|
|
||||||
const needsReview = candidates.filter(c => !c.autoConvert && c.quality !== 'TOO_NEBULOUS').length;
|
|
||||||
const needsRewrite = candidates.filter(c => c.quality === 'TOO_NEBULOUS').length;
|
|
||||||
|
|
||||||
// Auto-convert: 1 min each (review)
|
|
||||||
// Needs review: 5 min each (review + edit)
|
|
||||||
// Needs rewrite: 10 min each (rewrite from scratch)
|
|
||||||
// Redundancies: 3 min each (merge)
|
|
||||||
|
|
||||||
const minutes = (autoConvert * 1) +
|
|
||||||
(needsReview * 5) +
|
|
||||||
(needsRewrite * 10) +
|
|
||||||
(redundancies.length * 3);
|
|
||||||
|
|
||||||
return {
|
|
||||||
minutes,
|
|
||||||
hours: Math.round(minutes / 60 * 10) / 10,
|
|
||||||
breakdown: {
|
|
||||||
autoConvert: `${autoConvert} rules × 1 min = ${autoConvert} min`,
|
|
||||||
needsReview: `${needsReview} rules × 5 min = ${needsReview * 5} min`,
|
|
||||||
needsRewrite: `${needsRewrite} rules × 10 min = ${needsRewrite * 10} min`,
|
|
||||||
redundancies: `${redundancies.length} groups × 3 min = ${redundancies.length * 3} min`
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = new ClaudeMdAnalyzer();
|
|
||||||
|
|
@ -1,489 +0,0 @@
|
||||||
/**
|
|
||||||
* Media Triage Service
|
|
||||||
* AI-powered media inquiry triage with Tractatus governance
|
|
||||||
*
|
|
||||||
* GOVERNANCE PRINCIPLES:
|
|
||||||
* - AI analyzes and suggests, humans decide
|
|
||||||
* - All reasoning must be transparent
|
|
||||||
* - Values decisions require human approval
|
|
||||||
* - No auto-responses without human review
|
|
||||||
* - Boundary enforcement for sensitive topics
|
|
||||||
*/
|
|
||||||
|
|
||||||
const Anthropic = require('@anthropic-ai/sdk');
|
|
||||||
const logger = require('../utils/logger.util');
|
|
||||||
|
|
||||||
class MediaTriageService {
|
|
||||||
constructor() {
|
|
||||||
// Initialize Anthropic client
|
|
||||||
this.client = new Anthropic({
|
|
||||||
apiKey: process.env.CLAUDE_API_KEY
|
|
||||||
});
|
|
||||||
|
|
||||||
// Topic sensitivity keywords (triggers boundary enforcement)
|
|
||||||
this.SENSITIVE_TOPICS = [
|
|
||||||
'values', 'ethics', 'strategic direction', 'partnerships',
|
|
||||||
'te tiriti', 'māori', 'indigenous', 'governance philosophy',
|
|
||||||
'framework limitations', 'criticism', 'controversy'
|
|
||||||
];
|
|
||||||
|
|
||||||
// Urgency indicators
|
|
||||||
this.URGENCY_INDICATORS = {
|
|
||||||
high: ['urgent', 'asap', 'immediate', 'breaking', 'deadline today', 'deadline tomorrow'],
|
|
||||||
medium: ['deadline this week', 'timely', 'soon'],
|
|
||||||
low: ['no deadline', 'general inquiry', 'background']
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Perform AI triage on media inquiry
|
|
||||||
* Returns structured analysis for human review
|
|
||||||
*/
|
|
||||||
async triageInquiry(inquiry) {
|
|
||||||
try {
|
|
||||||
logger.info(`AI triaging inquiry: ${inquiry._id}`);
|
|
||||||
|
|
||||||
// Step 1: Analyze urgency
|
|
||||||
const urgencyAnalysis = await this.analyzeUrgency(inquiry);
|
|
||||||
|
|
||||||
// Step 2: Detect topic sensitivity
|
|
||||||
const sensitivityAnalysis = await this.analyzeTopicSensitivity(inquiry);
|
|
||||||
|
|
||||||
// Step 3: Check if involves values (BoundaryEnforcer)
|
|
||||||
const valuesCheck = this.checkInvolvesValues(inquiry, sensitivityAnalysis);
|
|
||||||
|
|
||||||
// Step 4: Generate suggested talking points
|
|
||||||
const talkingPoints = await this.generateTalkingPoints(inquiry, sensitivityAnalysis);
|
|
||||||
|
|
||||||
// Step 5: Draft response (ALWAYS requires human approval)
|
|
||||||
const draftResponse = await this.generateDraftResponse(inquiry, talkingPoints, valuesCheck);
|
|
||||||
|
|
||||||
// Step 6: Calculate suggested response time
|
|
||||||
const suggestedResponseTime = this.calculateResponseTime(urgencyAnalysis, inquiry);
|
|
||||||
|
|
||||||
// Compile triage result with full transparency
|
|
||||||
const triageResult = {
|
|
||||||
urgency: urgencyAnalysis.level,
|
|
||||||
urgency_score: urgencyAnalysis.score,
|
|
||||||
urgency_reasoning: urgencyAnalysis.reasoning,
|
|
||||||
|
|
||||||
topic_sensitivity: sensitivityAnalysis.level,
|
|
||||||
sensitivity_reasoning: sensitivityAnalysis.reasoning,
|
|
||||||
|
|
||||||
involves_values: valuesCheck.involves_values,
|
|
||||||
values_reasoning: valuesCheck.reasoning,
|
|
||||||
boundary_enforcement: valuesCheck.boundary_enforcement,
|
|
||||||
|
|
||||||
suggested_response_time: suggestedResponseTime,
|
|
||||||
suggested_talking_points: talkingPoints,
|
|
||||||
|
|
||||||
draft_response: draftResponse.content,
|
|
||||||
draft_response_reasoning: draftResponse.reasoning,
|
|
||||||
draft_requires_human_approval: true, // ALWAYS
|
|
||||||
|
|
||||||
triaged_at: new Date(),
|
|
||||||
ai_model: 'claude-3-5-sonnet-20241022',
|
|
||||||
framework_compliance: {
|
|
||||||
boundary_enforcer_checked: true,
|
|
||||||
human_approval_required: true,
|
|
||||||
reasoning_transparent: true
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
logger.info(`Triage complete for inquiry ${inquiry._id}: urgency=${urgencyAnalysis.level}, values=${valuesCheck.involves_values}`);
|
|
||||||
|
|
||||||
return triageResult;
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Media triage error:', error);
|
|
||||||
throw new Error(`Triage failed: ${error.message}`);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Analyze urgency level of inquiry
|
|
||||||
*/
|
|
||||||
async analyzeUrgency(inquiry) {
|
|
||||||
const prompt = `Analyze the urgency of this media inquiry and provide a structured assessment.
|
|
||||||
|
|
||||||
INQUIRY DETAILS:
|
|
||||||
Subject: ${inquiry.inquiry.subject}
|
|
||||||
Message: ${inquiry.inquiry.message}
|
|
||||||
Deadline: ${inquiry.inquiry.deadline || 'Not specified'}
|
|
||||||
Outlet: ${inquiry.contact.outlet}
|
|
||||||
|
|
||||||
TASK:
|
|
||||||
1. Determine urgency level: HIGH, MEDIUM, or LOW
|
|
||||||
2. Provide urgency score (0-100)
|
|
||||||
3. Explain your reasoning
|
|
||||||
|
|
||||||
URGENCY GUIDELINES:
|
|
||||||
- HIGH (80-100): Breaking news, same-day deadline, crisis response
|
|
||||||
- MEDIUM (40-79): This week deadline, feature story, ongoing coverage
|
|
||||||
- LOW (0-39): No deadline, background research, general inquiry
|
|
||||||
|
|
||||||
Respond in JSON format:
|
|
||||||
{
|
|
||||||
"level": "HIGH|MEDIUM|LOW",
|
|
||||||
"score": 0-100,
|
|
||||||
"reasoning": "2-3 sentence explanation"
|
|
||||||
}`;
|
|
||||||
|
|
||||||
try {
|
|
||||||
const message = await this.client.messages.create({
|
|
||||||
model: 'claude-3-5-sonnet-20241022',
|
|
||||||
max_tokens: 500,
|
|
||||||
messages: [{
|
|
||||||
role: 'user',
|
|
||||||
content: prompt
|
|
||||||
}]
|
|
||||||
});
|
|
||||||
|
|
||||||
const responseText = message.content[0].text;
|
|
||||||
const analysis = JSON.parse(responseText);
|
|
||||||
|
|
||||||
return {
|
|
||||||
level: analysis.level.toLowerCase(),
|
|
||||||
score: analysis.score,
|
|
||||||
reasoning: analysis.reasoning
|
|
||||||
};
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Urgency analysis error:', error);
|
|
||||||
// Fallback to basic analysis
|
|
||||||
return this.basicUrgencyAnalysis(inquiry);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Analyze topic sensitivity
|
|
||||||
*/
|
|
||||||
async analyzeTopicSensitivity(inquiry) {
|
|
||||||
const prompt = `Analyze the topic sensitivity of this media inquiry for an AI safety framework organization.
|
|
||||||
|
|
||||||
INQUIRY DETAILS:
|
|
||||||
Subject: ${inquiry.inquiry.subject}
|
|
||||||
Message: ${inquiry.inquiry.message}
|
|
||||||
Topics: ${inquiry.inquiry.topic_areas?.join(', ') || 'Not specified'}
|
|
||||||
|
|
||||||
TASK:
|
|
||||||
Determine if this inquiry touches on sensitive topics such as:
|
|
||||||
- Framework values or ethics
|
|
||||||
- Strategic partnerships
|
|
||||||
- Indigenous data sovereignty (Te Tiriti o Waitangi)
|
|
||||||
- Framework limitations or criticisms
|
|
||||||
- Controversial AI safety debates
|
|
||||||
|
|
||||||
Provide sensitivity level: HIGH, MEDIUM, or LOW
|
|
||||||
|
|
||||||
Respond in JSON format:
|
|
||||||
{
|
|
||||||
"level": "HIGH|MEDIUM|LOW",
|
|
||||||
"reasoning": "2-3 sentence explanation of why this topic is sensitive or not"
|
|
||||||
}`;
|
|
||||||
|
|
||||||
try {
|
|
||||||
const message = await this.client.messages.create({
|
|
||||||
model: 'claude-3-5-sonnet-20241022',
|
|
||||||
max_tokens: 500,
|
|
||||||
messages: [{
|
|
||||||
role: 'user',
|
|
||||||
content: prompt
|
|
||||||
}]
|
|
||||||
});
|
|
||||||
|
|
||||||
const responseText = message.content[0].text;
|
|
||||||
const analysis = JSON.parse(responseText);
|
|
||||||
|
|
||||||
return {
|
|
||||||
level: analysis.level.toLowerCase(),
|
|
||||||
reasoning: analysis.reasoning
|
|
||||||
};
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Sensitivity analysis error:', error);
|
|
||||||
// Fallback to keyword-based analysis
|
|
||||||
return this.basicSensitivityAnalysis(inquiry);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Check if inquiry involves framework values (BoundaryEnforcer)
|
|
||||||
*/
|
|
||||||
checkInvolvesValues(inquiry, sensitivityAnalysis) {
|
|
||||||
// Keywords that indicate values territory
|
|
||||||
const valuesKeywords = [
|
|
||||||
'values', 'ethics', 'mission', 'principles', 'philosophy',
|
|
||||||
'te tiriti', 'indigenous', 'sovereignty', 'partnership',
|
|
||||||
'governance', 'strategy', 'direction', 'why tractatus'
|
|
||||||
];
|
|
||||||
|
|
||||||
const combinedText = `${inquiry.inquiry.subject} ${inquiry.inquiry.message}`.toLowerCase();
|
|
||||||
const hasValuesKeyword = valuesKeywords.some(keyword => combinedText.includes(keyword));
|
|
||||||
const isHighSensitivity = sensitivityAnalysis.level === 'high';
|
|
||||||
|
|
||||||
const involves_values = hasValuesKeyword || isHighSensitivity;
|
|
||||||
|
|
||||||
return {
|
|
||||||
involves_values,
|
|
||||||
reasoning: involves_values
|
|
||||||
? 'This inquiry touches on framework values, strategic direction, or sensitive topics. Human approval required for any response (BoundaryEnforcer).'
|
|
||||||
: 'This inquiry is operational/technical in nature. Standard response workflow applies.',
|
|
||||||
boundary_enforcement: involves_values
|
|
||||||
? 'ENFORCED: Response must be reviewed and approved by John Stroh before sending.'
|
|
||||||
: 'NOT_REQUIRED: Standard review process applies.',
|
|
||||||
escalation_required: involves_values,
|
|
||||||
escalation_reason: involves_values
|
|
||||||
? 'Values-sensitive topic detected by BoundaryEnforcer'
|
|
||||||
: null
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate suggested talking points
|
|
||||||
*/
|
|
||||||
async generateTalkingPoints(inquiry, sensitivityAnalysis) {
|
|
||||||
const prompt = `Generate 3-5 concise talking points for responding to this media inquiry about an AI safety framework.
|
|
||||||
|
|
||||||
INQUIRY DETAILS:
|
|
||||||
Subject: ${inquiry.inquiry.subject}
|
|
||||||
Message: ${inquiry.inquiry.message}
|
|
||||||
Sensitivity: ${sensitivityAnalysis.level}
|
|
||||||
|
|
||||||
GUIDELINES:
|
|
||||||
- Focus on factual, verifiable information
|
|
||||||
- Avoid speculation or aspirational claims
|
|
||||||
- Stay within established framework documentation
|
|
||||||
- Be honest about limitations
|
|
||||||
- NO fabricated statistics
|
|
||||||
- NO absolute guarantees
|
|
||||||
|
|
||||||
Respond with JSON array of talking points:
|
|
||||||
["Point 1", "Point 2", "Point 3", ...]`;
|
|
||||||
|
|
||||||
try {
|
|
||||||
const message = await this.client.messages.create({
|
|
||||||
model: 'claude-3-5-sonnet-20241022',
|
|
||||||
max_tokens: 800,
|
|
||||||
messages: [{
|
|
||||||
role: 'user',
|
|
||||||
content: prompt
|
|
||||||
}]
|
|
||||||
});
|
|
||||||
|
|
||||||
const responseText = message.content[0].text;
|
|
||||||
const points = JSON.parse(responseText);
|
|
||||||
|
|
||||||
return Array.isArray(points) ? points : [];
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Talking points generation error:', error);
|
|
||||||
return [
|
|
||||||
'Tractatus is a development-stage AI safety framework',
|
|
||||||
'Focus on architectural safety guarantees and human oversight',
|
|
||||||
'Open source and transparent governance'
|
|
||||||
];
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate draft response (ALWAYS requires human approval)
|
|
||||||
*/
|
|
||||||
async generateDraftResponse(inquiry, talkingPoints, valuesCheck) {
|
|
||||||
const prompt = `Draft a professional response to this media inquiry. This draft will be reviewed and edited by humans before sending.
|
|
||||||
|
|
||||||
INQUIRY DETAILS:
|
|
||||||
From: ${inquiry.contact.name} (${inquiry.contact.outlet})
|
|
||||||
Subject: ${inquiry.inquiry.subject}
|
|
||||||
Message: ${inquiry.inquiry.message}
|
|
||||||
|
|
||||||
TALKING POINTS TO INCLUDE:
|
|
||||||
${talkingPoints.map((p, i) => `${i + 1}. ${p}`).join('\n')}
|
|
||||||
|
|
||||||
VALUES CHECK:
|
|
||||||
${valuesCheck.involves_values ? '⚠️ This touches on framework values - response requires strategic approval' : 'Standard operational inquiry'}
|
|
||||||
|
|
||||||
GUIDELINES:
|
|
||||||
- Professional and helpful tone
|
|
||||||
- 2-3 paragraphs maximum
|
|
||||||
- Include contact info for follow-up
|
|
||||||
- Offer to provide additional resources
|
|
||||||
- Be honest about framework status (development stage)
|
|
||||||
- NO fabricated statistics or guarantees
|
|
||||||
|
|
||||||
Draft the response:`;
|
|
||||||
|
|
||||||
try {
|
|
||||||
const message = await this.client.messages.create({
|
|
||||||
model: 'claude-3-5-sonnet-20241022',
|
|
||||||
max_tokens: 1000,
|
|
||||||
messages: [{
|
|
||||||
role: 'user',
|
|
||||||
content: prompt
|
|
||||||
}]
|
|
||||||
});
|
|
||||||
|
|
||||||
const draftContent = message.content[0].text;
|
|
||||||
|
|
||||||
return {
|
|
||||||
content: draftContent,
|
|
||||||
reasoning: 'AI-generated draft based on talking points. MUST be reviewed and approved by human before sending.',
|
|
||||||
requires_approval: true,
|
|
||||||
approval_level: valuesCheck.involves_values ? 'STRATEGIC' : 'OPERATIONAL'
|
|
||||||
};
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('Draft response generation error:', error);
|
|
||||||
return {
|
|
||||||
content: `[DRAFT GENERATION FAILED - Manual response required]\n\nHi ${inquiry.contact.name},\n\nThank you for your inquiry about Tractatus. We'll get back to you shortly with a detailed response.\n\nBest regards,\nTractatus Team`,
|
|
||||||
reasoning: 'Fallback template due to AI generation error',
|
|
||||||
requires_approval: true,
|
|
||||||
approval_level: 'OPERATIONAL'
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Calculate suggested response time in hours
|
|
||||||
*/
|
|
||||||
calculateResponseTime(urgencyAnalysis, inquiry) {
|
|
||||||
if (inquiry.inquiry.deadline) {
|
|
||||||
const deadline = new Date(inquiry.inquiry.deadline);
|
|
||||||
const now = new Date();
|
|
||||||
const hoursUntilDeadline = (deadline - now) / (1000 * 60 * 60);
|
|
||||||
return Math.max(1, Math.floor(hoursUntilDeadline * 0.5)); // Aim for 50% of time to deadline
|
|
||||||
}
|
|
||||||
|
|
||||||
// Based on urgency score
|
|
||||||
if (urgencyAnalysis.level === 'high') {
|
|
||||||
return 4; // 4 hours
|
|
||||||
} else if (urgencyAnalysis.level === 'medium') {
|
|
||||||
return 24; // 1 day
|
|
||||||
} else {
|
|
||||||
return 72; // 3 days
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Basic urgency analysis (fallback)
|
|
||||||
*/
|
|
||||||
basicUrgencyAnalysis(inquiry) {
|
|
||||||
const text = `${inquiry.inquiry.subject} ${inquiry.inquiry.message}`.toLowerCase();
|
|
||||||
let score = 30; // Default low
|
|
||||||
let level = 'low';
|
|
||||||
|
|
||||||
// Check for urgency keywords
|
|
||||||
for (const [urgencyLevel, keywords] of Object.entries(this.URGENCY_INDICATORS)) {
|
|
||||||
for (const keyword of keywords) {
|
|
||||||
if (text.includes(keyword)) {
|
|
||||||
if (urgencyLevel === 'high') {
|
|
||||||
score = 85;
|
|
||||||
level = 'high';
|
|
||||||
} else if (urgencyLevel === 'medium' && score < 60) {
|
|
||||||
score = 60;
|
|
||||||
level = 'medium';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Check deadline
|
|
||||||
if (inquiry.inquiry.deadline) {
|
|
||||||
const deadline = new Date(inquiry.inquiry.deadline);
|
|
||||||
const now = new Date();
|
|
||||||
const hoursUntilDeadline = (deadline - now) / (1000 * 60 * 60);
|
|
||||||
|
|
||||||
if (hoursUntilDeadline < 24) {
|
|
||||||
score = 90;
|
|
||||||
level = 'high';
|
|
||||||
} else if (hoursUntilDeadline < 72) {
|
|
||||||
score = 65;
|
|
||||||
level = 'medium';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return {
|
|
||||||
level,
|
|
||||||
score,
|
|
||||||
reasoning: `Basic analysis based on keywords and deadline. Urgency level: ${level}.`
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Basic sensitivity analysis (fallback)
|
|
||||||
*/
|
|
||||||
basicSensitivityAnalysis(inquiry) {
|
|
||||||
const text = `${inquiry.inquiry.subject} ${inquiry.inquiry.message}`.toLowerCase();
|
|
||||||
let level = 'low';
|
|
||||||
|
|
||||||
for (const keyword of this.SENSITIVE_TOPICS) {
|
|
||||||
if (text.includes(keyword)) {
|
|
||||||
level = 'high';
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return {
|
|
||||||
level,
|
|
||||||
reasoning: level === 'high'
|
|
||||||
? 'Topic involves potentially sensitive framework areas'
|
|
||||||
: 'Standard operational inquiry'
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get triage statistics for transparency
|
|
||||||
*/
|
|
||||||
async getTriageStats(inquiries) {
|
|
||||||
const stats = {
|
|
||||||
total_triaged: inquiries.length,
|
|
||||||
by_urgency: {
|
|
||||||
high: 0,
|
|
||||||
medium: 0,
|
|
||||||
low: 0
|
|
||||||
},
|
|
||||||
by_sensitivity: {
|
|
||||||
high: 0,
|
|
||||||
medium: 0,
|
|
||||||
low: 0
|
|
||||||
},
|
|
||||||
involves_values_count: 0,
|
|
||||||
boundary_enforcements: 0,
|
|
||||||
avg_response_time_hours: 0,
|
|
||||||
human_overrides: 0
|
|
||||||
};
|
|
||||||
|
|
||||||
for (const inquiry of inquiries) {
|
|
||||||
if (inquiry.ai_triage) {
|
|
||||||
// Count by urgency
|
|
||||||
if (inquiry.ai_triage.urgency) {
|
|
||||||
stats.by_urgency[inquiry.ai_triage.urgency]++;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Count by sensitivity
|
|
||||||
if (inquiry.ai_triage.topic_sensitivity) {
|
|
||||||
stats.by_sensitivity[inquiry.ai_triage.topic_sensitivity]++;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Count values involvements
|
|
||||||
if (inquiry.ai_triage.involves_values) {
|
|
||||||
stats.involves_values_count++;
|
|
||||||
stats.boundary_enforcements++;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Average response time
|
|
||||||
if (inquiry.ai_triage.suggested_response_time) {
|
|
||||||
stats.avg_response_time_hours += inquiry.ai_triage.suggested_response_time;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if (stats.total_triaged > 0) {
|
|
||||||
stats.avg_response_time_hours = Math.round(stats.avg_response_time_hours / stats.total_triaged);
|
|
||||||
}
|
|
||||||
|
|
||||||
return stats;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = new MediaTriageService();
|
|
||||||
|
|
@ -1,515 +0,0 @@
|
||||||
/**
|
|
||||||
* Koha Service
|
|
||||||
* Donation processing service for Tractatus Framework
|
|
||||||
*
|
|
||||||
* Based on passport-consolidated's StripeService pattern
|
|
||||||
* Handles multi-currency donations via Stripe (reusing existing account)
|
|
||||||
*/
|
|
||||||
|
|
||||||
const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);
|
|
||||||
const Donation = require('../models/Donation.model');
|
|
||||||
const {
|
|
||||||
isSupportedCurrency,
|
|
||||||
convertToNZD,
|
|
||||||
getExchangeRate
|
|
||||||
} = require('../config/currencies.config');
|
|
||||||
|
|
||||||
// Simple logger (uses console)
|
|
||||||
const logger = {
|
|
||||||
info: (...args) => console.log(...args),
|
|
||||||
error: (...args) => console.error(...args),
|
|
||||||
warn: (...args) => console.warn(...args)
|
|
||||||
};
|
|
||||||
|
|
||||||
class KohaService {
|
|
||||||
constructor() {
|
|
||||||
this.stripe = stripe;
|
|
||||||
this.priceIds = {
|
|
||||||
// NZD monthly tiers
|
|
||||||
monthly_5: process.env.STRIPE_KOHA_5_PRICE_ID,
|
|
||||||
monthly_15: process.env.STRIPE_KOHA_15_PRICE_ID,
|
|
||||||
monthly_50: process.env.STRIPE_KOHA_50_PRICE_ID,
|
|
||||||
// One-time donation (custom amount)
|
|
||||||
one_time: process.env.STRIPE_KOHA_ONETIME_PRICE_ID
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create a Stripe Checkout session for donation
|
|
||||||
* @param {Object} donationData - Donation details
|
|
||||||
* @returns {Object} Checkout session data
|
|
||||||
*/
|
|
||||||
async createCheckoutSession(donationData) {
|
|
||||||
try {
|
|
||||||
const { amount, currency, frequency, tier, donor, public_acknowledgement, public_name } = donationData;
|
|
||||||
|
|
||||||
// Validate currency
|
|
||||||
const donationCurrency = (currency || 'nzd').toUpperCase();
|
|
||||||
if (!isSupportedCurrency(donationCurrency)) {
|
|
||||||
throw new Error(`Unsupported currency: ${donationCurrency}`);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Validate inputs
|
|
||||||
if (!amount || amount < 100) {
|
|
||||||
throw new Error('Minimum donation amount is $1.00');
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!frequency || !['monthly', 'one_time'].includes(frequency)) {
|
|
||||||
throw new Error('Invalid frequency. Must be "monthly" or "one_time"');
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!donor?.email) {
|
|
||||||
throw new Error('Donor email is required for receipt');
|
|
||||||
}
|
|
||||||
|
|
||||||
// Calculate NZD equivalent for transparency metrics
|
|
||||||
const amountNZD = donationCurrency === 'NZD' ? amount : convertToNZD(amount, donationCurrency);
|
|
||||||
const exchangeRate = getExchangeRate(donationCurrency);
|
|
||||||
|
|
||||||
logger.info(`[KOHA] Creating checkout session: ${frequency} donation of ${donationCurrency} $${amount / 100} (NZD $${amountNZD / 100})`);
|
|
||||||
|
|
||||||
// Create or retrieve Stripe customer
|
|
||||||
let stripeCustomer;
|
|
||||||
try {
|
|
||||||
// Search for existing customer by email
|
|
||||||
const customers = await this.stripe.customers.list({
|
|
||||||
email: donor.email,
|
|
||||||
limit: 1
|
|
||||||
});
|
|
||||||
|
|
||||||
if (customers.data.length > 0) {
|
|
||||||
stripeCustomer = customers.data[0];
|
|
||||||
logger.info(`[KOHA] Using existing customer ${stripeCustomer.id}`);
|
|
||||||
} else {
|
|
||||||
stripeCustomer = await this.stripe.customers.create({
|
|
||||||
email: donor.email,
|
|
||||||
name: donor.name || 'Anonymous Donor',
|
|
||||||
metadata: {
|
|
||||||
source: 'tractatus_koha',
|
|
||||||
public_acknowledgement: public_acknowledgement ? 'yes' : 'no'
|
|
||||||
}
|
|
||||||
});
|
|
||||||
logger.info(`[KOHA] Created new customer ${stripeCustomer.id}`);
|
|
||||||
}
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Failed to create/retrieve customer:', error);
|
|
||||||
throw new Error('Failed to process donor information');
|
|
||||||
}
|
|
||||||
|
|
||||||
// Prepare checkout session parameters
|
|
||||||
const sessionParams = {
|
|
||||||
payment_method_types: ['card'],
|
|
||||||
customer: stripeCustomer.id,
|
|
||||||
mode: frequency === 'monthly' ? 'subscription' : 'payment',
|
|
||||||
success_url: `${process.env.FRONTEND_URL || 'https://agenticgovernance.digital'}/koha/success.html?session_id={CHECKOUT_SESSION_ID}`,
|
|
||||||
cancel_url: `${process.env.FRONTEND_URL || 'https://agenticgovernance.digital'}/koha.html`,
|
|
||||||
metadata: {
|
|
||||||
frequency: frequency,
|
|
||||||
tier: tier,
|
|
||||||
currency: donationCurrency,
|
|
||||||
amount_nzd: String(amountNZD),
|
|
||||||
exchange_rate: String(exchangeRate),
|
|
||||||
donor_name: donor.name || 'Anonymous',
|
|
||||||
public_acknowledgement: public_acknowledgement ? 'yes' : 'no',
|
|
||||||
public_name: public_name || '',
|
|
||||||
source: 'tractatus_website'
|
|
||||||
},
|
|
||||||
allow_promotion_codes: true, // Allow coupon codes
|
|
||||||
billing_address_collection: 'auto'
|
|
||||||
};
|
|
||||||
|
|
||||||
// Add line items based on frequency
|
|
||||||
if (frequency === 'monthly') {
|
|
||||||
// Subscription mode - use price ID for recurring donations
|
|
||||||
const priceId = this.priceIds[`monthly_${tier}`];
|
|
||||||
if (!priceId) {
|
|
||||||
throw new Error(`Invalid monthly tier: ${tier}`);
|
|
||||||
}
|
|
||||||
|
|
||||||
sessionParams.line_items = [{
|
|
||||||
price: priceId,
|
|
||||||
quantity: 1
|
|
||||||
}];
|
|
||||||
|
|
||||||
sessionParams.subscription_data = {
|
|
||||||
metadata: {
|
|
||||||
tier: tier,
|
|
||||||
public_acknowledgement: public_acknowledgement ? 'yes' : 'no'
|
|
||||||
}
|
|
||||||
};
|
|
||||||
} else {
|
|
||||||
// One-time payment mode - use custom amount
|
|
||||||
sessionParams.line_items = [{
|
|
||||||
price_data: {
|
|
||||||
currency: donationCurrency.toLowerCase(),
|
|
||||||
product_data: {
|
|
||||||
name: 'Tractatus Framework Support',
|
|
||||||
description: 'One-time donation to support the Tractatus Framework for AI safety',
|
|
||||||
images: ['https://agenticgovernance.digital/images/tractatus-icon.svg']
|
|
||||||
},
|
|
||||||
unit_amount: amount // Amount in cents
|
|
||||||
},
|
|
||||||
quantity: 1
|
|
||||||
}];
|
|
||||||
|
|
||||||
sessionParams.payment_intent_data = {
|
|
||||||
metadata: {
|
|
||||||
tier: tier || 'custom',
|
|
||||||
public_acknowledgement: public_acknowledgement ? 'yes' : 'no'
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
// Create checkout session
|
|
||||||
const session = await this.stripe.checkout.sessions.create(sessionParams);
|
|
||||||
|
|
||||||
logger.info(`[KOHA] Checkout session created: ${session.id}`);
|
|
||||||
|
|
||||||
// Create pending donation record in database
|
|
||||||
await Donation.create({
|
|
||||||
amount: amount,
|
|
||||||
currency: donationCurrency.toLowerCase(),
|
|
||||||
amount_nzd: amountNZD,
|
|
||||||
exchange_rate_to_nzd: exchangeRate,
|
|
||||||
frequency: frequency,
|
|
||||||
tier: tier,
|
|
||||||
donor: {
|
|
||||||
name: donor.name || 'Anonymous',
|
|
||||||
email: donor.email,
|
|
||||||
country: donor.country
|
|
||||||
},
|
|
||||||
public_acknowledgement: public_acknowledgement || false,
|
|
||||||
public_name: public_name || null,
|
|
||||||
stripe: {
|
|
||||||
customer_id: stripeCustomer.id
|
|
||||||
},
|
|
||||||
status: 'pending',
|
|
||||||
metadata: {
|
|
||||||
source: 'website',
|
|
||||||
session_id: session.id
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
return {
|
|
||||||
sessionId: session.id,
|
|
||||||
checkoutUrl: session.url,
|
|
||||||
frequency: frequency,
|
|
||||||
amount: amount / 100
|
|
||||||
};
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Checkout session creation failed:', error);
|
|
||||||
throw error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle webhook events from Stripe
|
|
||||||
* @param {Object} event - Stripe webhook event
|
|
||||||
*/
|
|
||||||
async handleWebhook(event) {
|
|
||||||
try {
|
|
||||||
logger.info(`[KOHA] Processing webhook event: ${event.type}`);
|
|
||||||
|
|
||||||
switch (event.type) {
|
|
||||||
case 'checkout.session.completed':
|
|
||||||
await this.handleCheckoutComplete(event.data.object);
|
|
||||||
break;
|
|
||||||
|
|
||||||
case 'payment_intent.succeeded':
|
|
||||||
await this.handlePaymentSuccess(event.data.object);
|
|
||||||
break;
|
|
||||||
|
|
||||||
case 'payment_intent.payment_failed':
|
|
||||||
await this.handlePaymentFailure(event.data.object);
|
|
||||||
break;
|
|
||||||
|
|
||||||
case 'invoice.paid':
|
|
||||||
// Recurring subscription payment succeeded
|
|
||||||
await this.handleInvoicePaid(event.data.object);
|
|
||||||
break;
|
|
||||||
|
|
||||||
case 'invoice.payment_failed':
|
|
||||||
// Recurring subscription payment failed
|
|
||||||
await this.handleInvoicePaymentFailed(event.data.object);
|
|
||||||
break;
|
|
||||||
|
|
||||||
case 'customer.subscription.created':
|
|
||||||
case 'customer.subscription.updated':
|
|
||||||
await this.handleSubscriptionUpdate(event.data.object);
|
|
||||||
break;
|
|
||||||
|
|
||||||
case 'customer.subscription.deleted':
|
|
||||||
await this.handleSubscriptionCancellation(event.data.object);
|
|
||||||
break;
|
|
||||||
|
|
||||||
default:
|
|
||||||
logger.info(`[KOHA] Unhandled webhook event type: ${event.type}`);
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Webhook processing error:', error);
|
|
||||||
throw error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle successful checkout completion
|
|
||||||
*/
|
|
||||||
async handleCheckoutComplete(session) {
|
|
||||||
try {
|
|
||||||
const frequency = session.metadata.frequency;
|
|
||||||
const tier = session.metadata.tier;
|
|
||||||
const currency = session.metadata.currency || session.currency?.toUpperCase() || 'NZD';
|
|
||||||
const amountNZD = session.metadata.amount_nzd ? parseInt(session.metadata.amount_nzd) : session.amount_total;
|
|
||||||
const exchangeRate = session.metadata.exchange_rate ? parseFloat(session.metadata.exchange_rate) : 1.0;
|
|
||||||
|
|
||||||
logger.info(`[KOHA] Checkout completed: ${frequency} donation, tier: ${tier}, currency: ${currency}`);
|
|
||||||
|
|
||||||
// Find pending donation or create new one
|
|
||||||
let donation = await Donation.findByPaymentIntentId(session.payment_intent);
|
|
||||||
|
|
||||||
if (!donation) {
|
|
||||||
// Create donation record from session data
|
|
||||||
donation = await Donation.create({
|
|
||||||
amount: session.amount_total,
|
|
||||||
currency: currency.toLowerCase(),
|
|
||||||
amount_nzd: amountNZD,
|
|
||||||
exchange_rate_to_nzd: exchangeRate,
|
|
||||||
frequency: frequency,
|
|
||||||
tier: tier,
|
|
||||||
donor: {
|
|
||||||
name: session.metadata.donor_name || 'Anonymous',
|
|
||||||
email: session.customer_email
|
|
||||||
},
|
|
||||||
public_acknowledgement: session.metadata.public_acknowledgement === 'yes',
|
|
||||||
public_name: session.metadata.public_name || null,
|
|
||||||
stripe: {
|
|
||||||
customer_id: session.customer,
|
|
||||||
subscription_id: session.subscription || null,
|
|
||||||
payment_intent_id: session.payment_intent
|
|
||||||
},
|
|
||||||
status: 'completed',
|
|
||||||
payment_date: new Date()
|
|
||||||
});
|
|
||||||
} else {
|
|
||||||
// Update existing donation
|
|
||||||
await Donation.updateStatus(donation._id, 'completed', {
|
|
||||||
'stripe.subscription_id': session.subscription || null,
|
|
||||||
'stripe.payment_intent_id': session.payment_intent,
|
|
||||||
payment_date: new Date()
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
// Send receipt email (async, don't wait)
|
|
||||||
this.sendReceiptEmail(donation).catch(err =>
|
|
||||||
logger.error('[KOHA] Failed to send receipt email:', err)
|
|
||||||
);
|
|
||||||
|
|
||||||
logger.info(`[KOHA] Donation recorded: ${currency} $${session.amount_total / 100} (NZD $${amountNZD / 100})`);
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Error handling checkout completion:', error);
|
|
||||||
throw error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle successful payment
|
|
||||||
*/
|
|
||||||
async handlePaymentSuccess(paymentIntent) {
|
|
||||||
try {
|
|
||||||
logger.info(`[KOHA] Payment succeeded: ${paymentIntent.id}`);
|
|
||||||
|
|
||||||
const donation = await Donation.findByPaymentIntentId(paymentIntent.id);
|
|
||||||
if (donation && donation.status === 'pending') {
|
|
||||||
await Donation.updateStatus(donation._id, 'completed', {
|
|
||||||
payment_date: new Date()
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Error handling payment success:', error);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle failed payment
|
|
||||||
*/
|
|
||||||
async handlePaymentFailure(paymentIntent) {
|
|
||||||
try {
|
|
||||||
logger.warn(`[KOHA] Payment failed: ${paymentIntent.id}`);
|
|
||||||
|
|
||||||
const donation = await Donation.findByPaymentIntentId(paymentIntent.id);
|
|
||||||
if (donation) {
|
|
||||||
await Donation.updateStatus(donation._id, 'failed', {
|
|
||||||
'metadata.failure_reason': paymentIntent.last_payment_error?.message
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Error handling payment failure:', error);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle paid invoice (recurring subscription payment)
|
|
||||||
*/
|
|
||||||
async handleInvoicePaid(invoice) {
|
|
||||||
try {
|
|
||||||
logger.info(`[KOHA] Invoice paid: ${invoice.id} for subscription ${invoice.subscription}`);
|
|
||||||
|
|
||||||
// Create new donation record for this recurring payment
|
|
||||||
const subscription = await this.stripe.subscriptions.retrieve(invoice.subscription);
|
|
||||||
|
|
||||||
// Get currency from invoice or metadata
|
|
||||||
const currency = (invoice.currency || subscription.metadata.currency || 'NZD').toUpperCase();
|
|
||||||
const amount = invoice.amount_paid;
|
|
||||||
|
|
||||||
// Calculate NZD equivalent
|
|
||||||
const amountNZD = currency === 'NZD' ? amount : convertToNZD(amount, currency);
|
|
||||||
const exchangeRate = getExchangeRate(currency);
|
|
||||||
|
|
||||||
await Donation.create({
|
|
||||||
amount: amount,
|
|
||||||
currency: currency.toLowerCase(),
|
|
||||||
amount_nzd: amountNZD,
|
|
||||||
exchange_rate_to_nzd: exchangeRate,
|
|
||||||
frequency: 'monthly',
|
|
||||||
tier: subscription.metadata.tier,
|
|
||||||
donor: {
|
|
||||||
email: invoice.customer_email
|
|
||||||
},
|
|
||||||
public_acknowledgement: subscription.metadata.public_acknowledgement === 'yes',
|
|
||||||
stripe: {
|
|
||||||
customer_id: invoice.customer,
|
|
||||||
subscription_id: invoice.subscription,
|
|
||||||
invoice_id: invoice.id,
|
|
||||||
charge_id: invoice.charge
|
|
||||||
},
|
|
||||||
status: 'completed',
|
|
||||||
payment_date: new Date(invoice.created * 1000)
|
|
||||||
});
|
|
||||||
|
|
||||||
logger.info(`[KOHA] Recurring donation recorded: ${currency} $${amount / 100} (NZD $${amountNZD / 100})`);
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Error handling invoice paid:', error);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle failed invoice payment
|
|
||||||
*/
|
|
||||||
async handleInvoicePaymentFailed(invoice) {
|
|
||||||
try {
|
|
||||||
logger.warn(`[KOHA] Invoice payment failed: ${invoice.id}`);
|
|
||||||
// Could send notification email to donor here
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Error handling invoice payment failed:', error);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle subscription updates
|
|
||||||
*/
|
|
||||||
async handleSubscriptionUpdate(subscription) {
|
|
||||||
logger.info(`[KOHA] Subscription updated: ${subscription.id}, status: ${subscription.status}`);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Handle subscription cancellation
|
|
||||||
*/
|
|
||||||
async handleSubscriptionCancellation(subscription) {
|
|
||||||
try {
|
|
||||||
logger.info(`[KOHA] Subscription cancelled: ${subscription.id}`);
|
|
||||||
|
|
||||||
await Donation.cancelSubscription(subscription.id);
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Error handling subscription cancellation:', error);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Verify webhook signature
|
|
||||||
*/
|
|
||||||
verifyWebhookSignature(payload, signature) {
|
|
||||||
try {
|
|
||||||
return this.stripe.webhooks.constructEvent(
|
|
||||||
payload,
|
|
||||||
signature,
|
|
||||||
process.env.STRIPE_KOHA_WEBHOOK_SECRET
|
|
||||||
);
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Webhook signature verification failed:', error);
|
|
||||||
throw new Error('Invalid webhook signature');
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get transparency metrics for public dashboard
|
|
||||||
*/
|
|
||||||
async getTransparencyMetrics() {
|
|
||||||
try {
|
|
||||||
return await Donation.getTransparencyMetrics();
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Error getting transparency metrics:', error);
|
|
||||||
throw error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Send receipt email (placeholder)
|
|
||||||
*/
|
|
||||||
async sendReceiptEmail(donation) {
|
|
||||||
// TODO: Implement email service integration
|
|
||||||
logger.info(`[KOHA] Receipt email would be sent to ${donation.donor.email}`);
|
|
||||||
|
|
||||||
// Generate receipt number
|
|
||||||
const receiptNumber = `KOHA-${new Date().getFullYear()}-${String(donation._id).slice(-8).toUpperCase()}`;
|
|
||||||
|
|
||||||
await Donation.markReceiptSent(donation._id, receiptNumber);
|
|
||||||
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Cancel a recurring donation (admin or donor-initiated)
|
|
||||||
*/
|
|
||||||
async cancelRecurringDonation(subscriptionId) {
|
|
||||||
try {
|
|
||||||
logger.info(`[KOHA] Cancelling subscription: ${subscriptionId}`);
|
|
||||||
|
|
||||||
// Cancel in Stripe
|
|
||||||
await this.stripe.subscriptions.cancel(subscriptionId);
|
|
||||||
|
|
||||||
// Update database
|
|
||||||
await Donation.cancelSubscription(subscriptionId);
|
|
||||||
|
|
||||||
return { success: true, message: 'Subscription cancelled successfully' };
|
|
||||||
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Error cancelling subscription:', error);
|
|
||||||
throw error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get donation statistics (admin only)
|
|
||||||
*/
|
|
||||||
async getStatistics(startDate = null, endDate = null) {
|
|
||||||
try {
|
|
||||||
return await Donation.getStatistics(startDate, endDate);
|
|
||||||
} catch (error) {
|
|
||||||
logger.error('[KOHA] Error getting statistics:', error);
|
|
||||||
throw error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Create singleton instance
|
|
||||||
const kohaService = new KohaService();
|
|
||||||
|
|
||||||
module.exports = kohaService;
|
|
||||||
|
|
@ -1,267 +0,0 @@
|
||||||
/**
|
|
||||||
* Document Section Parser
|
|
||||||
* Analyzes markdown documents and creates card-based sections
|
|
||||||
*/
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Parse document into sections based on H2 headings
|
|
||||||
*/
|
|
||||||
function parseDocumentSections(markdown, contentHtml) {
|
|
||||||
if (!markdown) return [];
|
|
||||||
|
|
||||||
const sections = [];
|
|
||||||
const lines = markdown.split('\n');
|
|
||||||
let currentSection = null;
|
|
||||||
let sectionContent = [];
|
|
||||||
|
|
||||||
// Find H1 (document title) first
|
|
||||||
let documentTitle = '';
|
|
||||||
for (let i = 0; i < lines.length; i++) {
|
|
||||||
const line = lines[i];
|
|
||||||
const h1Match = line.match(/^#\s+(.+)$/);
|
|
||||||
if (h1Match) {
|
|
||||||
documentTitle = h1Match[1].trim();
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Parse sections by H2 headings
|
|
||||||
for (let i = 0; i < lines.length; i++) {
|
|
||||||
const line = lines[i];
|
|
||||||
|
|
||||||
// Check for H2 heading (## Heading)
|
|
||||||
const h2Match = line.match(/^##\s+(.+)$/);
|
|
||||||
|
|
||||||
if (h2Match) {
|
|
||||||
// Save previous section if exists
|
|
||||||
if (currentSection) {
|
|
||||||
currentSection.content = sectionContent.join('\n').trim();
|
|
||||||
currentSection.excerpt = extractExcerpt(currentSection.content);
|
|
||||||
currentSection.readingTime = estimateReadingTime(currentSection.content);
|
|
||||||
currentSection.technicalLevel = detectTechnicalLevel(currentSection.content);
|
|
||||||
currentSection.category = categorizeSection(currentSection.title, currentSection.content);
|
|
||||||
sections.push(currentSection);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Start new section
|
|
||||||
const title = h2Match[1].trim();
|
|
||||||
const slug = generateSlug(title);
|
|
||||||
|
|
||||||
currentSection = {
|
|
||||||
title,
|
|
||||||
slug,
|
|
||||||
level: 2,
|
|
||||||
content: '',
|
|
||||||
excerpt: '',
|
|
||||||
readingTime: 0,
|
|
||||||
technicalLevel: 'basic',
|
|
||||||
category: 'conceptual'
|
|
||||||
};
|
|
||||||
|
|
||||||
// Include the H2 heading itself in the section content
|
|
||||||
sectionContent = [line];
|
|
||||||
} else if (currentSection) {
|
|
||||||
// Only add content until we hit another H2 or H1
|
|
||||||
const isH1 = line.match(/^#\s+[^#]/);
|
|
||||||
|
|
||||||
if (isH1) {
|
|
||||||
// Skip H1 (document title) - don't add to section
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Add all other content (including H3, H4, paragraphs, etc.)
|
|
||||||
sectionContent.push(line);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Save last section
|
|
||||||
if (currentSection && sectionContent.length > 0) {
|
|
||||||
currentSection.content = sectionContent.join('\n').trim();
|
|
||||||
currentSection.excerpt = extractExcerpt(currentSection.content);
|
|
||||||
currentSection.readingTime = estimateReadingTime(currentSection.content);
|
|
||||||
currentSection.technicalLevel = detectTechnicalLevel(currentSection.content);
|
|
||||||
currentSection.category = categorizeSection(currentSection.title, currentSection.content);
|
|
||||||
sections.push(currentSection);
|
|
||||||
}
|
|
||||||
|
|
||||||
return sections;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Extract excerpt from content (first 2-3 sentences, max 150 chars)
|
|
||||||
*/
|
|
||||||
function extractExcerpt(content) {
|
|
||||||
if (!content) return '';
|
|
||||||
|
|
||||||
// Remove markdown formatting
|
|
||||||
let text = content
|
|
||||||
.replace(/^#+\s+/gm, '') // Remove headings
|
|
||||||
.replace(/\*\*(.+?)\*\*/g, '$1') // Remove bold
|
|
||||||
.replace(/\*(.+?)\*/g, '$1') // Remove italic
|
|
||||||
.replace(/`(.+?)`/g, '$1') // Remove code
|
|
||||||
.replace(/\[(.+?)\]\(.+?\)/g, '$1') // Remove links
|
|
||||||
.replace(/^[-*]\s+/gm, '') // Remove list markers
|
|
||||||
.replace(/^\d+\.\s+/gm, '') // Remove numbered lists
|
|
||||||
.replace(/^>\s+/gm, '') // Remove blockquotes
|
|
||||||
.replace(/\n+/g, ' ') // Collapse newlines
|
|
||||||
.trim();
|
|
||||||
|
|
||||||
// Get first 2-3 sentences
|
|
||||||
const sentences = text.match(/[^.!?]+[.!?]+/g) || [text];
|
|
||||||
let excerpt = sentences.slice(0, 2).join(' ');
|
|
||||||
|
|
||||||
// Truncate to 150 chars if needed
|
|
||||||
if (excerpt.length > 150) {
|
|
||||||
excerpt = excerpt.substring(0, 147) + '...';
|
|
||||||
}
|
|
||||||
|
|
||||||
return excerpt;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Estimate reading time in minutes (avg 200 words/min)
|
|
||||||
*/
|
|
||||||
function estimateReadingTime(content) {
|
|
||||||
if (!content) return 1;
|
|
||||||
|
|
||||||
const words = content.split(/\s+/).length;
|
|
||||||
const minutes = Math.ceil(words / 200);
|
|
||||||
|
|
||||||
return Math.max(1, minutes);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Detect technical level based on content
|
|
||||||
*/
|
|
||||||
function detectTechnicalLevel(content) {
|
|
||||||
if (!content) return 'basic';
|
|
||||||
|
|
||||||
const lowerContent = content.toLowerCase();
|
|
||||||
|
|
||||||
// Technical indicators
|
|
||||||
const technicalTerms = [
|
|
||||||
'api', 'database', 'mongodb', 'algorithm', 'architecture',
|
|
||||||
'implementation', 'node.js', 'javascript', 'typescript',
|
|
||||||
'async', 'await', 'promise', 'class', 'function',
|
|
||||||
'middleware', 'authentication', 'authorization', 'encryption',
|
|
||||||
'hash', 'token', 'jwt', 'rest', 'graphql'
|
|
||||||
];
|
|
||||||
|
|
||||||
const advancedTerms = [
|
|
||||||
'metacognitive', 'stochastic', 'quadrant classification',
|
|
||||||
'intersection observer', 'csp', 'security policy',
|
|
||||||
'cross-reference validation', 'boundary enforcement',
|
|
||||||
'architectural constraints', 'formal verification'
|
|
||||||
];
|
|
||||||
|
|
||||||
let technicalScore = 0;
|
|
||||||
let advancedScore = 0;
|
|
||||||
|
|
||||||
// Count technical terms
|
|
||||||
technicalTerms.forEach(term => {
|
|
||||||
const regex = new RegExp(`\\b${term}\\b`, 'gi');
|
|
||||||
const matches = lowerContent.match(regex);
|
|
||||||
if (matches) technicalScore += matches.length;
|
|
||||||
});
|
|
||||||
|
|
||||||
// Count advanced terms
|
|
||||||
advancedTerms.forEach(term => {
|
|
||||||
const regex = new RegExp(`\\b${term}\\b`, 'gi');
|
|
||||||
const matches = lowerContent.match(regex);
|
|
||||||
if (matches) advancedScore += matches.length;
|
|
||||||
});
|
|
||||||
|
|
||||||
// Check for code blocks
|
|
||||||
const codeBlocks = (content.match(/```/g) || []).length / 2;
|
|
||||||
technicalScore += codeBlocks * 3;
|
|
||||||
|
|
||||||
// Determine level
|
|
||||||
if (advancedScore >= 3 || technicalScore >= 15) {
|
|
||||||
return 'advanced';
|
|
||||||
} else if (technicalScore >= 5) {
|
|
||||||
return 'intermediate';
|
|
||||||
} else {
|
|
||||||
return 'basic';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Categorize section based on title and content
|
|
||||||
*/
|
|
||||||
function categorizeSection(title, content) {
|
|
||||||
const lowerTitle = title.toLowerCase();
|
|
||||||
const lowerContent = content.toLowerCase();
|
|
||||||
|
|
||||||
// Category keywords
|
|
||||||
const categories = {
|
|
||||||
conceptual: [
|
|
||||||
'what is', 'introduction', 'overview', 'why', 'philosophy',
|
|
||||||
'concept', 'theory', 'principle', 'background', 'motivation'
|
|
||||||
],
|
|
||||||
technical: [
|
|
||||||
'architecture', 'implementation', 'technical', 'code', 'api',
|
|
||||||
'configuration', 'setup', 'installation', 'integration',
|
|
||||||
'class', 'function', 'service', 'component'
|
|
||||||
],
|
|
||||||
practical: [
|
|
||||||
'quick start', 'tutorial', 'guide', 'how to', 'example',
|
|
||||||
'walkthrough', 'getting started', 'usage', 'practice'
|
|
||||||
],
|
|
||||||
reference: [
|
|
||||||
'reference', 'api', 'specification', 'documentation',
|
|
||||||
'glossary', 'terms', 'definitions', 'index'
|
|
||||||
],
|
|
||||||
critical: [
|
|
||||||
'security', 'warning', 'important', 'critical', 'boundary',
|
|
||||||
'safety', 'risk', 'violation', 'error', 'failure'
|
|
||||||
]
|
|
||||||
};
|
|
||||||
|
|
||||||
// Check title first (higher weight)
|
|
||||||
for (const [category, keywords] of Object.entries(categories)) {
|
|
||||||
for (const keyword of keywords) {
|
|
||||||
if (lowerTitle.includes(keyword)) {
|
|
||||||
return category;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Check content (lower weight)
|
|
||||||
const contentScores = {};
|
|
||||||
for (const [category, keywords] of Object.entries(categories)) {
|
|
||||||
contentScores[category] = 0;
|
|
||||||
for (const keyword of keywords) {
|
|
||||||
const regex = new RegExp(`\\b${keyword}\\b`, 'gi');
|
|
||||||
const matches = lowerContent.match(regex);
|
|
||||||
if (matches) contentScores[category] += matches.length;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Return category with highest score
|
|
||||||
const maxCategory = Object.keys(contentScores).reduce((a, b) =>
|
|
||||||
contentScores[a] > contentScores[b] ? a : b
|
|
||||||
);
|
|
||||||
|
|
||||||
return contentScores[maxCategory] > 0 ? maxCategory : 'conceptual';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate URL-safe slug from title
|
|
||||||
*/
|
|
||||||
function generateSlug(title) {
|
|
||||||
return title
|
|
||||||
.toLowerCase()
|
|
||||||
.replace(/[^\w\s-]/g, '')
|
|
||||||
.replace(/\s+/g, '-')
|
|
||||||
.replace(/-+/g, '-')
|
|
||||||
.trim();
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
parseDocumentSections,
|
|
||||||
extractExcerpt,
|
|
||||||
estimateReadingTime,
|
|
||||||
detectTechnicalLevel,
|
|
||||||
categorizeSection,
|
|
||||||
generateSlug
|
|
||||||
};
|
|
||||||
|
|
@ -1,58 +0,0 @@
|
||||||
/**
|
|
||||||
* JWT Utility
|
|
||||||
* Token generation and verification for admin authentication
|
|
||||||
*/
|
|
||||||
|
|
||||||
const jwt = require('jsonwebtoken');
|
|
||||||
|
|
||||||
const JWT_SECRET = process.env.JWT_SECRET || 'CHANGE_THIS_IN_PRODUCTION';
|
|
||||||
const JWT_EXPIRY = process.env.JWT_EXPIRY || '7d';
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate JWT token
|
|
||||||
*/
|
|
||||||
function generateToken(payload) {
|
|
||||||
return jwt.sign(payload, JWT_SECRET, {
|
|
||||||
expiresIn: JWT_EXPIRY,
|
|
||||||
issuer: 'tractatus',
|
|
||||||
audience: 'tractatus-admin'
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Verify JWT token
|
|
||||||
*/
|
|
||||||
function verifyToken(token) {
|
|
||||||
try {
|
|
||||||
return jwt.verify(token, JWT_SECRET, {
|
|
||||||
issuer: 'tractatus',
|
|
||||||
audience: 'tractatus-admin'
|
|
||||||
});
|
|
||||||
} catch (error) {
|
|
||||||
throw new Error(`Invalid token: ${error.message}`);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Decode token without verification (for debugging)
|
|
||||||
*/
|
|
||||||
function decodeToken(token) {
|
|
||||||
return jwt.decode(token);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Extract token from Authorization header
|
|
||||||
*/
|
|
||||||
function extractTokenFromHeader(authHeader) {
|
|
||||||
if (!authHeader || !authHeader.startsWith('Bearer ')) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
return authHeader.substring(7);
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
generateToken,
|
|
||||||
verifyToken,
|
|
||||||
decodeToken,
|
|
||||||
extractTokenFromHeader
|
|
||||||
};
|
|
||||||
|
|
@ -1,169 +0,0 @@
|
||||||
/**
|
|
||||||
* Markdown Utility
|
|
||||||
* Convert markdown to HTML with syntax highlighting
|
|
||||||
*/
|
|
||||||
|
|
||||||
const { marked } = require('marked');
|
|
||||||
const hljs = require('highlight.js');
|
|
||||||
const sanitizeHtml = require('sanitize-html');
|
|
||||||
|
|
||||||
// Custom renderer to add IDs to headings
|
|
||||||
const renderer = new marked.Renderer();
|
|
||||||
const originalHeadingRenderer = renderer.heading.bind(renderer);
|
|
||||||
|
|
||||||
renderer.heading = function(text, level, raw) {
|
|
||||||
// Generate slug from heading text
|
|
||||||
const slug = raw
|
|
||||||
.toLowerCase()
|
|
||||||
.replace(/[^\w\s-]/g, '')
|
|
||||||
.replace(/\s+/g, '-')
|
|
||||||
.replace(/-+/g, '-')
|
|
||||||
.trim();
|
|
||||||
|
|
||||||
return `<h${level} id="${slug}">${text}</h${level}>`;
|
|
||||||
};
|
|
||||||
|
|
||||||
// Configure marked
|
|
||||||
marked.setOptions({
|
|
||||||
renderer: renderer,
|
|
||||||
highlight: function(code, lang) {
|
|
||||||
if (lang && hljs.getLanguage(lang)) {
|
|
||||||
try {
|
|
||||||
return hljs.highlight(code, { language: lang }).value;
|
|
||||||
} catch (err) {
|
|
||||||
console.error('Highlight error:', err);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return hljs.highlightAuto(code).value;
|
|
||||||
},
|
|
||||||
gfm: true,
|
|
||||||
breaks: false,
|
|
||||||
pedantic: false,
|
|
||||||
smartLists: true,
|
|
||||||
smartypants: true
|
|
||||||
});
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Convert markdown to HTML
|
|
||||||
*/
|
|
||||||
function markdownToHtml(markdown) {
|
|
||||||
if (!markdown) return '';
|
|
||||||
|
|
||||||
const html = marked(markdown);
|
|
||||||
|
|
||||||
// Sanitize HTML to prevent XSS
|
|
||||||
return sanitizeHtml(html, {
|
|
||||||
allowedTags: [
|
|
||||||
'h1', 'h2', 'h3', 'h4', 'h5', 'h6',
|
|
||||||
'p', 'br', 'hr',
|
|
||||||
'strong', 'em', 'u', 'code', 'pre',
|
|
||||||
'a', 'img',
|
|
||||||
'ul', 'ol', 'li',
|
|
||||||
'blockquote',
|
|
||||||
'table', 'thead', 'tbody', 'tr', 'th', 'td',
|
|
||||||
'div', 'span',
|
|
||||||
'sup', 'sub',
|
|
||||||
'del', 'ins'
|
|
||||||
],
|
|
||||||
allowedAttributes: {
|
|
||||||
'a': ['href', 'title', 'target', 'rel'],
|
|
||||||
'img': ['src', 'alt', 'title', 'width', 'height'],
|
|
||||||
'h1': ['id'],
|
|
||||||
'h2': ['id'],
|
|
||||||
'h3': ['id'],
|
|
||||||
'h4': ['id'],
|
|
||||||
'h5': ['id'],
|
|
||||||
'h6': ['id'],
|
|
||||||
'code': ['class'],
|
|
||||||
'pre': ['class'],
|
|
||||||
'div': ['class'],
|
|
||||||
'span': ['class'],
|
|
||||||
'table': ['class'],
|
|
||||||
'th': ['scope', 'class'],
|
|
||||||
'td': ['class']
|
|
||||||
},
|
|
||||||
allowedClasses: {
|
|
||||||
'code': ['language-*', 'hljs', 'hljs-*'],
|
|
||||||
'pre': ['hljs'],
|
|
||||||
'div': ['highlight'],
|
|
||||||
'span': ['hljs-*']
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Extract table of contents from markdown
|
|
||||||
*/
|
|
||||||
function extractTOC(markdown) {
|
|
||||||
if (!markdown) return [];
|
|
||||||
|
|
||||||
const headings = [];
|
|
||||||
const lines = markdown.split('\n');
|
|
||||||
|
|
||||||
lines.forEach(line => {
|
|
||||||
const match = line.match(/^(#{1,6})\s+(.+)$/);
|
|
||||||
if (match) {
|
|
||||||
const level = match[1].length;
|
|
||||||
const title = match[2].replace(/[#*_`]/g, '').trim();
|
|
||||||
const slug = title.toLowerCase()
|
|
||||||
.replace(/[^\w\s-]/g, '')
|
|
||||||
.replace(/\s+/g, '-')
|
|
||||||
.replace(/-+/g, '-')
|
|
||||||
.trim();
|
|
||||||
|
|
||||||
headings.push({
|
|
||||||
level,
|
|
||||||
title,
|
|
||||||
slug
|
|
||||||
});
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
return headings;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Extract front matter from markdown
|
|
||||||
*/
|
|
||||||
function extractFrontMatter(markdown) {
|
|
||||||
if (!markdown) return { metadata: {}, content: markdown };
|
|
||||||
|
|
||||||
const frontMatterRegex = /^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)$/;
|
|
||||||
const match = markdown.match(frontMatterRegex);
|
|
||||||
|
|
||||||
if (!match) {
|
|
||||||
return { metadata: {}, content: markdown };
|
|
||||||
}
|
|
||||||
|
|
||||||
const frontMatter = match[1];
|
|
||||||
const content = match[2];
|
|
||||||
const metadata = {};
|
|
||||||
|
|
||||||
frontMatter.split('\n').forEach(line => {
|
|
||||||
const [key, ...valueParts] = line.split(':');
|
|
||||||
if (key && valueParts.length) {
|
|
||||||
metadata[key.trim()] = valueParts.join(':').trim();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
return { metadata, content };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Generate slug from title
|
|
||||||
*/
|
|
||||||
function generateSlug(title) {
|
|
||||||
return title
|
|
||||||
.toLowerCase()
|
|
||||||
.replace(/[^\w\s-]/g, '')
|
|
||||||
.replace(/\s+/g, '-')
|
|
||||||
.replace(/-+/g, '-')
|
|
||||||
.trim();
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
markdownToHtml,
|
|
||||||
extractTOC,
|
|
||||||
extractFrontMatter,
|
|
||||||
generateSlug
|
|
||||||
};
|
|
||||||
Loading…
Add table
Reference in a new issue