@aurabx/jmix-js 0.1.0

package/dist/crypto/PayloadEncryptor.d.ts

@@ -0,0 +1,21 @@
+export interface EncryptResult {
+    ephemeral_public_key: string;
+    iv: string;
+    auth_tag: string;
+}
+export declare class PayloadEncryptor {
+    /**
+     * Create a tar archive (in-memory) from a directory.
+     * Paths inside the tar are relative to baseDir.
+     */
+    static tarDirectory(baseDir: string): Promise<Buffer>;
+    /**
+     * Encrypt payload tar with AES-256-GCM using ECDH (X25519) derived key via HKDF-SHA256.
+     * recipientPublicKeyBase64 is a 32-byte Curve25519 public key, base64 encoded.
+     */
+    static encryptTar(tarData: Buffer, recipientPublicKeyBase64: string): {
+        ciphertext: Buffer;
+        result: EncryptResult;
+    };
+}
+//# sourceMappingURL=PayloadEncryptor.d.ts.map

package/dist/crypto/PayloadEncryptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayloadEncryptor.d.ts","sourceRoot":"","sources":["../../src/crypto/PayloadEncryptor.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAC3B;;;OAGG;WACU,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmC3D;;;OAGG;IACH,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,MAAM,EACf,wBAAwB,EAAE,MAAM,GAC/B;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE;CAoCjD"}

package/dist/crypto/PayloadEncryptor.js

@@ -0,0 +1,79 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { randomBytes, createCipheriv, hkdfSync } from 'crypto';
+import nacl from 'tweetnacl';
+import tar from 'tar-stream';
+import { buffer as consumeBuffer } from 'node:stream/consumers';
+export class PayloadEncryptor {
+    /**
+     * Create a tar archive (in-memory) from a directory.
+     * Paths inside the tar are relative to baseDir.
+     */
+    static async tarDirectory(baseDir) {
+        const pack = tar.pack();
+        async function addDir(dir, relPrefix = '') {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const abs = path.join(dir, entry.name);
+                const rel = path.posix.join(relPrefix, entry.name);
+                if (entry.isDirectory()) {
+                    await addDir(abs, rel);
+                }
+                else if (entry.isFile()) {
+                    const stat = await fs.stat(abs);
+                    const content = await fs.readFile(abs);
+                    await new Promise((resolve, reject) => {
+                        const header = {
+                            name: rel,
+                            size: stat.size,
+                            mode: stat.mode,
+                            mtime: stat.mtime,
+                            type: 'file',
+                        };
+                        pack.entry(header, content, (err) => (err ? reject(err) : resolve()));
+                    });
+                }
+            }
+        }
+        await addDir(baseDir);
+        pack.finalize();
+        // Collect to Buffer using Node's consumers
+        const outBuf = await consumeBuffer(pack);
+        return Buffer.from(outBuf);
+    }
+    /**
+     * Encrypt payload tar with AES-256-GCM using ECDH (X25519) derived key via HKDF-SHA256.
+     * recipientPublicKeyBase64 is a 32-byte Curve25519 public key, base64 encoded.
+     */
+    static encryptTar(tarData, recipientPublicKeyBase64) {
+        const recipientPub = Buffer.from(recipientPublicKeyBase64, 'base64');
+        if (recipientPub.length !== 32) {
+            throw new Error('Invalid recipient public key length: expected 32 bytes base64');
+        }
+        // Ephemeral keypair
+        const eph = nacl.box.keyPair();
+        // X25519 shared secret
+        const shared = nacl.scalarMult(eph.secretKey, new Uint8Array(recipientPub));
+        // Derive 32-byte AES key with HKDF-SHA256
+        const salt = Buffer.alloc(0); // empty salt
+        const info = Buffer.from('JMIX-Payload-Encryption');
+        const hkdfOut = hkdfSync('sha256', Buffer.from(shared), salt, info, 32);
+        const key = Buffer.from(hkdfOut);
+        // Encrypt with AES-256-GCM
+        const iv = randomBytes(12);
+        const cipher = createCipheriv('aes-256-gcm', key, iv);
+        const enc1 = cipher.update(tarData);
+        const enc2 = cipher.final();
+        const auth = cipher.getAuthTag();
+        const ciphertext = Buffer.concat([enc1, enc2]);
+        return {
+            ciphertext,
+            result: {
+                ephemeral_public_key: Buffer.from(eph.publicKey).toString('base64'),
+                iv: iv.toString('base64'),
+                auth_tag: auth.toString('base64'),
+            },
+        };
+    }
+}
+//# sourceMappingURL=PayloadEncryptor.js.map

package/dist/crypto/PayloadEncryptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayloadEncryptor.js","sourceRoot":"","sources":["../../src/crypto/PayloadEncryptor.ts"],"names":[],"mappings":"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"}

package/dist/demo-decrypt-existing.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+// Decrypt an existing ENCRYPTED JMIX envelope directory.
+// Usage:
+//   node demo-decrypt-existing.js <envelopeDir> <recipientPrivateKeyBase64>
+
+import { JmixBuilder } from './index.js';
+
+async function main() {
+  const envelopeDir = process.argv[2];
+  const privKeyB64 = process.argv[3];
+
+  if (!envelopeDir || !privKeyB64) {
+    console.error('Usage: node demo-decrypt-existing.js <envelopeDir> <recipientPrivateKeyBase64>');
+    process.exit(2);
+  }
+
+  const builder = new JmixBuilder();
+  console.log('🔓 Decrypting envelope:', envelopeDir);
+  const payloadPath = await builder.decryptEnvelope(envelopeDir, privKeyB64);
+  console.log('✅ Decrypted payload at:', payloadPath);
+}
+
+main().catch(err => {
+  console.error('❌ Decryption failed:', err?.message || String(err));
+  process.exit(1);
+});

package/dist/demo-decrypt.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+// Demo: Encrypt and then decrypt a JMIX envelope using a fresh X25519 keypair.
+// Usage (self-contained):
+//   node demo-decrypt.js [dicomPath] [outputRoot]
+
+import { JmixBuilder } from './index.js';
+import nacl from 'tweetnacl';
+import * as fs from 'fs/promises';
+
+async function main() {
+  const dicomPath = process.argv[2] || './samples/study_1';
+  const outputRoot = process.argv[3] || './tmp';
+
+  const builder = new JmixBuilder();
+  const config = await JmixBuilder.loadConfig('./samples/sample_config.json');
+
+  // Generate a recipient keypair
+  const kp = nacl.box.keyPair();
+  const pubB64 = Buffer.from(kp.publicKey).toString('base64');
+  const privB64 = Buffer.from(kp.secretKey).toString('base64');
+
+  console.log('🔒 Building encrypted envelope...');
+  const encryptedDir = await builder.packageEncryptedToDirectory(dicomPath, config, outputRoot, pubB64);
+  console.log('Encrypted package:', encryptedDir);
+
+  console.log('🔓 Decrypting envelope...');
+  const payloadPath = await builder.decryptEnvelope(encryptedDir, privB64);
+  console.log('Decrypted payload path:', payloadPath);
+
+  // Show a couple of files
+  const files = await fs.readdir(payloadPath);
+  console.log('Payload entries:', files);
+}
+
+main().catch(err => {
+  console.error('❌ Demo failed:', err?.message || String(err));
+  process.exit(1);
+});

package/dist/demo-no-validation.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+
+// Demo script to test the JMIX TypeScript library without schema validation
+import { JmixBuilder } from './index.js';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+
+async function demo() {
+  console.log('🚀 JMIX TypeScript Library Demo (No Validation)');
+  console.log('=================================================\n');
+
+  try {
+    // Create a JmixBuilder instance with schema validation disabled
+    const builder = new JmixBuilder({
+      outputPath: './tmp/demo',
+      schemaValidatorOptions: {
+        schemaPath: './non-existent-schemas', // Force schemas to not be found
+        strictMode: false
+      }
+    });
+
+    console.log('✅ JmixBuilder created (validation disabled)');
+
+    // Create a sample configuration
+    const config = await JmixBuilder.loadConfig('./samples/sample_config.json');
+    console.log('✅ Sample configuration created');
+    console.log('   Patient:', config.patient.name);
+    console.log('   Sender:', config.sender.name);
+    console.log('   Security:', config.security.classification);
+
+    // Create a test DICOM directory (empty for demo)
+    const testDicomPath = './samples/study_1';
+    await fs.mkdir(testDicomPath, { recursive: true });
+    console.log('✅ Using sample DICOM directory');
+
+    // Build a JMIX envelope
+    console.log('\n📦 Building JMIX envelope...');
+    const envelope = await builder.buildFromDicom(testDicomPath, config);
+    
+    console.log('✅ JMIX envelope built successfully!');
+    console.log('   Envelope ID:', envelope.manifest.envelope_id);
+    console.log('   Audit events:', Array.isArray(envelope.audit?.audit) ? envelope.audit.audit.length : 0);
+    console.log('   Patient:', envelope.metadata.patient.name);
+    console.log('   DICOM instances:', envelope.metadata.dicom.instance_count);
+
+    // Save to files
+    console.log('\n💾 Saving envelope to files...');
+    await builder.saveToFiles(envelope);
+    
+    console.log('✅ Files saved to ./tmp/demo/');
+
+    // List the saved files
+    const savedFiles = await fs.readdir('./tmp/demo');
+    console.log('   Files created:');
+    for (const file of savedFiles.filter(f => f.endsWith('.json'))) {
+      const filePath = path.join('./tmp/demo', file);
+      const stats = await fs.stat(filePath);
+      console.log(`   - ${file} (${Math.round(stats.size / 1024 * 10) / 10} KB)`);
+    }
+
+    // Show a snippet of the manifest
+    console.log('\n📄 Sample manifest content:');
+    const manifestPath = path.join('./tmp/demo', 'manifest.json');
+    const manifestContent = await fs.readFile(manifestPath, 'utf-8');
+    const manifest = JSON.parse(manifestContent);
+    console.log(`   JMIX Version: ${manifest.jmix_version}`);
+    console.log(`   Created: ${manifest.created_at}`);
+    console.log(`   Sender: ${manifest.sender.name}`);
+    console.log(`   Patient: ${manifest.patient.name} (ID: ${manifest.patient.id})`);
+
+    console.log('\n🎉 Demo completed successfully!');
+    console.log('\n📝 This demonstrates:');
+    console.log('  ✓ TypeScript JMIX library setup');
+    console.log('  ✓ ESM module imports');
+    console.log('  ✓ DICOM directory processing (empty folder fallback)');
+    console.log('  ✓ JMIX envelope generation');
+    console.log('  ✓ File output to ./tmp directory (as per user rules)');
+    console.log('  ✓ Schema validation gracefully skipped when schemas not found');
+    
+    console.log('\n🔍 To explore the generated files:');
+    console.log('  cat ./tmp/demo/manifest.json | jq .');
+    console.log('  cat ./tmp/demo/metadata.json | jq .');
+    console.log('  cat ./tmp/demo/audit.json | jq .');
+
+  } catch (error) {
+    console.error('❌ Demo failed:', error.message);
+    if (error.cause) {
+      console.error('   Cause:', error.cause.message);
+    }
+    process.exit(1);
+  }
+}
+
+// Run the demo
+demo();

package/dist/demo-package-encrypted.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+// Demo that builds an ENCRYPTED JMIX package.
+// Usage:
+//   node demo-package-encrypted.js <recipientPublicKeyBase64> [dicomPath] [outputRoot]
+//
+// recipientPublicKeyBase64 is a Curve25519 (X25519) public key, 32 bytes base64.
+
+import { JmixBuilder } from './index.js';
+
+async function main() {
+  try {
+    const recipientKey = process.argv[2];
+    if (!recipientKey) {
+      console.error('Usage: node demo-package-encrypted.js <recipientPublicKeyBase64> [dicomPath] [outputRoot]');
+      process.exit(2);
+    }
+    const dicomPath = process.argv[3] || './samples/study_1';
+    const outputRoot = process.argv[4] || './tmp';
+
+    const config = await JmixBuilder.loadConfig('./samples/sample_config.json');
+
+    const builder = new JmixBuilder({ outputPath: './tmp' });
+    console.log('🔒 Packaging ENCRYPTED JMIX folder...');
+    const out = await builder.packageEncryptedToDirectory(dicomPath, config, outputRoot, recipientKey);
+    console.log('✅ Encrypted package at:', out);
+    console.log('Contains: manifest.json, audit.json, payload.encrypted');
+  } catch (err) {
+    console.error('❌ Encrypted packaging failed:', err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+}
+
+main();

package/dist/demo-package.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+
+// Demo that packages a JMIX folder including original DICOM files
+import { JmixBuilder } from './index.js';
+
+async function main() {
+  try {
+    const dicomPath = process.argv[2] || './samples/study_1';
+    const outputRoot = process.argv[3] || './tmp';
+
+    const config = await JmixBuilder.loadConfig('./samples/sample_config.json');
+
+    const builder = new JmixBuilder({ outputPath: './tmp' });
+    console.log('📦 Packaging JMIX folder...');
+    const out = await builder.packageToDirectory(dicomPath, config, outputRoot);
+    console.log('✅ Package created at:', out);
+    console.log('Structure:');
+    console.log('  - manifest.json');
+    console.log('  - audit.json');
+    console.log('  - payload/metadata.json');
+    console.log('  - payload/dicom/... (original files)');
+  } catch (err) {
+    console.error('❌ Packaging failed:', err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+}
+
+main();

package/dist/demo-verify-hash.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+
+// Verify payload hash for a JMIX envelope.
+// Usage:
+//   node demo-verify-hash.js <envelopeDir> [recipientPrivateKeyBase64]
+// - If payload/ exists, no key is required.
+// - If only payload.encrypted exists, pass the Curve25519 private key.
+
+import { JmixBuilder } from './index.js';
+
+async function main() {
+  const envelopeDir = process.argv[2];
+  const privKey = process.argv[3];
+
+  if (!envelopeDir) {
+    console.error('Usage: node demo-verify-hash.js <envelopeDir> [recipientPrivateKeyBase64]');
+    process.exit(2);
+  }
+
+  const b = new JmixBuilder();
+  const result = await b.verifyPayloadHash(envelopeDir, { recipientPrivateKeyBase64: privKey });
+  console.log('Mode:', result.mode);
+  console.log('Expected:', result.expected);
+  console.log('Computed:', result.computed);
+  console.log('OK:', result.ok);
+
+  process.exit(result.ok ? 0 : 1);
+}
+
+main().catch(err => { console.error('❌ Verification failed:', err?.message || String(err)); process.exit(1); });

package/dist/demo.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+// Demo script to test the JMIX TypeScript library
+import { JmixBuilder } from './index.js';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+
+async function demo() {
+  console.log('🚀 JMIX TypeScript Library Demo');
+  console.log('================================\n');
+
+  try {
+    // Create a JmixBuilder instance
+    const builder = new JmixBuilder({
+      outputPath: './tmp/demo'
+    });
+
+    console.log('✅ JmixBuilder created');
+
+    // Create a sample configuration
+    const config = await JmixBuilder.loadConfig('./samples/sample_config.json');
+    console.log('✅ Sample configuration created');
+    console.log('   Patient:', config.patient.name);
+    console.log('   Sender:', config.sender.name);
+    console.log('   Security:', config.security.classification);
+
+    // Use sample DICOM directory
+    const testDicomPath = './samples/study_1';
+    await fs.mkdir(testDicomPath, { recursive: true });
+    console.log('✅ Using sample DICOM directory');
+
+    // Build a JMIX envelope
+    console.log('\n📦 Building JMIX envelope...');
+    const envelope = await builder.buildFromDicom(testDicomPath, config);
+    
+    console.log('✅ JMIX envelope built successfully!');
+    console.log('   Envelope ID:', envelope.manifest.envelope_id);
+    console.log('   Audit events:', Array.isArray(envelope.audit?.audit) ? envelope.audit.audit.length : 0);
+    console.log('   Patient:', envelope.metadata.patient.name);
+    console.log('   DICOM instances:', envelope.metadata.dicom.instance_count);
+
+    // Save to files
+    console.log('\n💾 Saving envelope to files...');
+    await builder.saveToFiles(envelope);
+    
+    console.log('✅ Files saved to ./tmp/demo/');
+
+    // List the saved files
+    const savedFiles = await fs.readdir('./tmp/demo');
+    console.log('   Files created:');
+    for (const file of savedFiles.filter(f => f.endsWith('.json'))) {
+      const filePath = path.join('./tmp/demo', file);
+      const stats = await fs.stat(filePath);
+      console.log(`   - ${file} (${Math.round(stats.size / 1024 * 10) / 10} KB)`);
+    }
+
+    console.log('\n🎉 Demo completed successfully!');
+    console.log('\nTo explore the generated files:');
+    console.log('  cat ./tmp/demo/manifest.json | jq .');
+    console.log('  cat ./tmp/demo/metadata.json | jq .');
+    console.log('  cat ./tmp/demo/audit.json | jq .');
+
+  } catch (error) {
+    console.error('❌ Demo failed:', error.message);
+    if (error.cause) {
+      console.error('   Cause:', error.cause.message);
+    }
+    process.exit(1);
+  }
+}
+
+// Run the demo
+demo();

package/dist/dicom/DicomProcessor.d.ts

@@ -0,0 +1,40 @@
+import { DicomMetadata, Config } from '../types/index.js';
+export declare class DicomProcessor {
+    /**
+     * Process a DICOM directory and extract metadata
+     */
+    processDicomFolder(dicomPath: string, config?: Config): Promise<DicomMetadata>;
+    /**
+     * Recursively find DICOM files in a directory
+     */
+    private findDicomFiles;
+    /**
+     * Check if a file is a DICOM file by checking the magic signature
+     */
+    private isDicomFile;
+    /**
+     * Create metadata from config when DICOM parsing fails or no files found
+     */
+    private createMetadataFromConfig;
+    /**
+     * Generate a study UID (placeholder implementation)
+     */
+    private generateStudyUID;
+    /**
+     * Estimate series count based on file naming patterns or directory structure
+     */
+    private estimateSeriesCount;
+    /**
+     * Attempt to read a DICOM tag value using Daikon's API (best-effort)
+     */
+    private readTag;
+    /**
+     * Format DICOM date to ISO format
+     */
+    static formatDicomDate(dicomDate: string): string;
+    /**
+     * Format DICOM person name to readable format
+     */
+    static formatDicomPersonName(dicomName: string): string;
+}
+//# sourceMappingURL=DicomProcessor.d.ts.map

package/dist/dicom/DicomProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DicomProcessor.d.ts","sourceRoot":"","sources":["../../src/dicom/DicomProcessor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,aAAa,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAatE,qBAAa,cAAc;IACzB;;OAEG;IACG,kBAAkB,CACtB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC;IA6FzB;;OAEG;YACW,cAAc;IA6B5B;;OAEG;YACW,WAAW;IAqBzB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAgBhC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IAEH,OAAO,CAAC,OAAO;IAcf;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAYjD;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAWxD"}