neozipkit 0.2.1 → 0.3.0

package/src/browser/CertificateGeneratorBrowser.ts-remove

@@ -1,498 +0,0 @@
-// ======================================
-//	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);
-} 

package/src/browser/ZipKitStampBrowser.ts

@@ -1,9 +0,0 @@
-// A browser-safe version of ZipKitStamp
-
-export const createTimestamp = async (hash: string, options: any = {}): Promise<any> => {
-  throw new Error('Blockchain timestamp creation is not supported in browsers');
-};
-
-export const verifyTimestamp = async (timestamp: any, options: any = {}): Promise<any> => {
-  throw new Error('Blockchain timestamp verification is not supported in browsers');
-}; 

package/src/browser-index.ts

@@ -1,36 +0,0 @@
-// =============================================================================
-// NeoZipKit - Browser-Only Package Exports  
-// =============================================================================
-
-// Core shared exports
-import ZipKit from './shared/ZipKit';
-export { ZipEntry, Errors, CMP_METHOD, TIMESTAMP_METADATA, TIMESTAMP_SUBMITTED } from './shared/ZipKit';
-export type { CompressOptions } from './shared/ZipKit';
-export * from './shared/ZipKit';
-export * from './shared/ZipEntry';
-export default ZipKit;
-
-// Browser-only exports
-export { default as ZipKitBrowser } from './browser/ZipKitBrowser';
-// export { CertificateGeneratorBrowser } from './browser/CertificateGeneratorBrowser';
-// export { TokenVerificationResult, checkForTokenization as checkForTokenizationBrowser, NZipTokenInfo } from './browser/TokenVerifierBrowser';
-// export type { TokenVerificationOptions } from './browser/TokenVerifierBrowser';
-
-// Shared component exports
-export { default as HashAccumulator } from './shared/components/HashAccumulator';
-export * from './shared/components/Util';
-export * from './shared/components/Support';
-
-// Type and constant exports
-export * from './shared/types';
-export * from './shared/constants/Headers';
-export * from './shared/constants/Errors';
-export * from './shared/version';
-
-// Platform-specific conditional exports
-export const PlatformUtils = {
-  // Browser detection
-  isBrowser: typeof window !== 'undefined' && typeof document !== 'undefined',
-  // Node.js detection  
-  isNode: typeof process !== 'undefined' && process.versions && process.versions.node,
-};

package/src/server/README.md

@@ -1,25 +0,0 @@
-### Server APIs
-
-#### ZipKitServer
-- `loadZipFile(path)`
-  - Open or create a ZIP for writing; prepares entries for add/update operations.
-- `loadUnzipFile(path)`
-  - Open an existing ZIP for reading/extraction; throws on missing files.
-- `addFile(path, freshen?, update?)`
-  - Add a new entry or update an existing one (respects freshen/update flags).
-- `addFiles(paths[], freshen?, update?)`
-  - Batch add/update using `addFile` logic.
-- `createZip(path, options)`
-  - Write all staged entries to disk (no OpenTimestamps metadata).
-- `createZipOTS(path, options)`
-  - Write entries to disk and embed OpenTimestamps (OTS) metadata using the Merkle root.
-- `deleteFiles(paths[])`
-  - Delete entries by filename and rebuild central directory.
-- `upgradeOTS(zipPath, upgradedOts)`
-  - Replace OTS metadata in an existing archive with upgraded OTS bytes.
-
-Notes:
-- All read/write callbacks use Node Buffers. Ensure files exist on disk during `createZip*` flows.
-
-For OpenTimestamps utilities, see `src/blockchain/ZipKitOTS.ts`.
-