@optimizely/ocp-cli-v2 2.0.0-beta.1

package/dist/lib/Moria.d.ts

@@ -0,0 +1,51 @@
+import { Rivendell } from './Rivendell';
+export declare namespace Moria {
+    interface LogEntryContext {
+        appId?: string;
+        appVersion?: string;
+        trackerId?: string;
+        installId?: string;
+        entryPoint?: string;
+        requestId?: string;
+        jobId?: string;
+        buildId?: string;
+    }
+    interface LoggingSearchCriteria {
+        context: LogEntryContext;
+        start?: number;
+        end?: number;
+        audience?: Audience;
+        level?: LogLevel;
+        pageSize?: number;
+        cursor?: string;
+        terms?: string[];
+    }
+    interface LoggingSearchResult {
+        cursor: string;
+        entries: LogEntry[];
+    }
+    interface LogEntry {
+        id: string;
+        level: LogLevel;
+        time: number;
+        message: string;
+        context: LogEntryContext;
+        audience: Audience;
+    }
+    enum Audience {
+        USER = "USER",
+        DEVELOPER = "DEVELOPER",
+        ZAIUS = "ZAIUS"
+    }
+    enum LogLevel {
+        INFO = "INFO",
+        DEBUG = "DEBUG",
+        WARN = "WARN",
+        ERROR = "ERROR"
+    }
+    /**
+     * Search for LogEntries using the supplied criteria.
+     * @param criteria
+     */
+    function searchLogging(criteria: LoggingSearchCriteria, shard: Rivendell.Shard): Promise<LoggingSearchResult>;
+}

package/dist/lib/Moria.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Moria = void 0;
+const MoriaApi_1 = require("./MoriaApi");
+var Moria;
+(function (Moria) {
+    let Audience;
+    (function (Audience) {
+        Audience["USER"] = "USER";
+        Audience["DEVELOPER"] = "DEVELOPER";
+        Audience["ZAIUS"] = "ZAIUS";
+    })(Audience = Moria.Audience || (Moria.Audience = {}));
+    let LogLevel;
+    (function (LogLevel) {
+        LogLevel["INFO"] = "INFO";
+        LogLevel["DEBUG"] = "DEBUG";
+        LogLevel["WARN"] = "WARN";
+        LogLevel["ERROR"] = "ERROR";
+    })(LogLevel = Moria.LogLevel || (Moria.LogLevel = {}));
+    /**
+     * Search for LogEntries using the supplied criteria.
+     * @param criteria
+     */
+    async function searchLogging(criteria, shard) {
+        const response = await MoriaApi_1.MoriaApi.post(shard, 'logging/search', criteria);
+        return response.body;
+    }
+    Moria.searchLogging = searchLogging;
+})(Moria = exports.Moria || (exports.Moria = {}));
+//# sourceMappingURL=Moria.js.map

package/dist/lib/Moria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Moria.js","sourceRoot":"","sources":["../../src/lib/Moria.ts"],"names":[],"mappings":";;;AAAA,yCAAoC;AAGpC,IAAiB,KAAK,CA8DrB;AA9DD,WAAiB,KAAK;IAsCpB,IAAY,QAIX;IAJD,WAAY,QAAQ;QAClB,yBAAa,CAAA;QACb,mCAAuB,CAAA;QACvB,2BAAe,CAAA;IACjB,CAAC,EAJW,QAAQ,GAAR,cAAQ,KAAR,cAAQ,QAInB;IAED,IAAY,QAKX;IALD,WAAY,QAAQ;QAClB,yBAAa,CAAA;QACb,2BAAe,CAAA;QACf,yBAAa,CAAA;QACb,2BAAe,CAAA;IACjB,CAAC,EALW,QAAQ,GAAR,cAAQ,KAAR,cAAQ,QAKnB;IAED;;;OAGG;IACI,KAAK,UAAU,aAAa,CACjC,QAA+B,EAC/B,KAAsB;QAEtB,MAAM,QAAQ,GAAG,MAAM,mBAAQ,CAAC,IAAI,CAAsB,KAAK,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAC7F,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IANqB,mBAAa,gBAMlC,CAAA;AACH,CAAC,EA9DgB,KAAK,GAAL,aAAK,KAAL,aAAK,QA8DrB"}

package/dist/lib/MoriaApi.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="node" />
+import { Rivendell } from './Rivendell';
+export type Method = 'POST' | 'PUT' | 'PATCH' | 'GET' | 'DELETE';
+/**
+ * Low level http handler for interacting with the Moria api.
+ */
+export declare namespace MoriaApi {
+    interface ApiResponse<T = any> {
+        response: Response;
+        body: T;
+    }
+    export class ApiError extends Error {
+        responseText: string;
+        response?: Response | undefined;
+        constructor(message: string, responseText: string, response?: Response | undefined);
+    }
+    export function get<T>(shard: Rivendell.Shard, uri: string): Promise<ApiResponse<T>>;
+    export function post<T>(shard: Rivendell.Shard, uri: string, body: any): Promise<ApiResponse<T>>;
+    export function put<T>(shard: Rivendell.Shard, uri: string, body: any): Promise<ApiResponse<T>>;
+    export function request<T>(shard: Rivendell.Shard, method: Method, uri: string, body?: any): Promise<ApiResponse<T>>;
+    export {};
+}

package/dist/lib/MoriaApi.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoriaApi = void 0;
+const Rivendell_1 = require("./Rivendell");
+/**
+ * Low level http handler for interacting with the Moria api.
+ */
+var MoriaApi;
+(function (MoriaApi) {
+    class ApiError extends Error {
+        constructor(message, responseText, response) {
+            super(message);
+            this.responseText = responseText;
+            this.response = response;
+        }
+    }
+    MoriaApi.ApiError = ApiError;
+    async function get(shard, uri) {
+        return request(shard, 'GET', uri);
+    }
+    MoriaApi.get = get;
+    async function post(shard, uri, body) {
+        return request(shard, 'POST', uri, body);
+    }
+    MoriaApi.post = post;
+    async function put(shard, uri, body) {
+        return request(shard, 'PUT', uri, body);
+    }
+    MoriaApi.put = put;
+    async function request(shard, method, uri, body) {
+        const url = `${shard.url}/${uri}`;
+        const requestPayload = { method };
+        requestPayload.headers = {
+            'Authorization': `Bearer ${await Rivendell_1.Rivendell.jwt(shard.id)}`
+        };
+        if (body && method !== 'GET') {
+            // @ts-ignore
+            requestPayload.headers['content-type'] = 'application/json';
+            requestPayload.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, requestPayload);
+        const responseText = await response.text();
+        if (response.status < 200 || response.status >= 300) {
+            const errorMsg = `Received a ${response.status} from OCP: ${getErrorMessage(response.status)}`;
+            throw new ApiError(errorMsg, responseText, response);
+        }
+        return {
+            response,
+            body: responseText ? JSON.parse(responseText) : ''
+        };
+    }
+    MoriaApi.request = request;
+    function getErrorMessage(code) {
+        switch (code) {
+            case 400:
+                return 'Bad request.';
+            case 403:
+                return 'Access denied.';
+            case 404:
+                return 'Not found.';
+            case 500:
+                return 'Internal service error.';
+            case 502:
+                return 'Bad gateway';
+            case 503:
+                return 'Service unavailable. Please try again.';
+            case 504:
+                return 'Request timed out. Please try again.';
+            default:
+                return 'Unhandled error.';
+        }
+    }
+})(MoriaApi = exports.MoriaApi || (exports.MoriaApi = {}));
+//# sourceMappingURL=MoriaApi.js.map

package/dist/lib/MoriaApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MoriaApi.js","sourceRoot":"","sources":["../../src/lib/MoriaApi.ts"],"names":[],"mappings":";;;AAAA,2CAAsC;AAItC;;GAEG;AACH,IAAiB,QAAQ,CA6ExB;AA7ED,WAAiB,QAAQ;IAOvB,MAAa,QAAS,SAAQ,KAAK;QACjC,YAAY,OAAe,EAAS,YAAoB,EAAS,QAAmB;YAClF,KAAK,CAAC,OAAO,CAAC,CAAC;YADmB,iBAAY,GAAZ,YAAY,CAAQ;YAAS,aAAQ,GAAR,QAAQ,CAAW;QAEpF,CAAC;KACF;IAJY,iBAAQ,WAIpB,CAAA;IAEM,KAAK,UAAU,GAAG,CAAI,KAAsB,EAAE,GAAW;QAC9D,OAAO,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IAFqB,YAAG,MAExB,CAAA;IAEM,KAAK,UAAU,IAAI,CAAI,KAAsB,EAAE,GAAW,EAAE,IAAS;QAC1E,OAAO,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAFqB,aAAI,OAEzB,CAAA;IAEM,KAAK,UAAU,GAAG,CAAI,KAAsB,EAAE,GAAW,EAAE,IAAS;QACzE,OAAO,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAFqB,YAAG,MAExB,CAAA;IAEM,KAAK,UAAU,OAAO,CAC3B,KAAsB,EACtB,MAAc,EACd,GAAW,EACX,IAAU;QAEV,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;QAClC,MAAM,cAAc,GAAgB,EAAE,MAAM,EAAE,CAAC;QAE/C,cAAc,CAAC,OAAO,GAAG;YACvB,eAAe,EAAE,UAAU,MAAM,qBAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE;SAC3D,CAAC;QACF,IAAI,IAAI,IAAI,MAAM,KAAK,KAAK,EAAE;YAC5B,aAAa;YACb,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;YAC5D,cAAc,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;SAC5C;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAClD,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE3C,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE;YACnD,MAAM,QAAQ,GAAG,cAAc,QAAQ,CAAC,MAAM,cAAc,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/F,MAAM,IAAI,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;SACtD;QAED,OAAO;YACL,QAAQ;YACR,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE;SACnD,CAAC;IACJ,CAAC;IA9BqB,gBAAO,UA8B5B,CAAA;IAED,SAAS,eAAe,CAAC,IAAY;QACnC,QAAQ,IAAI,EAAE;YACZ,KAAK,GAAG;gBACN,OAAO,cAAc,CAAC;YACxB,KAAK,GAAG;gBACN,OAAO,gBAAgB,CAAC;YAC1B,KAAK,GAAG;gBACN,OAAO,YAAY,CAAC;YACtB,KAAK,GAAG;gBACN,OAAO,yBAAyB,CAAC;YACnC,KAAK,GAAG;gBACN,OAAO,aAAa,CAAC;YACvB,KAAK,GAAG;gBACN,OAAO,wCAAwC,CAAC;YAClD,KAAK,GAAG;gBACN,OAAO,sCAAsC,CAAC;YAChD;gBACE,OAAO,kBAAkB,CAAC;SAC7B;IACH,CAAC;AACH,CAAC,EA7EgB,QAAQ,GAAR,gBAAQ,KAAR,gBAAQ,QA6ExB"}

package/dist/lib/NodeBuildPipeline.d.ts

@@ -0,0 +1,25 @@
+import { BuildOptions, BuildPipeline } from './BuildPipeline';
+/**
+ * Build pipeline for Node.js/TypeScript projects.
+ */
+export declare class NodeBuildPipeline extends BuildPipeline {
+    private packageJson;
+    private pm;
+    constructor(projectRoot: string, runtime: string, options?: BuildOptions);
+    /**
+     * Install dependencies using the detected package manager.
+     */
+    installDependencies(): Promise<void>;
+    /**
+     * Run validation process
+     */
+    validate(): Promise<void>;
+    /**
+     * Check if a script exists in package.json
+     */
+    private hasScript;
+    /**
+     * Run a package.json script
+     */
+    private runScript;
+}

package/dist/lib/NodeBuildPipeline.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeBuildPipeline = void 0;
+const child_process_1 = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const BuildPipeline_1 = require("./BuildPipeline");
+const PackageManager_1 = require("./PackageManager");
+/**
+ * Build pipeline for Node.js/TypeScript projects.
+ */
+class NodeBuildPipeline extends BuildPipeline_1.BuildPipeline {
+    constructor(projectRoot, runtime, options = {}) {
+        super(projectRoot, options);
+        this.packageJson = JSON.parse(fs.readFileSync(path.join(this.projectRoot, 'package.json'), 'utf-8'));
+        this.pm = PackageManager_1.PackageManagerFactory.detectOrThrow(this.projectRoot, runtime);
+    }
+    /**
+     * Install dependencies using the detected package manager.
+     */
+    async installDependencies() {
+        this.log(`Installing dependencies with ${this.pm.displayName}...`);
+        (0, child_process_1.execSync)(this.pm.installCommand(), {
+            cwd: this.projectRoot,
+            stdio: 'inherit',
+        });
+        this.log('Dependencies installed');
+    }
+    /**
+     * Run validation process
+     */
+    async validate() {
+        await this.installDependencies();
+        if (this.hasScript('validate')) {
+            this.runScript('validate');
+        }
+        else {
+            this.log('No validate script found, please add a `validate` script to your package.json.');
+        }
+    }
+    /**
+     * Check if a script exists in package.json
+     */
+    hasScript(scriptName) {
+        var _a;
+        return !!((_a = this.packageJson.scripts) === null || _a === void 0 ? void 0 : _a[scriptName]);
+    }
+    /**
+     * Run a package.json script
+     */
+    runScript(scriptName) {
+        this.log(`Running ${scriptName} script...`);
+        (0, child_process_1.execSync)(this.pm.runDirectCommand(scriptName, { silent: this.silent }), {
+            cwd: this.projectRoot,
+            stdio: 'inherit',
+        });
+    }
+}
+exports.NodeBuildPipeline = NodeBuildPipeline;
+//# sourceMappingURL=NodeBuildPipeline.js.map

package/dist/lib/NodeBuildPipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeBuildPipeline.js","sourceRoot":"","sources":["../../src/lib/NodeBuildPipeline.ts"],"names":[],"mappings":";;;AAAA,iDAAyC;AACzC,yBAAyB;AACzB,6BAA6B;AAC7B,mDAA8D;AAC9D,qDAAyE;AAEzE;;GAEG;AACH,MAAa,iBAAkB,SAAQ,6BAAa;IAIlD,YAAY,WAAmB,EAAE,OAAe,EAAE,UAAwB,EAAE;QAC1E,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAC3B,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CACtE,CAAC;QACF,IAAI,CAAC,EAAE,GAAG,sCAAqB,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,mBAAmB;QAC9B,IAAI,CAAC,GAAG,CAAC,gCAAgC,IAAI,CAAC,EAAE,CAAC,WAAW,KAAK,CAAC,CAAC;QACnE,IAAA,wBAAQ,EAAC,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE;YACjC,GAAG,EAAE,IAAI,CAAC,WAAW;YACrB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ;QACnB,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE;YAC9B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;SAC5B;aAAM;YACL,IAAI,CAAC,GAAG,CAAC,gFAAgF,CAAC,CAAC;SAC5F;IACH,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,UAAkB;;QAClC,OAAO,CAAC,CAAC,CAAA,MAAA,IAAI,CAAC,WAAW,CAAC,OAAO,0CAAG,UAAU,CAAC,CAAA,CAAC;IAClD,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,UAAkB;QAClC,IAAI,CAAC,GAAG,CAAC,WAAW,UAAU,YAAY,CAAC,CAAC;QAC5C,IAAA,wBAAQ,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;YACtE,GAAG,EAAE,IAAI,CAAC,WAAW;YACrB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;CACF;AArDD,8CAqDC"}

package/dist/lib/PackageManager.d.ts

@@ -0,0 +1,242 @@
+export type PackageManagerType = 'yarn' | 'yarn-berry' | 'npm' | 'pnpm' | 'bun';
+export interface ListOptions {
+    prod?: boolean;
+    pattern?: string;
+    silent?: boolean;
+}
+export interface ParsedDependencies {
+    [name: string]: string;
+}
+/**
+ * Abstract base class for package managers.
+ */
+export declare abstract class PackageManager {
+    protected abstract readonly type: PackageManagerType;
+    /**
+     * Initialize a new project directory before install.
+     * Override in subclasses that need special initialization (e.g., Yarn Berry).
+     * @param projectDir The absolute path to the project directory
+     */
+    initProject(_projectDir: string): void;
+    /**
+     * Get the install command (no arguments).
+     */
+    abstract installCommand(): string;
+    /**
+     * Get the command to add production dependencies.
+     */
+    abstract addCommand(packages: string[]): string;
+    /**
+     * Get the command to add dev dependencies.
+     */
+    abstract addDevCommand(packages: string[]): string;
+    /**
+     * Get the command to run a script.
+     */
+    abstract runCommand(script: string, options?: {
+        silent?: boolean;
+    }): string;
+    /**
+     * Get the command to run a script directly (without 'run' keyword where possible).
+     */
+    abstract runDirectCommand(script: string, options?: {
+        silent?: boolean;
+    }): string;
+    /**
+     * Get the command to list dependencies.
+     */
+    abstract listCommand(options?: ListOptions): string;
+    /**
+     * Whether this package manager supports pattern filtering in list command.
+     */
+    abstract supportsPatternFiltering(): boolean;
+    /**
+     * Parse the output of listCommand into a dependencies object.
+     * @param stdout The stdout from running listCommand
+     * @param filterPrefix Optional prefix to filter package names (e.g., '@zaiusinc/')
+     */
+    abstract parseListOutput(stdout: string, filterPrefix?: string): ParsedDependencies;
+    /**
+     * Check if the list output contains any packages matching the given prefix.
+     * @param stdout The stdout from running listCommand
+     * @param prefix The prefix to check for (e.g., '@zaius/')
+     */
+    abstract hasPackagesWithPrefix(stdout: string, prefix: string): boolean;
+    /**
+     * Get the executable name for spawning.
+     */
+    get executable(): string;
+    /**
+     * Get display name for user-facing messages.
+     */
+    get displayName(): string;
+    /**
+     * Get the version of the package manager.
+     */
+    getVersion(): string;
+    /**
+     * Get the packageManager field value for package.json.
+     * Returns standard Corepack format: "name@version" (e.g., "yarn@4.12.0")
+     * This format is understood by Corepack for npm, yarn, and pnpm.
+     * For bun, the builder will need to handle installation manually.
+     */
+    getPackageManagerField(): string;
+}
+/**
+ * Yarn package manager implementation.
+ */
+export declare class YarnPackageManager extends PackageManager {
+    readonly type: PackageManagerType;
+    /**
+     * Initialize a Yarn project by creating an empty yarn.lock file.
+     * This is necessary when the user has Yarn Berry installed globally,
+     * as Berry requires a lockfile to identify standalone projects.
+     * Harmless for Yarn Classic (it will overwrite with its format).
+     */
+    initProject(projectDir: string): void;
+    installCommand(): string;
+    addCommand(packages: string[]): string;
+    addDevCommand(packages: string[]): string;
+    runCommand(script: string, options?: {
+        silent?: boolean;
+    }): string;
+    runDirectCommand(script: string, options?: {
+        silent?: boolean;
+    }): string;
+    listCommand(options?: ListOptions): string;
+    supportsPatternFiltering(): boolean;
+    parseListOutput(stdout: string, _filterPrefix?: string): ParsedDependencies;
+    hasPackagesWithPrefix(stdout: string, _prefix: string): boolean;
+}
+/**
+ * Yarn Berry (2+/3+/4+) package manager implementation.
+ * Handles differences from Yarn Classic.
+ */
+export declare class YarnBerryPackageManager extends PackageManager {
+    readonly type: PackageManagerType;
+    /**
+     * Initialize a Yarn Berry project by creating an empty yarn.lock file.
+     * This marks the directory as a standalone project, preventing Yarn Berry
+     * from trying to treat it as a workspace of a parent project.
+     */
+    initProject(projectDir: string): void;
+    installCommand(): string;
+    addCommand(packages: string[]): string;
+    addDevCommand(packages: string[]): string;
+    runCommand(script: string, _options?: {
+        silent?: boolean;
+    }): string;
+    runDirectCommand(script: string, _options?: {
+        silent?: boolean;
+    }): string;
+    listCommand(_options?: ListOptions): string;
+    supportsPatternFiltering(): boolean;
+    parseListOutput(stdout: string, filterPrefix?: string): ParsedDependencies;
+    hasPackagesWithPrefix(stdout: string, prefix: string): boolean;
+    get executable(): string;
+    get displayName(): string;
+}
+/**
+ * npm package manager implementation.
+ */
+export declare class NpmPackageManager extends PackageManager {
+    protected readonly type: PackageManagerType;
+    installCommand(): string;
+    addCommand(packages: string[]): string;
+    addDevCommand(packages: string[]): string;
+    runCommand(script: string, options?: {
+        silent?: boolean;
+    }): string;
+    runDirectCommand(script: string, options?: {
+        silent?: boolean;
+    }): string;
+    listCommand(options?: ListOptions): string;
+    supportsPatternFiltering(): boolean;
+    parseListOutput(stdout: string, filterPrefix?: string): ParsedDependencies;
+    hasPackagesWithPrefix(stdout: string, prefix: string): boolean;
+}
+/**
+ * pnpm package manager implementation.
+ */
+export declare class PnpmPackageManager extends PackageManager {
+    protected readonly type: PackageManagerType;
+    installCommand(): string;
+    addCommand(packages: string[]): string;
+    addDevCommand(packages: string[]): string;
+    runCommand(script: string, options?: {
+        silent?: boolean;
+    }): string;
+    runDirectCommand(script: string, options?: {
+        silent?: boolean;
+    }): string;
+    listCommand(options?: ListOptions): string;
+    supportsPatternFiltering(): boolean;
+    parseListOutput(stdout: string, _filterPrefix?: string): ParsedDependencies;
+    hasPackagesWithPrefix(stdout: string, _prefix: string): boolean;
+}
+/**
+ * Bun package manager implementation.
+ * Note: Uses npm list for listing since bun pm ls doesn't support JSON output.
+ */
+export declare class BunPackageManager extends PackageManager {
+    protected readonly type: PackageManagerType;
+    installCommand(): string;
+    addCommand(packages: string[]): string;
+    addDevCommand(packages: string[]): string;
+    runCommand(script: string, _options?: {
+        silent?: boolean;
+    }): string;
+    runDirectCommand(script: string, _options?: {
+        silent?: boolean;
+    }): string;
+    listCommand(options?: ListOptions): string;
+    supportsPatternFiltering(): boolean;
+    parseListOutput(stdout: string, filterPrefix?: string): ParsedDependencies;
+    hasPackagesWithPrefix(stdout: string, prefix: string): boolean;
+}
+/**
+ * Factory for creating and detecting package managers.
+ */
+export declare class PackageManagerFactory {
+    /**
+     * Detect package manager from lock files in the given directory.
+     * Returns null if no lock file is found.
+     * @param cwd The directory to search for lock files
+     * @param runtime Runtime string (e.g., "node22", "node18_rt") for validation
+     * @throws Error if package manager is not supported for the given runtime
+     */
+    static detect(cwd: string, runtime: string): PackageManager | null;
+    /**
+     * Detect package manager or throw an error if none found.
+     * @param cwd The directory to search for lock files
+     * @param runtime Runtime string (e.g., "node22", "node18_rt") for validation
+     */
+    static detectOrThrow(cwd: string, runtime: string): PackageManager;
+    /**
+     * Create a PackageManager instance from a type string.
+     */
+    static create(type: PackageManagerType): PackageManager;
+    private static readonly implementations;
+    /**
+     * Validate that the package manager is supported for the given runtime.
+     * For runtimes < node22, only yarn classic is supported.
+     * @throws Error if package manager is not supported for the runtime
+     */
+    private static validateRuntimeSupport;
+    /**
+     * Extract the Node version number from runtime string.
+     * @example "node22" -> 22, "node18_rt" -> 18
+     */
+    private static getRuntimeVersion;
+    /**
+     * Check if the yarn version in use is Berry (2+).
+     */
+    private static isYarnBerry;
+}
+/**
+ * Package managers available for new project initialization.
+ * Note: 'yarn-berry' is excluded because the user's global yarn version
+ * determines whether Classic or Berry is used. Berry projects are detected
+ * via .yarnrc.yml for existing projects.
+ */
+export declare const PACKAGE_MANAGERS: PackageManagerType[];