Skip to content

IOSetu Local: WASM Viewer Guide

IOSetu Local is a browser-based AL3 viewer that runs entirely in your browser using WebAssembly (WASM). No data leaves your machine - perfect for quick file inspection and privacy-sensitive workflows.

Quick Start

  1. Open the Viewer
    Navigate to: /iosetu/index.html (served from the documentation site)

  2. Load an AL3 File

  3. Click "Choose File" or drag-and-drop an AL3 file
  4. File is processed entirely in your browser

  5. No upload to any server

  6. View Results

  7. Hierarchical group structure
  8. Field-level data extraction
  9. Validation status and errors

Features

Zero Data Exfiltration

  • 100% Client-Side: All processing happens in your browser
  • No Network Requests: File never leaves your machine
  • Privacy First: Ideal for sensitive policy data

Instant Processing

  • No Server Required: Works offline after initial page load
  • Fast Parsing: WebAssembly performance
  • Real-Time Validation: Immediate feedback on file structure

Full AL3 Support

  • All Policy Types: Auto, Home, Commercial, Workers Comp, etc.
  • Hierarchical Display: Parent-child group relationships
  • Field Extraction: Formatted and raw values
  • Validation: Syntax and structure checks

Usage

Loading Files

Method 1: File Picker

1. Click "Choose File" button
2. Select .AL3 file from your computer
3. View results instantly

Method 2: Drag & Drop

1. Drag AL3 file from file explorer
2. Drop onto viewer window
3. Processing starts automatically

Viewing Output

Group Hierarchy: - Expandable tree structure - Parent-child relationships visualized - Group codes and descriptions

Field Data: - Formatted values (human-readable) - Raw values (original AL3 format) - Data type indicators

Validation Results: - ✅ Valid file indicator - ⚠️ Warnings (non-critical issues) - ❌ Errors (structural problems)

Use Cases

Quick File Inspection

Perfect for: - Verifying file structure before processing - Checking specific field values - Debugging AL3 generation issues

Privacy-Sensitive Data

Ideal when: - Working with PII or sensitive policy data - Company policy prohibits cloud uploads - Offline/air-gapped environments

Development & Testing

Useful for: - Testing AL3 file generation - Comparing output formats - Learning AL3 structure

Comparison: IOSetu Local vs IOSetu Cloud

Feature IOSetu Local (WASM) IOSetu Cloud (AWS)
Processing Browser (WASM) AWS Container
Data Location Never leaves browser Stays in your VPC
Network None required API calls
Scale Single files Batch processing
Output Formats JSON only JSON, Parquet, CSV, NDJSON
Integration Manual inspection API/Pipeline integration
Cost Free Pay-per-use (vCPU hours)
Best For Quick inspection, privacy Production pipelines, analytics

Technical Details

Browser Requirements

  • Modern Browser: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
  • WebAssembly Support: Required (enabled by default)
  • JavaScript: Must be enabled
  • File Size Limit: 10MB (browser memory constraint)

Performance

  • Typical Parse Time: <100ms for most files
  • Memory Usage: ~2-3x file size
  • Concurrent Files: One at a time

Security

  • No Server Communication: All processing is local
  • No Data Storage: Files not saved or cached
  • No Analytics: No tracking or telemetry
  • Open Source: WASM binary is auditable

Limitations

File Size

  • Maximum: 10MB per file
  • Recommendation: Use IOSetu Cloud for larger files
  • Reason: Browser memory constraints

Output Formats

  • Supported: JSON only
  • Not Available: Parquet, CSV, NDJSON
  • Workaround: Use IOSetu Cloud API for other formats

Batch Processing

  • Single File: One file at a time
  • No Automation: Manual file selection
  • Alternative: Use IOSetu Cloud for batch workflows

Troubleshooting

File Won't Load

Issue: File picker doesn't respond

Solutions: - Refresh the page - Check file extension is .AL3 or .al3 - Verify file size is under 10MB - Try a different browser

Parse Errors

Issue: "Invalid AL3 format" error

Solutions: - Verify file is valid AL3 (not XML or other format) - Check file isn't corrupted - Validate with IOSetu Cloud API for detailed errors

Slow Performance

Issue: Parsing takes >5 seconds

Solutions: - Close other browser tabs (free up memory) - Use a modern browser version - For large files, use IOSetu Cloud instead

Next Steps

For Production Use

If you need: - Batch Processing: See IOSetu Cloud Guide - API Integration: See API Guide - Multiple Formats: Use IOSetu Cloud (Parquet, CSV, NDJSON)

For Development

FAQ

Q: Is my data uploaded anywhere?
A: No. All processing happens in your browser. No network requests are made.

Q: Can I use this offline?
A: Yes, after the initial page load. The WASM binary is cached.

Q: What's the file size limit?
A: 10MB due to browser memory constraints. Use IOSetu Cloud for larger files.

Q: Can I export to Parquet/CSV?
A: No, WASM viewer only outputs JSON. Use IOSetu Cloud API for other formats.

Q: Is this the same parser as IOSetu Cloud?
A: Yes, identical core parsing logic compiled to WebAssembly.

Q: Can I integrate this into my app?
A: Yes, the WASM binary can be embedded. Contact us for licensing.

Privacy: 100% client-side processing
Performance: <100ms typical parse time
Compatibility: All modern browsers