@tfw.in/structura-lib 0.2.0 → 0.2.2

package/SAVE_FUNCTIONALITY_COMPLETE.md

@@ -1,448 +0,0 @@
-# Save Functionality - Production Implementation
-
-## Overview
-
-A production-ready, scalable save system that automatically handles any PDF/JSON combination without pre-configuration.
-
-## Key Design Principles
-
-✅ **Zero Configuration**: No manual database setup or seeding required
-✅ **Auto-initialization**: Documents created automatically on first save
-✅ **Version Tracking**: Full edit history preserved
-✅ **Scalability**: Works with any PDF/JSON combination
-✅ **Baseline Preservation**: Original JSON stored for diffs
-
-## Architecture
-
-```
-User → Load PDF + JSON → Edit Content → Save
-                                          │
-                                          ▼
-                                First Save?
-                                    │
-                      ┌─────────────┴─────────────┐
-                      │                           │
-                    YES                          NO
-                      │                           │
-                      ▼                           ▼
-        Create document with          Find existing document
-        originalJson baseline
-                      │                           │
-                      └─────────────┬─────────────┘
-                                    │
-                                    ▼
-                          Save edit with editedJson
-                                    │
-                                    ▼
-                          Store in SQLite with timestamp
-```
-
-## How It Works
-
-### First Save Flow
-
-1. **User loads document**
-   ```
-   http://localhost:5175/?pdf=/doc.pdf&json=/data.json
-   ```
-
-2. **Frontend loads JSON**
-   - `mockData`: Current state for editing
-   - `originalData`: Baseline for database
-
-3. **User makes edits and clicks Save**
-
-4. **Frontend sends to server**
-   ```json
-   {
-     "pdfName": "doc.pdf",
-     "editedJson": { /* edited state */ },
-     "originalJson": { /* original baseline */ }
-   }
-   ```
-
-5. **Backend creates document**
-   - Stores originalJson in `documents` table
-   - Stores editedJson in `edits` table
-   - Returns document ID + edit ID
-
-6. **Frontend clears originalData**
-   - Subsequent saves only send editedJson
-
-### Subsequent Save Flow
-
-1. **User makes more edits and clicks Save**
-
-2. **Frontend sends to server**
-   ```json
-   {
-     "pdfName": "doc.pdf",
-     "editedJson": { /* new state */ }
-   }
-   ```
-
-3. **Backend finds existing document**
-   - Creates new entry in `edits` table
-   - Returns document ID + edit ID
-
-## API Endpoints
-
-### POST /api/save
-
-Save edited document (creates document on first save).
-
-**Request:**
-```json
-{
-  "pdfName": "document.pdf",
-  "editedJson": { /* current state */ },
-  "originalJson": { /* baseline (first save only) */ },
-  "summary": "Optional description"
-}
-```
-
-**Response:**
-```json
-{
-  "success": true,
-  "documentId": 1,
-  "editId": 1,
-  "message": "Document saved successfully"
-}
-```
-
-### GET /api/load/:pdfName
-
-Load document with latest edit.
-
-**Response:**
-```json
-{
-  "success": true,
-  "document": {
-    "id": 1,
-    "pdfName": "document.pdf",
-    "originalJson": { /* baseline */ },
-    "currentJson": { /* latest state */ },
-    "latestEdit": {
-      "id": 5,
-      "edit_summary": "Edit via UI",
-      "created_at": "2025-11-18 10:00:00"
-    }
-  }
-}
-```
-
-### GET /api/history/:pdfName
-
-Get full edit history.
-
-**Response:**
-```json
-{
-  "success": true,
-  "document": { "id": 1, "pdfName": "document.pdf" },
-  "history": [
-    { "id": 5, "edited_json": {}, "created_at": "2025-11-18 10:00:00" },
-    { "id": 4, "edited_json": {}, "created_at": "2025-11-18 09:55:00" }
-  ]
-}
-```
-
-### GET /health
-
-Health check endpoint.
-
-**Response:**
-```json
-{
-  "status": "ok",
-  "timestamp": "2025-11-18T10:00:00.000Z"
-}
-```
-
-## Database Schema
-
-### documents table
-```sql
-CREATE TABLE documents (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  pdf_name TEXT NOT NULL,           -- Unique key
-  original_json TEXT NOT NULL,      -- Baseline
-  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
-);
-```
-
-### edits table
-```sql
-CREATE TABLE edits (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  document_id INTEGER NOT NULL,
-  edited_json TEXT NOT NULL,        -- Full state
-  edit_summary TEXT,
-  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-  FOREIGN KEY (document_id) REFERENCES documents(id)
-);
-```
-
-## Usage
-
-### Start the server
-
-```bash
-cd /Users/__chaks__/learn/saral-next/old-lib
-npm run server
-```
-
-Server runs on: `http://localhost:3002`
-
-### Use with any PDF/JSON
-
-```
-http://localhost:5175/?pdf=/your-file.pdf&json=/your-data.json
-```
-
-1. Double-click text to edit
-2. Click green **Save** button
-3. Document automatically created in database
-4. Subsequent edits tracked with full history
-
-### Load previous session
-
-```javascript
-// Fetch last saved state
-fetch('http://localhost:3002/api/load/your-file.pdf')
-  .then(res => res.json())
-  .then(data => {
-    // Use data.document.currentJson to resume
-  });
-```
-
-### View edit history
-
-```javascript
-// Get all edits for a document
-fetch('http://localhost:3002/api/history/your-file.pdf')
-  .then(res => res.json())
-  .then(data => {
-    // Browse through data.history
-  });
-```
-
-## Save Behavior
-
-**Q: Is it save-as-you-type or does a Save button show up?**
-
-**A: Save button** ✅
-
-- Green **Save** button appears when you make edits
-- Click to save (not auto-save)
-- Full control over when to persist changes
-- Button shown next to Download button
-
-## Production Features
-
-### ✅ Implemented
-
-- [x] Automatic document creation
-- [x] Version history tracking
-- [x] Scalable for any PDF/JSON
-- [x] RESTful API design
-- [x] SQLite storage with indexes
-- [x] Error handling and logging
-- [x] CORS enabled
-- [x] 50MB JSON limit
-- [x] Smart baseline management
-
-### 🔄 Recommended for Production
-
-- [ ] Add authentication (JWT/OAuth)
-- [ ] Add rate limiting
-- [ ] Migrate to PostgreSQL
-- [ ] Add monitoring/metrics
-- [ ] Add automated backups
-- [ ] Write comprehensive tests
-- [ ] Add input validation
-- [ ] Add user_id tracking
-
-## Files Structure
-
-```
-old-lib/
-├── server/
-│   ├── db.js              # SQLite database layer
-│   ├── server.js          # Express API server
-│   ├── edits.db           # SQLite database (auto-created)
-│   └── README.md          # Server documentation
-├── Structura.tsx          # Main component (onSave prop)
-├── HtmlViewer.tsx         # HTML viewer (Save button)
-├── test-app/
-│   └── src/
-│       └── App.tsx        # Test app (onSave implementation)
-└── PRODUCTION_ARCHITECTURE.md  # Detailed architecture docs
-```
-
-## Testing
-
-### Test with any document
-
-```bash
-# Open viewer with your PDF/JSON
-http://localhost:5175/?pdf=/your-doc.pdf&json=/your-data.json
-
-# Make edits, click Save
-# Document is automatically created
-
-# Check database
-sqlite3 server/edits.db "SELECT * FROM documents;"
-sqlite3 server/edits.db "SELECT * FROM edits;"
-```
-
-### Test API directly
-
-```bash
-# Health check
-curl http://localhost:3002/health
-
-# Save document
-curl -X POST http://localhost:3002/api/save \
-  -H "Content-Type: application/json" \
-  -d '{
-    "pdfName": "test.pdf",
-    "editedJson": {"test": "data"},
-    "originalJson": {"test": "data"},
-    "summary": "First save"
-  }'
-
-# Load document
-curl http://localhost:3002/api/load/test.pdf | python3 -m json.tool
-
-# Get history
-curl http://localhost:3002/api/history/test.pdf | python3 -m json.tool
-```
-
-## Database Location
-
-```
-/Users/__chaks__/learn/saral-next/old-lib/server/edits.db
-```
-
-Inspect with:
-```bash
-cd /Users/__chaks__/learn/saral-next/old-lib
-sqlite3 server/edits.db
-
-.tables
-.schema documents
-.schema edits
-SELECT * FROM documents;
-SELECT * FROM edits ORDER BY created_at DESC;
-```
-
-## Scalability
-
-### Handles Any Volume
-
-- ✅ Any number of PDFs
-- ✅ Any JSON size (up to 50MB)
-- ✅ Any number of edits per document
-- ✅ Automatic indexing for fast lookups
-- ✅ No pre-configuration needed
-
-### Performance Characteristics
-
-- Document lookup: O(log n) with index
-- Latest edit: O(log n) with index
-- Full history: O(m) where m = edits per document
-- Storage: Linear with number of edits
-
-### Recommended Limits
-
-- **Development**: SQLite handles 1000s of documents easily
-- **Production**: Migrate to PostgreSQL for 10,000+ documents
-- **JSON size**: Keep under 10MB for best performance
-- **Edits per document**: No practical limit
-
-## Monitoring
-
-### Server Logs
-
-```
-[Server] Structura edit server running on http://localhost:3002
-[Server] Created new document for doc.pdf with ID 1
-[Server] Saved edit 1 for document 1
-[Server] Found existing document for doc.pdf with ID 1
-[Server] Saved edit 2 for document 1
-```
-
-### Monitor Database Growth
-
-```bash
-# Database size
-ls -lh server/edits.db
-
-# Document count
-sqlite3 server/edits.db "SELECT COUNT(*) FROM documents;"
-
-# Edit count
-sqlite3 server/edits.db "SELECT COUNT(*) FROM edits;"
-
-# Edits per document
-sqlite3 server/edits.db "
-  SELECT pdf_name, COUNT(e.id) as edit_count
-  FROM documents d
-  LEFT JOIN edits e ON d.id = e.document_id
-  GROUP BY d.id
-  ORDER BY edit_count DESC;
-"
-```
-
-## Deployment
-
-### Development
-
-```bash
-npm run server              # Start server
-npm run server:dev          # With auto-restart (nodemon)
-```
-
-### Production (PM2)
-
-```bash
-npm install -g pm2
-
-# Start server
-pm2 start server/server.js --name structura-edit
-
-# Save process list
-pm2 save
-
-# Auto-start on reboot
-pm2 startup
-```
-
-### Docker
-
-```dockerfile
-FROM node:18
-WORKDIR /app
-COPY package*.json ./
-RUN npm install --production
-COPY . .
-EXPOSE 3002
-CMD ["node", "server/server.js"]
-```
-
-## Status: ✅ PRODUCTION-READY
-
-The save functionality is complete and designed for production use:
-
-- Zero configuration required
-- Scales to any PDF/JSON combination
-- Automatic document creation
-- Full version history
-- RESTful API design
-- Comprehensive error handling
-- Production-ready architecture
-
-Start using it immediately with any PDF and JSON file!

package/dist/cjs/ui/badge.js

@@ -1,34 +0,0 @@
-'use strict';
-
-var jsxRuntime = require('react/jsx-runtime');
-var classVarianceAuthority = require('class-variance-authority');
-var utils = require('../lib/utils.js');
-
-const badgeVariants = classVarianceAuthority.cva("inline-flex items-center rounded-full border px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2", {
-  variants: {
-    variant: {
-      default: "border-transparent bg-primary text-primary-foreground hover:bg-primary/80",
-      secondary: "border-transparent bg-secondary text-secondary-foreground hover:bg-secondary/80",
-      destructive: "border-transparent bg-destructive text-destructive-foreground hover:bg-destructive/80",
-      outline: "text-foreground"
-    }
-  },
-  defaultVariants: {
-    variant: "default"
-  }
-});
-function Badge({
-  className,
-  variant,
-  ...props
-}) {
-  return jsxRuntime.jsx("div", {
-    className: utils.cn(badgeVariants({
-      variant
-    }), className),
-    ...props
-  });
-}
-
-exports.Badge = Badge;
-exports.badgeVariants = badgeVariants;

package/dist/esm/types/helpers/jsonToHtml.d.ts

@@ -1,40 +0,0 @@
-/**
- * Convert Marker JSON block output to HTML by resolving content-ref tags.
- * This is the TypeScript equivalent of core/output.py's json_to_html function.
- *
- * Usage:
- * - For Gemini-corrected JSONs: The GeminiCorrected block has clean HTML, no refs to resolve
- * - For original JSONs: Resolves <content-ref src='...'> tags recursively
- */
-interface Block {
-    id: string;
-    html?: string;
-    children?: Block[];
-    block_type?: string;
-    [key: string]: any;
-}
-/**
- * Resolve content-ref tags in HTML by replacing them with actual child content
- */
-export declare function jsonToHtml(block: Block): string;
-/**
- * Check if a block has Gemini corrections
- */
-export declare function hasGeminiCorrections(block: Block): boolean;
-/**
- * Get the corrected HTML from a Gemini-corrected block, or fall back to rendering original
- */
-export declare function getBlockHtml(block: Block): string;
-/**
- * Render an entire page to HTML
- */
-export declare function renderPageToHtml(page: Block): string;
-/**
- * Render the entire document to HTML (all pages)
- */
-export declare function renderDocumentToHtml(document: Block): string;
-/**
- * Extract plain text from HTML (strips all tags)
- */
-export declare function htmlToPlainText(html: string): string;
-export {};

package/dist/esm/ui/badge.js

@@ -1,31 +0,0 @@
-import { objectWithoutProperties as _objectWithoutProperties, objectSpread2 as _objectSpread2 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { jsx } from 'react/jsx-runtime';
-import { cva } from 'class-variance-authority';
-import { cn } from '../lib/utils.js';
-
-var _excluded = ["className", "variant"];
-var badgeVariants = cva("inline-flex items-center rounded-full border px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2", {
-  variants: {
-    variant: {
-      default: "border-transparent bg-primary text-primary-foreground hover:bg-primary/80",
-      secondary: "border-transparent bg-secondary text-secondary-foreground hover:bg-secondary/80",
-      destructive: "border-transparent bg-destructive text-destructive-foreground hover:bg-destructive/80",
-      outline: "text-foreground"
-    }
-  },
-  defaultVariants: {
-    variant: "default"
-  }
-});
-function Badge(_ref) {
-  var className = _ref.className,
-    variant = _ref.variant,
-    props = _objectWithoutProperties(_ref, _excluded);
-  return jsx("div", _objectSpread2({
-    className: cn(badgeVariants({
-      variant: variant
-    }), className)
-  }, props));
-}
-
-export { Badge, badgeVariants };