opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/publish/publish-types.js.map

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

package/packages/core/dist/core/publish/publish-upload.d.ts

@@ -0,0 +1,9 @@
+import type { PushPackageResponse } from '../../types/api.js';
+import type { Package } from '../../types/index.js';
+import type { HttpClient } from '../http-client.js';
+import type { OutputPort } from '../ports/output.js';
+import { createTarballFromPackage } from '../../utils/tarball.js';
+export declare function preparePackageForUpload(pkg: Package, uploadName: string): Package;
+export declare function createPublishTarball(pkg: Package, output?: OutputPort): Promise<import("../../utils/tarball.js").TarballInfo>;
+export declare function uploadPackage(httpClient: HttpClient, packageName: string, uploadVersion: string | undefined, tarballInfo: Awaited<ReturnType<typeof createTarballFromPackage>>, output?: OutputPort, stopMessage?: string): Promise<PushPackageResponse>;
+//# sourceMappingURL=publish-upload.d.ts.map

package/packages/core/dist/core/publish/publish-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-upload.d.ts","sourceRoot":"","sources":["../../../src/core/publish/publish-upload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAA2B,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAG3F,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CA0BjF;AAED,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,UAAU,yDAK3E;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,EACjE,MAAM,CAAC,EAAE,UAAU,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAQ9B"}

package/packages/core/dist/core/publish/publish-upload.js

@@ -0,0 +1,51 @@
+import { PACKAGE_PATHS } from '../../constants/index.js';
+import { formatFileSize } from '../../utils/formatters.js';
+import { normalizePathForProcessing } from '../../utils/path-normalization.js';
+import { resolveOutput } from '../ports/resolve.js';
+import { createFormDataForUpload, createTarballFromPackage } from '../../utils/tarball.js';
+import { serializePackageYml } from '../../utils/package-yml.js';
+export function preparePackageForUpload(pkg, uploadName) {
+    if (pkg.metadata.name === uploadName) {
+        return pkg;
+    }
+    const manifestPath = normalizePathForProcessing(PACKAGE_PATHS.MANIFEST_RELATIVE);
+    const updatedMetadata = { ...pkg.metadata, name: uploadName };
+    let manifestUpdated = false;
+    const updatedFiles = pkg.files.map((file) => {
+        if (normalizePathForProcessing(file.path) === manifestPath) {
+            manifestUpdated = true;
+            const content = serializePackageYml(updatedMetadata);
+            return { ...file, content };
+        }
+        return file;
+    });
+    if (!manifestUpdated) {
+        throw new Error('openpackage.yml not found in package files');
+    }
+    return {
+        metadata: updatedMetadata,
+        files: updatedFiles,
+    };
+}
+export async function createPublishTarball(pkg, output) {
+    const out = output ?? resolveOutput();
+    const tarballInfo = await createTarballFromPackage(pkg);
+    out.success(`Created tarball (${pkg.files.length} files, ${formatFileSize(tarballInfo.size)})`);
+    return tarballInfo;
+}
+export async function uploadPackage(httpClient, packageName, uploadVersion, tarballInfo, output, stopMessage) {
+    const out = output ?? resolveOutput();
+    const formData = createFormDataForUpload(packageName, uploadVersion, tarballInfo);
+    const uploadSpinner = out.spinner();
+    return withSpinner(uploadSpinner, 'Uploading to registry...', () => httpClient.uploadFormData('/packages/push', formData), stopMessage);
+}
+async function withSpinner(spinner, message, fn, stopMessage) {
+    spinner.start(message);
+    try {
+        return await fn();
+    }
+    finally {
+        spinner.stop(stopMessage);
+    }
+}
+//# sourceMappingURL=publish-upload.js.map

package/packages/core/dist/core/publish/publish-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-upload.js","sourceRoot":"","sources":["../../../src/core/publish/publish-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,UAAU,uBAAuB,CAAC,GAAY,EAAE,UAAkB;IACtE,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,YAAY,GAAG,0BAA0B,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACjF,MAAM,eAAe,GAAG,EAAE,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9D,IAAI,eAAe,GAAG,KAAK,CAAC;IAE5B,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1C,IAAI,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,YAAY,EAAE,CAAC;YAC3D,eAAe,GAAG,IAAI,CAAC;YACvB,MAAM,OAAO,GAAG,mBAAmB,CAAC,eAAe,CAAC,CAAC;YACrD,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,eAAe;QACzB,KAAK,EAAE,YAAY;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAY,EAAE,MAAmB;IAC1E,MAAM,GAAG,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,MAAM,wBAAwB,CAAC,GAAG,CAAC,CAAC;IACxD,GAAG,CAAC,OAAO,CAAC,oBAAoB,GAAG,CAAC,KAAK,CAAC,MAAM,WAAW,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChG,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAsB,EACtB,WAAmB,EACnB,aAAiC,EACjC,WAAiE,EACjE,MAAmB,EACnB,WAAoB;IAEpB,MAAM,GAAG,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;IAClF,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IACpC,OAAO,WAAW,CAAC,aAAa,EAAE,0BAA0B,EAAE,GAAG,EAAE,CACjE,UAAU,CAAC,cAAc,CAAsB,gBAAgB,EAAE,QAAQ,CAAC,EAC1E,WAAW,CACZ,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CAAI,OAA0C,EAAE,OAAe,EAAE,EAAoB,EAAE,WAAoB;IACnI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/packages/core/dist/core/registry-writer.d.ts

@@ -0,0 +1,22 @@
+import type { OutputPort } from './ports/output.js';
+import type { PromptPort } from './ports/prompt.js';
+import type { PackageFile } from '../types/index.js';
+export interface RegistryWriteOptions {
+    /** Force overwrite without prompting */
+    force?: boolean;
+    /** Dry run mode - don't actually write */
+    dryRun?: boolean;
+    /** Context for logging/errors (e.g., "pack", "publish") */
+    context?: string;
+}
+export interface RegistryWriteResult {
+    destination: string;
+    fileCount: number;
+    overwritten: boolean;
+}
+/**
+ * Write package files to local registry
+ * Handles overwrite confirmation, directory setup, and file writing
+ */
+export declare function writePackageToRegistry(packageName: string, version: string, files: PackageFile[], options?: RegistryWriteOptions, output?: OutputPort, prompt?: PromptPort): Promise<RegistryWriteResult>;
+//# sourceMappingURL=registry-writer.d.ts.map

package/packages/core/dist/core/registry-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-writer.d.ts","sourceRoot":"","sources":["../../src/core/registry-writer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,GAAE,oBAAyB,EAClC,MAAM,CAAC,EAAE,UAAU,EACnB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,mBAAmB,CAAC,CAwG9B"}

package/packages/core/dist/core/registry-writer.js

@@ -0,0 +1,93 @@
+import { ensureRegistryDirectories, getPackageVersionPath, } from './directory.js';
+import { exists, remove, countFilesInDirectory } from '../utils/fs.js';
+import { writePackageFilesToDirectory } from '../utils/package-copy.js';
+import { formatPathForDisplay } from '../utils/formatters.js';
+import { logger } from '../utils/logger.js';
+import { isUnversionedPackage } from '../utils/validation/version.js';
+import { resolveOutput, resolvePrompt } from './ports/resolve.js';
+/**
+ * Write package files to local registry
+ * Handles overwrite confirmation, directory setup, and file writing
+ */
+export async function writePackageToRegistry(packageName, version, files, options = {}, output, prompt) {
+    const { force = false, dryRun = false, context = 'operation' } = options;
+    const out = output ?? resolveOutput();
+    const prm = prompt ?? resolvePrompt();
+    // Get destination path
+    const destination = getPackageVersionPath(packageName, version);
+    // Check if destination exists
+    const destinationExists = await exists(destination);
+    const existingFileCount = destinationExists
+        ? await countFilesInDirectory(destination)
+        : 0;
+    // Handle overwrite logic
+    let shouldOverwrite = true;
+    if (destinationExists) {
+        const unversioned = isUnversionedPackage(version);
+        if (unversioned) {
+            // Unversioned packages: silent auto-overwrite with subtle message
+            logger.debug(`Updating unversioned package ${packageName}@${version}`, { destination, existingFileCount });
+            out.success(`Updated ${packageName}@${version}`);
+        }
+        else if (force) {
+            // Force mode: auto-approve with logging
+            logger.info(`Force mode: Overwriting ${packageName}@${version}`, { destination, existingFileCount });
+            out.warn(`Force mode: Overwriting ${packageName}@${version} ` +
+                `(${existingFileCount} existing file${existingFileCount !== 1 ? 's' : ''})`);
+        }
+        else {
+            // Versioned packages: require confirmation via the prompt port
+            // If the prompt port is nonInteractivePrompt (the default), it will
+            // throw NonInteractivePromptError, which we catch below.
+            try {
+                // Interactive mode - prompt user with inline overwrite confirmation
+                const displayPath = formatPathForDisplay(destination, process.cwd());
+                out.info('');
+                out.warn(`Package '${packageName}@${version}' already exists in registry`);
+                out.info(`   Location: ${displayPath}`);
+                out.info(`   Existing files: ${existingFileCount}`);
+                out.info('');
+                shouldOverwrite = await prm.confirm(`Overwrite '${packageName}@${version}'? This action cannot be undone.`, false);
+                if (!shouldOverwrite) {
+                    throw new Error(`${context} cancelled by user`);
+                }
+            }
+            catch (promptError) {
+                // NonInteractivePromptError or similar -- non-interactive environment
+                if (promptError.name === 'NonInteractivePromptError') {
+                    const displayPath = formatPathForDisplay(destination, process.cwd());
+                    throw new Error(`Package ${packageName}@${version} already exists in registry (${displayPath}).\n` +
+                        `Use --force to overwrite, or update the version in openpackage.yml.`);
+                }
+                throw promptError;
+            }
+        }
+    }
+    // Dry run - return without writing
+    if (dryRun) {
+        return {
+            destination,
+            fileCount: files.length,
+            overwritten: destinationExists
+        };
+    }
+    // Ensure registry directories exist
+    await ensureRegistryDirectories();
+    // Remove existing destination if overwriting
+    if (destinationExists) {
+        await remove(destination);
+    }
+    // Write files to registry
+    await writePackageFilesToDirectory(destination, files);
+    logger.info(`Wrote ${packageName}@${version} to registry`, {
+        destination,
+        fileCount: files.length,
+        context
+    });
+    return {
+        destination,
+        fileCount: files.length,
+        overwritten: destinationExists
+    };
+}
+//# sourceMappingURL=registry-writer.js.map

package/packages/core/dist/core/registry-writer.js.map

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

package/packages/core/dist/core/remote-pull.d.ts

@@ -0,0 +1,93 @@
+import { PullPackageDownload, PullPackageResponse } from '../types/api.js';
+import { HttpClient } from './http-client.js';
+import { ExtractedPackage } from '../utils/tarball.js';
+export interface RemotePullContext {
+    httpClient: HttpClient;
+    profile: string;
+    registryUrl: string;
+}
+export interface RemotePullOptions {
+    profile?: string;
+    apiKey?: string;
+    quiet?: boolean;
+    preFetchedResponse?: PullPackageResponse;
+    httpClient?: HttpClient;
+    recursive?: boolean;
+    paths?: string[];
+    skipLocalCheck?: boolean;
+}
+export interface RemoteBatchPullOptions extends RemotePullOptions {
+    dryRun?: boolean;
+    filter?: (name: string, version: string, download: PullPackageDownload) => boolean;
+    skipIfFull?: boolean;
+}
+export type RemotePullFailureReason = 'not-found' | 'access-denied' | 'network' | 'integrity' | 'unknown';
+export interface RemotePullFailure {
+    success: false;
+    reason: RemotePullFailureReason;
+    message: string;
+    statusCode?: number;
+    error?: unknown;
+}
+export interface RemotePullSuccess {
+    success: true;
+    name: string;
+    version: string;
+    response: PullPackageResponse;
+    extracted: ExtractedPackage;
+    registryUrl: string;
+    profile: string;
+    downloadUrl: string;
+    tarballSize: number | undefined;
+}
+export type RemotePullResult = RemotePullSuccess | RemotePullFailure;
+export interface RemotePackageMetadataSuccess {
+    success: true;
+    context: RemotePullContext;
+    response: PullPackageResponse;
+}
+export type RemotePackageMetadataResult = RemotePackageMetadataSuccess | RemotePullFailure;
+export interface BatchDownloadItemResult {
+    name: string;
+    version: string;
+    downloadUrl?: string;
+    success: boolean;
+    error?: string;
+}
+export interface RemoteBatchPullResult {
+    success: boolean;
+    pulled: BatchDownloadItemResult[];
+    failed: BatchDownloadItemResult[];
+    warnings?: string[];
+}
+export declare function buildPullEndpoint(name: string, version?: string, options?: {
+    recursive?: boolean;
+    paths?: string[];
+}): string;
+/**
+ * Parse a download identifier that may contain registry path segments.
+ *
+ * Supports forms like:
+ *   - foo@1.2.3
+ *   - foo/bar@1.2.3
+ *   - @scope/foo/bar@1.2.3
+ *   - foo@1.2.3/path/to/file
+ *   - @scope/foo@1.2.3/path/to/file
+ *
++ * The registry path (if present) is returned separately so callers can
+ * preserve file-level intent once the backend supports file-scoped downloads.
+ */
+export declare function parseDownloadIdentifier(downloadName: string): {
+    packageName: string;
+    version: string;
+    registryPath?: string;
+};
+/**
+ * Backward-compatible wrapper returning only name/version.
+ */
+export declare function aggregateRecursiveDownloads(responses: PullPackageResponse[]): PullPackageDownload[];
+export declare function isPartialDownload(download?: PullPackageDownload): boolean;
+export declare function pullDownloadsBatchFromRemote(responses: PullPackageResponse | PullPackageResponse[], options?: RemoteBatchPullOptions): Promise<RemoteBatchPullResult>;
+export declare function fetchRemotePackageMetadata(name: string, version: string | undefined, options?: RemotePullOptions): Promise<RemotePackageMetadataResult>;
+export declare function pullPackageFromRemote(name: string, version?: string, options?: RemotePullOptions): Promise<RemotePullResult>;
+//# sourceMappingURL=remote-pull.d.ts.map

package/packages/core/dist/core/remote-pull.d.ts.map

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