Error Handling

// User abort error
interface UserAbortError extends Error {
  code: 'USER_ABORT';
  exitCode: 1;
  message: string;
}

// Example UserAbortError
const abortError: UserAbortError = {
  code: 'USER_ABORT',
  exitCode: 1,
  message: 'User aborted installation',
  name: 'UserAbortError',
  stack: '...'
};

// NpmRegistry error codes
type NpmRegistryErrorCode =
  | 'EMISSINGSIGNATUREKEY'      // Missing public key for signature verification
  | 'EEXPIREDSIGNATUREKEY'      // Expired public key
  | 'EINTEGRITYSIGNATURE'        // Invalid signature
  | 'EATTESTATIONSUBJECT'        // Attestation subject mismatch
  | 'EATTESTATIONVERIFY';        // Attestation verification failed

// Network/API errors
interface NetworkError extends Error {
  code: string;
  statusCode?: number;
  url?: string;
}

// Example NetworkError
const networkError: NetworkError = {
  code: 'ENOTFOUND',
  statusCode: 404,
  url: 'https://api.npmjs.org/package/express',
  message: 'Package not found',
  name: 'NetworkError',
  stack: '...'
};

// Package not found error
interface PackageNotFoundError extends Error {
  code: 'PACKAGE_NOT_FOUND';
  packageName: string;
}

// Example PackageNotFoundError
const notFoundError: PackageNotFoundError = {
  code: 'PACKAGE_NOT_FOUND',
  packageName: 'nonexistent-package',
  message: 'Package nonexistent-package not found',
  name: 'PackageNotFoundError',
  stack: '...'
};

const Marshall = require('npq/lib/marshall');

try {
  const marshall = new Marshall({
    pkgs: ['nonexistent-package@latest']
  });
  
  const results = await marshall.run();
} catch (error) {
  if (error.code === 'PACKAGE_NOT_FOUND') {
    console.error(`Package not found: ${error.packageName}`);
  } else if (error.code === 'USER_ABORT') {
    console.log('Operation aborted by user');
  } else if (error.code === 'ENOTFOUND' || error.code === 'ECONNREFUSED') {
    console.error('Network error:', error.message);
    console.error('URL:', error.url);
  } else if (error.code === 'EMISSINGSIGNATUREKEY') {
    console.error('Missing signature key for package verification');
  } else if (error.code === 'EEXPIREDSIGNATUREKEY') {
    console.warn('Expired signature key detected');
  } else if (error.code === 'EINTEGRITYSIGNATURE') {
    console.error('Invalid package signature detected');
  } else {
    console.error('Unexpected error:', error.message);
    console.error('Error code:', error.code);
    console.error('Stack:', error.stack);
  }
}

// Exit codes returned by npq CLI
type ExitCode = 0 | 1 | -1;

// 0: Success (no errors, or user confirmed installation)
// 1: User aborted operation (Ctrl+C or explicit 'n' response)
// -1: Error occurred (package not found, validation failed, network error, etc.)