neozipkit 0.1.1

package/package.json

@@ -0,0 +1,117 @@
+{
+  "name": "neozipkit",
+  "version": "0.1.1",
+  "description": "NeoZipKit - Advanced ZIP file creation and verification with blockchain timestamping",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "browser": {
+        "types": "./dist/browser.d.ts",
+        "default": "./dist/browser.js"
+      },
+      "node": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/browser.js"
+    },
+    "./browser/*": {
+      "types": "./dist/browser/*.d.ts",
+      "default": "./dist/browser/*.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "default": "./dist/server/index.js"
+    },
+    "./server/*": {
+      "types": "./dist/server/*.d.ts",
+      "default": "./dist/server/*.js"
+    },
+    "./server/blockchain/*": {
+      "types": "./dist/server/blockchain/*.d.ts",
+      "default": "./dist/server/blockchain/*.js"
+    },
+    "./server/platform/*": {
+      "types": "./dist/server/platform/*.d.ts",
+      "default": "./dist/server/platform/*.js"
+    },
+    "./shared": {
+      "types": "./dist/shared/index.d.ts",
+      "default": "./dist/shared/index.js"
+    },
+    "./shared/*": {
+      "types": "./dist/shared/*.d.ts",
+      "default": "./dist/shared/*.js"
+    },
+    "./shared/components/*": {
+      "types": "./dist/shared/components/*.d.ts",
+      "default": "./dist/shared/components/*.js"
+    },
+    "./shared/constants/*": {
+      "types": "./dist/shared/constants/*.d.ts",
+      "default": "./dist/shared/constants/*.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "src/",
+    "contracts/",
+    "examples/",
+    "README.md",
+    "PACKAGE_STRUCTURE.md",
+    "BLOCKCHAIN_INTEGRATION.md",
+    "TYPESCRIPT_WORKFLOW.md"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist/ && rm -rf *.js *.d.ts components constants platform types blockchain",
+    "compile": "tsc",
+    "create-browser-entry": "cp dist/browser-index.js dist/browser.js && cp dist/browser-index.d.ts dist/browser.d.ts",
+    "build": "npm run clean && npm run compile && npm run create-browser-entry",
+    "watch": "tsc --watch",
+    "test": "echo \"No tests specified\" && exit 0"
+  },
+  "keywords": [
+    "zip",
+    "archive",
+    "blockchain",
+    "timestamp",
+    "verification",
+    "nft",
+    "crypto",
+    "compression"
+  ],
+  "author": "NeoWare, Inc.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NeoWareInc/neozipkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/NeoWareInc/neozipkit/issues"
+  },
+  "homepage": "https://github.com/NeoWareInc/neozipkit#readme",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/pako": "^2.0.3",
+    "@types/uuid": "^9.0.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "@oneidentity/zstd-js": "^1.0.3",
+    "ethers": "^6.0.0",
+    "opentimestamps": "^0.4.9",
+    "pako": "^2.1.0",
+    "uuid": "^9.0.0",
+    "web3": "^4.0.0"
+  },
+  "peerDependencies": {
+    "ethers": "^6.0.0",
+    "web3": "^4.0.0"
+  }
+}

package/src/browser/CertificateGeneratorBrowser.ts

@@ -0,0 +1,498 @@
+// ======================================
+//	CertificateGeneratorBrowser.ts
+//  Browser-compatible certificate generator for tokenized ZIP files
+//  Copyright (c) 2025 NeoWare, Inc. All rights reserved.
+// ======================================
+
+import { ZipEntry } from '../shared/ZipKit';
+import { NZipTokenInfo, BlockchainVerification } from './TokenVerifierBrowser';
+import { TOKENIZED_METADATA } from '../shared/constants/Headers';
+
+// Token-specific types
+export interface TokenInfo {
+  tokenId: string;
+  contractAddress: string;
+  network: string;
+  transactionHash: string;
+  wallet?: string;
+  timestamp?: number;
+  note?: string;
+}
+
+export interface WalletInfo {
+  address: string;
+  network: string;
+  balance?: string;
+  ensName?: string;
+}
+
+export interface ZipFileInfo {
+  filename: string;
+  size: number;
+  date: string;
+  hash: string;
+}
+
+/**
+ * Browser-compatible certificate generator class
+ */
+export class CertificateGeneratorBrowser {
+  /**
+   * Generates a certificate HTML document for tokenized ZIP files
+   */
+  createTokenCertificate(
+    tokenInfo: TokenInfo,
+    zipFile: string,
+    blockchainVerification: BlockchainVerification,
+    walletInfo?: WalletInfo,
+    zipFiles?: ZipFileInfo[],
+    options?: { narrow?: boolean; includeQR?: boolean }
+  ): string {
+    
+    // Generate token information HTML
+    const tokenHTML = this.generateTokenSection(tokenInfo);
+    
+    // Generate blockchain verification HTML
+    const verificationHTML = this.generateVerificationSection(blockchainVerification);
+    
+    // Generate wallet information HTML
+    const walletHTML = walletInfo ? this.generateWalletSection(walletInfo) : '';
+    
+    // Generate files table HTML
+    const filesTableHTML = zipFiles ? this.generateFilesTable(zipFiles) : '';
+    
+    // Get the complete HTML template
+    const htmlTemplate = this.getCertificateTemplate();
+    
+    // Create the complete attestation HTML combining all sections
+    const attestHTML = tokenHTML + verificationHTML + walletHTML;
+    
+    // Replace placeholders in the template
+    const html = htmlTemplate
+      .replace(/{{ATTEST_STR}}/g, `NFT Token Certificate for ${zipFile}`)
+      .replace(/{{UPDATE_WARNING}}/g, blockchainVerification.verificationStatus === 'FAILED' ? 
+        '<div class="warning">⚠️ Warning: Blockchain verification failed. This archive may have been tampered with.</div>' : '')
+      .replace(/{{ZIP_FILE}}/g, zipFile)
+      .replace(/{{HASH_DIGEST}}/g, blockchainVerification.calculatedMerkleRoot)
+      .replace(/{{ATTESTATION_HTML}}/g, attestHTML)
+      .replace(/{{FILES_TABLE_HTML}}/g, filesTableHTML)
+      .replace(/{{GENERATION_TIME}}/g, new Date().toUTCString());
+
+    return html;
+  }
+
+  /**
+   * Saves a certificate as a downloadable file (browser-compatible)
+   */
+  saveCertificate(
+    fileName: string,
+    certificateHTML: string
+  ): void {
+    const baseName = fileName.replace(/\.zip$/i, '');
+    const certFileName = `${baseName}.token-certificate.html`;
+    
+    // Create a blob with the HTML content
+    const blob = new Blob([certificateHTML], { type: 'text/html' });
+    
+    // Create a download link
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement('a');
+    link.href = url;
+    link.download = certFileName;
+    
+    // Trigger download
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+    
+    // Clean up the URL object
+    URL.revokeObjectURL(url);
+  }
+
+  /**
+   * Generate token information section
+   */
+  private generateTokenSection(tokenInfo: TokenInfo): string {
+    return `
+      <div class="token-section">
+        <h3>🎫 NFT Token Information</h3>
+        <div class="key-value-pair">
+          <div class="key">Token ID:</div>
+          <div class="value"><code>${tokenInfo.tokenId}</code></div>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Network:</div>
+          <div class="value">${tokenInfo.network}</div>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Contract Address:</div>
+          <div class="value"><code>${tokenInfo.contractAddress}</code></div>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Transaction Hash:</div>
+          <div class="value"><code>${tokenInfo.transactionHash}</code></div>
+        </div>
+        ${tokenInfo.wallet ? `
+        <div class="key-value-pair">
+          <div class="key">Wallet:</div>
+          <div class="value"><code>${tokenInfo.wallet}</code></div>
+        </div>
+        ` : ''}
+        ${tokenInfo.timestamp ? `
+        <div class="key-value-pair">
+          <div class="key">Minted At:</div>
+          <div class="value">${new Date(tokenInfo.timestamp * 1000).toUTCString()}</div>
+        </div>
+        ` : ''}
+        ${tokenInfo.note ? `
+        <div class="key-value-pair">
+          <div class="key">Note:</div>
+          <div class="value">${tokenInfo.note}</div>
+        </div>
+        ` : ''}
+      </div>
+    `;
+  }
+
+  /**
+   * Generate blockchain verification section
+   */
+  private generateVerificationSection(verification: BlockchainVerification): string {
+    const statusIcon = verification.verificationStatus === 'PASSED' ? '✅' : 
+                       verification.verificationStatus === 'FAILED' ? '❌' : '⚠️';
+    
+    return `
+      <div class="verification-section ${verification.verificationStatus.toLowerCase()}">
+        <h3>🔐 Blockchain Verification</h3>
+        <div class="verification-status ${verification.verificationStatus.toLowerCase()}">
+          ${statusIcon} <strong>Status: ${verification.verificationStatus}</strong>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Blockchain Merkle Root:</div>
+          <div class="value"><code>${verification.blockchainMerkleRoot}</code></div>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Calculated Merkle Root:</div>
+          <div class="value"><code>${verification.calculatedMerkleRoot}</code></div>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Integrity Check:</div>
+          <div class="value">${verification.merkleRootMatches ? 
+            '✅ Archive contents match blockchain record' : 
+            '❌ Archive contents do not match blockchain record'}</div>
+        </div>
+        ${verification.verificationTime ? `
+        <div class="key-value-pair">
+          <div class="key">Verified At:</div>
+          <div class="value">${new Date(verification.verificationTime * 1000).toUTCString()}</div>
+        </div>
+        ` : ''}
+        ${verification.blockNumber ? `
+        <div class="key-value-pair">
+          <div class="key">Block Number:</div>
+          <div class="value">${verification.blockNumber}</div>
+        </div>
+        ` : ''}
+      </div>
+    `;
+  }
+
+  /**
+   * Generate wallet information section
+   */
+  private generateWalletSection(walletInfo: WalletInfo): string {
+    return `
+      <div class="wallet-section">
+        <h3>👛 Wallet Information</h3>
+        <div class="key-value-pair">
+          <div class="key">Address:</div>
+          <div class="value"><code>${walletInfo.address}</code></div>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Network:</div>
+          <div class="value">${walletInfo.network}</div>
+        </div>
+        ${walletInfo.balance ? `
+        <div class="key-value-pair">
+          <div class="key">Balance:</div>
+          <div class="value">${walletInfo.balance}</div>
+        </div>
+        ` : ''}
+        ${walletInfo.ensName ? `
+        <div class="key-value-pair">
+          <div class="key">ENS Name:</div>
+          <div class="value">${walletInfo.ensName}</div>
+        </div>
+        ` : ''}
+      </div>
+    `;
+  }
+
+  /**
+   * Generate files table
+   */
+  private generateFilesTable(zipFiles: ZipFileInfo[]): string {
+    if (zipFiles.length === 0) {
+      return '<tr><td colspan="4">No files found</td></tr>';
+    }
+
+    return zipFiles.map(file => `
+      <tr>
+        <td class="table-data1">${file.filename}</td>
+        <td>${file.size.toLocaleString()}</td>
+        <td>${file.date}</td>
+        <td><code>${file.hash}</code></td>
+      </tr>
+    `).join('');
+  }
+
+  /**
+   * Get the HTML template for certificates
+   */
+  private getCertificateTemplate(): string {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>NFT Token Certificate - {{ZIP_FILE}}</title>
+    <style>
+        body {
+            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+            line-height: 1.6;
+            margin: 0;
+            padding: 20px;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            min-height: 100vh;
+        }
+        .certificate {
+            max-width: 900px;
+            margin: 0 auto;
+            background: white;
+            border-radius: 15px;
+            box-shadow: 0 20px 40px rgba(0,0,0,0.1);
+            overflow: hidden;
+        }
+        .header {
+            background: linear-gradient(135deg, #2c3e50 0%, #3498db 100%);
+            color: white;
+            padding: 30px;
+            text-align: center;
+        }
+        .header h1 {
+            margin: 0;
+            font-size: 2.5em;
+            font-weight: 300;
+        }
+        .header h2 {
+            margin: 10px 0 0 0;
+            font-size: 1.2em;
+            opacity: 0.9;
+        }
+        .content {
+            padding: 40px;
+        }
+        .token-section, .verification-section, .wallet-section {
+            margin-bottom: 30px;
+            padding: 20px;
+            border-radius: 10px;
+            border-left: 4px solid #3498db;
+            background: #f8f9fa;
+        }
+        .verification-section.passed {
+            border-left-color: #27ae60;
+        }
+        .verification-section.failed {
+            border-left-color: #e74c3c;
+        }
+        .verification-section.unavailable {
+            border-left-color: #f39c12;
+        }
+        .verification-status {
+            font-size: 1.2em;
+            margin-bottom: 15px;
+            padding: 10px;
+            border-radius: 5px;
+        }
+        .verification-status.passed {
+            background: #d4edda;
+            color: #155724;
+        }
+        .verification-status.failed {
+            background: #f8d7da;
+            color: #721c24;
+        }
+        .verification-status.unavailable {
+            background: #fff3cd;
+            color: #856404;
+        }
+        .key-value-pair {
+            display: flex;
+            margin-bottom: 10px;
+            align-items: flex-start;
+        }
+        .key {
+            font-weight: bold;
+            min-width: 200px;
+            color: #2c3e50;
+        }
+        .value {
+            flex: 1;
+            word-break: break-all;
+        }
+        .value code {
+            background: #e9ecef;
+            padding: 2px 6px;
+            border-radius: 3px;
+            font-family: 'Monaco', 'Menlo', monospace;
+            font-size: 0.9em;
+        }
+        .files-section {
+            margin-top: 30px;
+        }
+        .files-table {
+            width: 100%;
+            border-collapse: collapse;
+            margin-top: 15px;
+        }
+        .files-table th,
+        .files-table td {
+            padding: 12px;
+            text-align: left;
+            border-bottom: 1px solid #dee2e6;
+        }
+        .files-table th {
+            background: #f8f9fa;
+            font-weight: bold;
+            color: #2c3e50;
+        }
+        .table-data1 {
+            font-weight: bold;
+        }
+        .warning {
+            background: #fff3cd;
+            color: #856404;
+            padding: 15px;
+            border-radius: 5px;
+            margin-bottom: 20px;
+            border-left: 4px solid #ffc107;
+        }
+        .footer {
+            text-align: center;
+            padding: 20px;
+            background: #f8f9fa;
+            color: #6c757d;
+            font-size: 0.9em;
+        }
+        h3 {
+            margin-top: 0;
+            color: #2c3e50;
+            font-size: 1.3em;
+        }
+    </style>
+</head>
+<body>
+    <div class="certificate">
+        <div class="header">
+            <h1>🎫 NFT Token Certificate</h1>
+            <h2>Blockchain-Verified Digital Archive</h2>
+        </div>
+        
+        <div class="content">
+            {{UPDATE_WARNING}}
+            
+            <div class="key-value-pair" style="margin-bottom: 30px; font-size: 1.1em;">
+                <div class="key">Archive File:</div>
+                <div class="value"><strong>{{ZIP_FILE}}</strong></div>
+            </div>
+            
+            {{ATTESTATION_HTML}}
+            
+            <div class="files-section">
+                <h3>📁 Archive Contents</h3>
+                <table class="files-table">
+                    <thead>
+                        <tr>
+                            <th>File Name</th>
+                            <th>Size (bytes)</th>
+                            <th>Date Modified</th>
+                            <th>SHA256 Hash</th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        {{FILES_TABLE_HTML}}
+                    </tbody>
+                </table>
+            </div>
+        </div>
+        
+        <div class="footer">
+            <p>This certificate verifies the integrity and authenticity of the tokenized archive through blockchain technology.</p>
+            <p>Generated on: {{GENERATION_TIME}}</p>
+        </div>
+    </div>
+</body>
+</html>`;
+  }
+
+  /**
+   * Prepares file information from ZIP entries for certificate generation
+   */
+  prepareZipFileInfo(zipEntries: ZipEntry[]): ZipFileInfo[] {
+    const zipFiles: ZipFileInfo[] = [];
+    
+    for (const entry of zipEntries) {
+      // Skip the token file itself and directories
+      if (entry.filename !== TOKENIZED_METADATA && 
+          !entry.isDirectory && 
+          entry.sha256) {
+        zipFiles.push({
+          filename: entry.filename,
+          size: entry.uncompressedSize,
+          date: this.formatEntryDate(entry),
+          hash: entry.sha256
+        });
+      }
+    }
+    
+    return zipFiles;
+  }
+
+  /**
+   * Formats the date from a ZIP entry
+   */
+  private formatEntryDate(entry: ZipEntry): string {
+    try {
+      // Try to use the entry's date formatting if available
+      if (typeof (entry as any).toFormattedUTCDateString === 'function') {
+        return (entry as any).toFormattedUTCDateString();
+      }
+      
+      // Fallback to current date
+      return new Date().toUTCString();
+    } catch (error) {
+      return new Date().toUTCString();
+    }
+  }
+}
+
+/**
+ * Creates a new CertificateGeneratorBrowser instance
+ */
+export function createCertificateGenerator(): CertificateGeneratorBrowser {
+  return new CertificateGeneratorBrowser();
+}
+
+/**
+ * Convenience function to generate a certificate
+ */
+export function generateTokenCertificate(
+  tokenInfo: TokenInfo,
+  zipFile: string,
+  blockchainVerification: BlockchainVerification,
+  walletInfo?: WalletInfo,
+  zipFiles?: ZipFileInfo[]
+): string {
+  const generator = new CertificateGeneratorBrowser();
+  return generator.createTokenCertificate(tokenInfo, zipFile, blockchainVerification, walletInfo, zipFiles);
+}