opkg 0.5.0 → 0.6.1

package/dist/core/pull/pull-errors.js

@@ -0,0 +1,62 @@
+export function handleMetadataFailure(failure, packageName, requestedVersion) {
+    switch (failure.reason) {
+        case 'not-found':
+            console.error(`❌ Package '${packageName}' not found in registry`);
+            if (requestedVersion) {
+                console.log(`Version '${requestedVersion}' does not exist.`);
+            }
+            else {
+                console.log('Package does not exist in the registry.');
+            }
+            console.log('');
+            console.log('💡 Try one of these options:');
+            console.log('  • Check the package name spelling');
+            console.log('  • Use opkg search to find available packages');
+            console.log('  • Verify you have access to this package if it\'s private');
+            return { success: false, error: 'Package not found' };
+        case 'access-denied':
+            console.error(failure.message);
+            console.log('');
+            if (failure.statusCode === 403) {
+                console.log('💡 This may be a private package. Ensure you have VIEWER permissions.');
+            }
+            console.log('💡 To configure authentication:');
+            console.log('  opkg configure');
+            console.log('  opkg configure --profile <name>');
+            return { success: false, error: 'Access denied' };
+        case 'network':
+            console.log('');
+            console.log('💡 Try one of these options:');
+            console.log('  • Check your internet connection');
+            console.log('  • Try again (temporary network issue)');
+            console.log('  • Set OPENPACKAGEAPI_TIMEOUT environment variable for longer timeout');
+            return { success: false, error: 'Download failed' };
+        case 'integrity':
+            console.error(`❌ Package integrity verification failed: ${failure.message}`);
+            console.log('');
+            console.log('💡 The downloaded package may be corrupted. Try pulling again.');
+            return { success: false, error: 'Integrity verification failed' };
+        default:
+            return { success: false, error: failure.message };
+    }
+}
+export function handleUnexpectedError(error, packageName, requestedVersion) {
+    if (error && typeof error === 'object' && 'success' in error) {
+        return handleMetadataFailure(error, packageName, requestedVersion);
+    }
+    if (error instanceof Error) {
+        return handleMetadataFailure({
+            success: false,
+            reason: 'unknown',
+            message: error.message,
+            error
+        }, packageName, requestedVersion);
+    }
+    return handleMetadataFailure({
+        success: false,
+        reason: 'unknown',
+        message: 'Unknown error occurred',
+        error
+    }, packageName, requestedVersion);
+}
+//# sourceMappingURL=pull-errors.js.map

package/dist/core/pull/pull-errors.js.map

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

package/dist/core/pull/pull-options.js

@@ -0,0 +1,2 @@
+export { parsePathsOption, buildRequestedPaths } from '../../utils/registry-paths.js';
+//# sourceMappingURL=pull-options.js.map

package/dist/core/pull/pull-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-options.js","sourceRoot":"","sources":["../../../src/core/pull/pull-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/core/pull/pull-output.js

@@ -0,0 +1,50 @@
+import { formatFileSize } from '../../utils/formatters.js';
+import { formatVersionLabel } from '../../utils/package-versioning.js';
+const UNVERSIONED_LABEL = 'unversioned';
+function hasDefinedManifestVersion(response) {
+    const manifestVersion = response.version.version;
+    return manifestVersion !== undefined && manifestVersion !== null;
+}
+function getResolvedVersionLabel(response, versionToPull) {
+    if (!hasDefinedManifestVersion(response)) {
+        return UNVERSIONED_LABEL;
+    }
+    return versionToPull;
+}
+export function displayPackageInfo(response, parsedVersion, versionToPull, profile) {
+    const inaccessibleDownloads = (response.downloads ?? []).filter((download) => !download.downloadUrl);
+    if (inaccessibleDownloads.length > 0) {
+        console.log(`⚠️  Skipping ${inaccessibleDownloads.length} downloads:`);
+        inaccessibleDownloads.forEach((download) => {
+            console.log(`  • ${download.name}: not found or insufficient permissions`);
+        });
+        console.log('');
+    }
+    console.log('✓ Package found in registry');
+    const resolvedVersionLabel = getResolvedVersionLabel(response, versionToPull);
+    console.log(`✓ Version: ${parsedVersion ?? 'latest'} (resolved: ${resolvedVersionLabel})`);
+    console.log(`✓ Profile: ${profile}`);
+    console.log('');
+}
+export function displayPullResults(result, response) {
+    console.log('✓ Pull successful');
+    console.log('');
+    console.log('✓ Package Details:');
+    console.log(`  • Name: ${result.packageName}`);
+    const manifestVersion = response.version.version;
+    if (hasDefinedManifestVersion(response) && manifestVersion) {
+        console.log(`  • Version: ${formatVersionLabel(manifestVersion)}`);
+    }
+    console.log(`  • Description: ${response.package.description || '(no description)'}`);
+    console.log(`  • Size: ${formatFileSize(result.size)}`);
+    const keywords = Array.isArray(response.package.keywords) ? response.package.keywords : [];
+    if (keywords.length > 0) {
+        console.log(`  • Keywords: ${keywords.join(', ')}`);
+    }
+    console.log(`  • Private: ${result.isPrivate ? 'Yes' : 'No'}`);
+    console.log(`  • Files: ${result.files}`);
+    if (result.checksum) {
+        console.log(`  • Checksum: ${result.checksum.substring(0, 16)}...`);
+    }
+}
+//# sourceMappingURL=pull-output.js.map

package/dist/core/pull/pull-output.js.map

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

package/dist/core/pull/pull-pipeline.js

@@ -0,0 +1,141 @@
+import { packageManager } from '../package.js';
+import { hasPackageVersion } from '../directory.js';
+import { logger } from '../../utils/logger.js';
+import { UserCancellationError } from '../../utils/errors.js';
+import { parsePackageInstallSpec } from '../../utils/package-name.js';
+import { promptOverwriteConfirmation } from '../../utils/prompts.js';
+import { Spinner } from '../../utils/spinner.js';
+import { formatVersionLabel } from '../../utils/package-versioning.js';
+import { fetchRemotePackageMetadata } from '../remote-pull.js';
+import { buildRequestedPaths } from './pull-options.js';
+import { displayPackageInfo, displayPullResults } from './pull-output.js';
+import { handleMetadataFailure, handleUnexpectedError } from './pull-errors.js';
+import { pullRecursive, pullSingle } from './pull-strategies.js';
+export async function runPullPipeline(packageInput, options) {
+    const parsedSpec = parsePackageInstallSpec(packageInput);
+    const parsedName = parsedSpec.name;
+    const parsedVersion = parsedSpec.version;
+    const specPath = parsedSpec.registryPath;
+    const requestedPaths = buildRequestedPaths(options.paths, specPath);
+    logger.info(`Pulling package '${parsedName}' from remote registry`, { options });
+    try {
+        const pullOptions = {
+            profile: options.profile,
+            apiKey: options.apiKey,
+            recursive: !!options.recursive,
+            paths: requestedPaths
+        };
+        console.log(`✓ Pulling package '${parsedName}' from remote registry...`);
+        console.log(`✓ Version: ${parsedVersion ?? 'latest'}`);
+        console.log('');
+        const metadataResult = await fetchMetadataWithSpinner(parsedName, parsedVersion, pullOptions);
+        if (!metadataResult.success) {
+            return handleMetadataFailure(metadataResult, parsedName, parsedVersion);
+        }
+        const { response, context } = metadataResult;
+        const registryUrl = context.registryUrl;
+        const profile = context.profile;
+        const versionToPull = formatVersionLabel(response.version.version);
+        displayPackageInfo(response, parsedVersion, versionToPull, profile);
+        if (requestedPaths.length > 0) {
+            logPartialPullRequest(requestedPaths, options.recursive);
+        }
+        const partialConfig = await resolvePartialConfig(requestedPaths, parsedName, versionToPull);
+        if (partialConfig === 'skip') {
+            return {
+                success: true,
+                data: {
+                    packageName: parsedName,
+                    version: versionToPull,
+                    files: 0,
+                    size: response.version.tarballSize,
+                    checksum: '',
+                    registry: registryUrl,
+                    profile,
+                    isPrivate: response.package.isPrivate,
+                    downloadUrl: '',
+                    message: 'Local full version already present; partial pull skipped'
+                }
+            };
+        }
+        if (!options.recursive && versionToPull && requestedPaths.length === 0) {
+            await handleVersionChecks(parsedName, versionToPull);
+        }
+        const result = options.recursive
+            ? await pullRecursive({ parsedName, versionToPull, response, context, registryUrl, profile })
+            : await pullSingle({
+                parsedName,
+                parsedVersion,
+                response,
+                context,
+                pullOptions,
+                registryUrl,
+                profile,
+                partialConfig: partialConfig ?? undefined
+            });
+        displayPullResults(result, response);
+        return {
+            success: true,
+            data: result
+        };
+    }
+    catch (error) {
+        logger.debug('Pull pipeline failed', { error, packageName: parsedName });
+        return handleUnexpectedError(error, parsedName, parsedVersion);
+    }
+}
+async function fetchMetadataWithSpinner(parsedName, parsedVersion, pullOptions) {
+    const metadataSpinner = new Spinner('Querying registry for package...');
+    metadataSpinner.start();
+    try {
+        const result = await fetchRemotePackageMetadata(parsedName, parsedVersion, pullOptions);
+        metadataSpinner.stop();
+        return result;
+    }
+    catch (error) {
+        metadataSpinner.stop();
+        throw error;
+    }
+}
+async function handleVersionChecks(parsedName, versionToPull) {
+    const localVersionExists = await hasPackageVersion(parsedName, versionToPull);
+    if (localVersionExists) {
+        console.log(`⚠️  Version '${versionToPull}' of package '${parsedName}' already exists locally`);
+        console.log('');
+        const shouldProceed = await promptOverwriteConfirmation(parsedName, versionToPull);
+        if (!shouldProceed) {
+            throw new UserCancellationError('User declined to overwrite existing package version');
+        }
+        console.log('');
+    }
+    const localExists = await packageManager.packageExists(parsedName);
+    if (localExists && !localVersionExists) {
+        console.log(`✓ Package '${parsedName}' has other versions locally`);
+        console.log('Pulling will add a new version.');
+        console.log('');
+    }
+}
+function logPartialPullRequest(requestedPaths, isRecursive) {
+    console.log(`✓ Partial pull requested for paths: ${requestedPaths.join(', ')}`);
+    if (isRecursive) {
+        console.log('✓ Dependencies will be pulled fully; paths apply only to the primary package.');
+    }
+}
+async function resolvePartialConfig(requestedPaths, parsedName, versionToPull) {
+    if (requestedPaths.length === 0) {
+        return undefined;
+    }
+    const localState = await packageManager.getPackageVersionState(parsedName, versionToPull);
+    if (localState.exists && !localState.isPartial) {
+        console.log(`⚠️  ${parsedName}@${versionToPull} already exists locally (full). Skipping partial pull.`);
+        return 'skip';
+    }
+    if (localState.isPartial) {
+        console.log('✓ Existing partial version found locally; merging with remote content.');
+    }
+    return {
+        requestPaths: requestedPaths,
+        localState
+    };
+}
+//# sourceMappingURL=pull-pipeline.js.map

package/dist/core/pull/pull-pipeline.js.map

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

package/dist/core/pull/pull-strategies.js

@@ -0,0 +1,103 @@
+import { planRemoteDownloadsForPackage } from '../install/remote-flow.js';
+import { recordBatchOutcome } from '../install/remote-reporting.js';
+import { formatVersionLabel } from '../../utils/package-versioning.js';
+import { Spinner } from '../../utils/spinner.js';
+import { pullDownloadsBatchFromRemote, pullPackageFromRemote } from '../remote-pull.js';
+export async function pullSingle({ parsedName, parsedVersion, response, context, pullOptions, registryUrl, profile, partialConfig }) {
+    const downloadSpinner = new Spinner('Downloading package tarball...');
+    downloadSpinner.start();
+    try {
+        const pullResult = await pullPackageFromRemote(parsedName, parsedVersion, {
+            ...pullOptions,
+            preFetchedResponse: response,
+            httpClient: context.httpClient,
+            paths: partialConfig?.requestPaths
+        });
+        downloadSpinner.stop();
+        if (!pullResult.success) {
+            throw pullResult;
+        }
+        const extracted = pullResult.extracted;
+        const resolvedVersion = formatVersionLabel(pullResult.response.version.version);
+        return {
+            packageName: pullResult.response.package.name,
+            version: resolvedVersion,
+            files: extracted.files.length,
+            size: pullResult.response.version.tarballSize,
+            checksum: extracted.checksum,
+            registry: registryUrl,
+            profile,
+            isPrivate: pullResult.response.package.isPrivate,
+            downloadUrl: pullResult.downloadUrl,
+            message: 'Package pulled and installed successfully'
+        };
+    }
+    catch (error) {
+        downloadSpinner.stop();
+        throw error;
+    }
+}
+export async function pullRecursive({ parsedName, versionToPull, response, context, registryUrl, profile }) {
+    const { downloadKeys, warnings: planWarnings } = await planRemoteDownloadsForPackage({ success: true, context, response }, {});
+    if (planWarnings.length > 0) {
+        planWarnings.forEach(warning => console.log(`⚠️  ${warning}`));
+        console.log('');
+    }
+    if (downloadKeys.size === 0) {
+        console.log('✓ All packages already exist locally, nothing to pull');
+        console.log('');
+        return {
+            packageName: parsedName,
+            version: versionToPull,
+            files: 0,
+            size: response.version.tarballSize,
+            checksum: '',
+            registry: registryUrl,
+            profile,
+            isPrivate: response.package.isPrivate,
+            downloadUrl: '',
+            message: 'All packages already exist locally'
+        };
+    }
+    const downloadSpinner = new Spinner(`Downloading ${downloadKeys.size} package(s) from remote registry...`);
+    downloadSpinner.start();
+    try {
+        const batchResult = await pullDownloadsBatchFromRemote(response, {
+            httpClient: context.httpClient,
+            profile: context.profile,
+            dryRun: false,
+            filter: (dependencyName, dependencyVersion) => {
+                const downloadKey = `${dependencyName}@${dependencyVersion}`;
+                return downloadKeys.has(downloadKey);
+            },
+            skipIfFull: true
+        });
+        downloadSpinner.stop();
+        recordBatchOutcome('Pulled packages', batchResult, [], false);
+        if (!batchResult.success) {
+            throw {
+                success: false,
+                reason: 'network',
+                message: `Failed to pull ${batchResult.failed.length} package(s)`
+            };
+        }
+        const mainPackageResult = batchResult.pulled.find(item => item.name === parsedName && item.version === versionToPull);
+        return {
+            packageName: parsedName,
+            version: versionToPull,
+            files: mainPackageResult ? 0 : 0,
+            size: response.version.tarballSize,
+            checksum: '',
+            registry: registryUrl,
+            profile,
+            isPrivate: response.package.isPrivate,
+            downloadUrl: mainPackageResult?.downloadUrl || '',
+            message: `Successfully pulled ${batchResult.pulled.length} package(s) (${batchResult.failed.length} failed)`
+        };
+    }
+    catch (error) {
+        downloadSpinner.stop();
+        throw error;
+    }
+}
+//# sourceMappingURL=pull-strategies.js.map

package/dist/core/pull/pull-strategies.js.map

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

package/dist/core/pull/pull-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pull-types.js.map

package/dist/core/pull/pull-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-types.js","sourceRoot":"","sources":["../../../src/core/pull/pull-types.ts"],"names":[],"mappings":""}

package/dist/core/push/push-context.js

@@ -0,0 +1,95 @@
+import * as semver from 'semver';
+import { UNVERSIONED } from '../../constants/index.js';
+import { getCurrentUsername } from '../api-keys.js';
+import { listPackageVersions } from '../directory.js';
+import { packageManager } from '../package.js';
+import { resolveScopedNameForPushWithUserScope, isScopedName } from '../scoping/package-scoping.js';
+import { parsePackagePushSpec } from '../../utils/package-name.js';
+import { getLatestStableVersion } from '../../utils/package-versioning.js';
+import { promptConfirmation } from '../../utils/prompts.js';
+import { logger } from '../../utils/logger.js';
+import { PushError } from './push-errors.js';
+import { buildRequestedPaths } from '../../utils/registry-paths.js';
+import { UserCancellationError } from '../../utils/errors.js';
+export function resolvePushRequestContext(packageInput, optionPaths) {
+    const parsedSpec = parsePackagePushSpec(packageInput);
+    const requestedPaths = buildRequestedPaths(optionPaths, parsedSpec.registryPath);
+    const mode = requestedPaths.length > 0 ? 'partial' : 'full';
+    return {
+        parsedName: parsedSpec.name,
+        parsedVersion: parsedSpec.version,
+        requestedPaths,
+        mode
+    };
+}
+export async function resolveUploadNameForPush(packageName, authOptions) {
+    if (isScopedName(packageName)) {
+        return packageName;
+    }
+    const username = await getCurrentUsername(authOptions);
+    return await resolveScopedNameForPushWithUserScope(packageName, username, authOptions.profile);
+}
+export async function resolvePushResolution(packageName, parsedVersion) {
+    if (parsedVersion) {
+        return resolveExplicitPush(packageName, parsedVersion);
+    }
+    return resolveImplicitPush(packageName, async (latest) => {
+        const proceed = await promptConfirmation(`Push latest stable version '${latest}'?`, true);
+        if (!proceed) {
+            throw new UserCancellationError('User declined pushing the stable version');
+        }
+    });
+}
+export function validateUploadVersion(uploadVersion) {
+    if (!uploadVersion) {
+        return;
+    }
+    assertStableSemver(uploadVersion);
+}
+function assertStableSemver(version) {
+    if (!semver.valid(version)) {
+        throw new PushError(`Invalid version: ${version}. Provide a valid semver version.`, 'INVALID_VERSION');
+    }
+    if (semver.prerelease(version)) {
+        throw new PushError(`Prerelease versions cannot be pushed: ${version}`, 'PRERELEASE_DISALLOWED');
+    }
+}
+async function resolveExplicitPush(packageName, parsedVersion) {
+    assertStableSemver(parsedVersion);
+    const pkg = await packageManager.loadPackage(packageName, parsedVersion);
+    logVersionMismatch(packageName, parsedVersion, pkg.metadata.version);
+    const effectiveVersion = pkg.metadata.version ?? parsedVersion;
+    return { pkg, versionToPush: effectiveVersion, source: 'explicit' };
+}
+async function resolveImplicitPush(packageName, onConfirmLatest) {
+    const allVersions = await listPackageVersions(packageName);
+    const stableVersions = allVersions.filter((version) => version !== UNVERSIONED);
+    const latestStable = getLatestStableVersion(stableVersions);
+    if (latestStable) {
+        await onConfirmLatest(latestStable);
+        const pkg = await packageManager.loadPackage(packageName, latestStable);
+        const effectiveVersion = pkg.metadata.version ?? latestStable;
+        return { pkg, versionToPush: effectiveVersion, source: 'latest-stable' };
+    }
+    if (allVersions.includes(UNVERSIONED)) {
+        const pkg = await packageManager.loadPackage(packageName, UNVERSIONED);
+        const manifestVersion = pkg.metadata.version;
+        if (manifestVersion === undefined || manifestVersion === null) {
+            return { pkg, versionToPush: undefined, source: 'unversioned' };
+        }
+        assertStableSemver(manifestVersion);
+        await onConfirmLatest(manifestVersion);
+        return { pkg, versionToPush: manifestVersion, source: 'latest-stable' };
+    }
+    throw new PushError(`No versions found for package '${packageName}'. Create a package with "opkg pack <package>" or ensure package.yml exists.`, 'NO_VERSIONS');
+}
+function logVersionMismatch(packageName, requested, manifestVersion) {
+    if (manifestVersion && manifestVersion !== requested) {
+        logger.warn('Version mismatch between manifest and requested push', {
+            packageName,
+            manifestVersion,
+            requested
+        });
+    }
+}
+//# sourceMappingURL=push-context.js.map

package/dist/core/push/push-context.js.map

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

package/dist/core/push/push-errors.js

@@ -0,0 +1,133 @@
+import { logger } from '../../utils/logger.js';
+import { showApiKeySignupMessage } from '../../utils/messages.js';
+import { PackageNotFoundError, UserCancellationError } from '../../utils/errors.js';
+export class PushError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'PushError';
+    }
+}
+export function handlePushError(error, packageName, attemptedVersion, requestedVersion) {
+    logger.debug('Push pipeline failed', { error, packageName });
+    if (error instanceof UserCancellationError) {
+        throw error;
+    }
+    if (error instanceof PackageNotFoundError) {
+        const versionLabel = requestedVersion ?? attemptedVersion ?? 'requested version';
+        console.error(`❌ Version ${versionLabel} not found for package '${packageName}'`);
+        console.log('💡 Create this stable version using "opkg pack <package>" and push again.');
+        return { success: false, error: 'Version not found' };
+    }
+    if (error instanceof PushError) {
+        if (error.code === 'INVALID_VERSION') {
+            console.error(`❌ ${error.message}`);
+            return { success: false, error: 'Invalid version' };
+        }
+        if (error.code === 'PRERELEASE_DISALLOWED') {
+            console.error(`❌ ${error.message}`);
+            console.log('Only stable versions (x.y.z) can be pushed to the remote registry.');
+            console.log('💡 Create a stable version using "opkg pack <package>".');
+            return { success: false, error: 'Only stable versions can be pushed' };
+        }
+        if (error.code === 'NO_VERSIONS') {
+            console.error(`❌ ${error.message}`);
+            return { success: false, error: 'Version not found' };
+        }
+        console.error(`❌ ${error.message}`);
+        return { success: false, error: error.message };
+    }
+    if (error instanceof Error) {
+        const apiError = error.apiError;
+        if (apiError?.statusCode === 409) {
+            console.error(`❌ Version ${attemptedVersion || 'latest'} already exists for package '${packageName}'`);
+            console.log('💡 Try one of these options:');
+            console.log('  • Increment version with command "opkg pack <package>"');
+            console.log('  • Update version with command "opkg pack <package>@<version>"');
+            console.log('  • Specify a version explicitly using <package>@<version>');
+            return { success: false, error: 'Version already exists' };
+        }
+        if (apiError?.statusCode === 401) {
+            console.error(`❌ Authentication failed: ${error.message}`);
+            showApiKeySignupMessage();
+            console.log('💡 To configure authentication:');
+            console.log('  opkg configure');
+            console.log('  opkg configure --profile <name>');
+            return { success: false, error: 'Authentication failed' };
+        }
+        if (apiError?.statusCode === 403) {
+            console.error(`❌ Access denied: ${error.message}`);
+            showApiKeySignupMessage();
+            console.log('💡 To configure authentication:');
+            console.log('  opkg configure');
+            console.log('  opkg configure --profile <name>');
+            return { success: false, error: 'Access denied' };
+        }
+        if (apiError?.statusCode === 422) {
+            const apiMessage = apiError.message || error.message || 'Validation failed';
+            console.error(`❌ Package validation failed: ${apiMessage}`);
+            if (apiError.details) {
+                const detailsArray = Array.isArray(apiError.details) ? apiError.details : [apiError.details];
+                console.log('Validation errors:');
+                detailsArray.forEach((detail) => {
+                    if (typeof detail === 'string') {
+                        console.log(`  • ${detail}`);
+                        return;
+                    }
+                    if (detail?.message) {
+                        console.log(`  • ${detail.message}`);
+                        return;
+                    }
+                    if (detail?.constraints && typeof detail.constraints === 'object') {
+                        console.log(`  • ${Object.values(detail.constraints).join(', ')}`);
+                        return;
+                    }
+                    console.log(`  • ${JSON.stringify(detail)}`);
+                });
+            }
+            else if (apiError) {
+                console.log('Validation error detail (raw):');
+                console.log(`  • ${JSON.stringify(apiError)}`);
+            }
+            return { success: false, error: apiMessage };
+        }
+        if (apiError) {
+            const apiMessage = apiError.message || error.message || 'Request failed';
+            console.error(`❌ Request failed (${apiError.statusCode ?? 'unknown status'}): ${apiMessage}`);
+            if (apiError.error) {
+                console.log(`  • code: ${apiError.error}`);
+            }
+            if (apiError.details) {
+                const detailsArray = Array.isArray(apiError.details) ? apiError.details : [apiError.details];
+                detailsArray.forEach((detail) => {
+                    if (typeof detail === 'string') {
+                        console.log(`  • ${detail}`);
+                        return;
+                    }
+                    if (detail?.message) {
+                        console.log(`  • ${detail.message}`);
+                        return;
+                    }
+                    if (detail?.constraints && typeof detail.constraints === 'object') {
+                        console.log(`  • ${Object.values(detail.constraints).join(', ')}`);
+                        return;
+                    }
+                    console.log(`  • ${JSON.stringify(detail)}`);
+                });
+            }
+            else {
+                console.log(`  • raw: ${JSON.stringify(apiError)}`);
+            }
+            return { success: false, error: apiMessage };
+        }
+        if (error.message.includes('timeout')) {
+            console.log('💡 The upload may have timed out. You can:');
+            console.log('  • Try again (the upload may have succeeded)');
+            console.log('  • Check your internet connection');
+            console.log('  • Set OPENPACKAGEAPI_TIMEOUT environment variable for longer timeout');
+        }
+        return { success: false, error: error.message };
+    }
+    return { success: false, error: 'Unknown error occurred' };
+}
+//# sourceMappingURL=push-errors.js.map