@lynxship/cli 0.1.20 → 0.1.21

package/dist/plugins.js

@@ -1,595 +1,2 @@
-import { createRequire } from "node:module";
-import { existsSync, readFileSync } from "node:fs";
-import { mkdir, readFile, rm, writeFile, } from "node:fs/promises";
-import { dirname, isAbsolute, join, relative, resolve } from "node:path";
-import { pathToFileURL } from "node:url";
-import { LYNXSHIP_PLUGIN_API_VERSION, } from "@lynxship/plugin-api";
-function pluginReference(reference) {
-    if (typeof reference === "string")
-        return { name: reference, options: {} };
-    return { name: reference[0], options: reference[1] };
-}
-function packageDirectory(entry) {
-    let current = dirname(entry);
-    while (true) {
-        if (existsSync(join(current, "package.json")))
-            return current;
-        const parent = dirname(current);
-        if (parent === current)
-            return dirname(entry);
-        current = parent;
-    }
-}
-function parsePackageJson(file) {
-    try {
-        return JSON.parse(readFileSync(file, "utf8"));
-    }
-    catch {
-        return {};
-    }
-}
-function packageJsonFromEntry(entry) {
-    return join(packageDirectory(entry), "package.json");
-}
-function findInstalledPackageJson(root, name) {
-    let current = root;
-    while (true) {
-        const candidate = join(current, "node_modules", ...name.split("/"), "package.json");
-        if (existsSync(candidate))
-            return candidate;
-        const parent = dirname(current);
-        if (parent === current)
-            return undefined;
-        current = parent;
-    }
-}
-function capabilities(value) {
-    if (!Array.isArray(value))
-        return [];
-    return value.filter((candidate) => ["config", "build", "native", "autolink", "template", "cloud"].includes(candidate));
-}
-const KNOWN_CAPABILITIES = [
-    "config",
-    "build",
-    "native",
-    "autolink",
-    "template",
-    "cloud",
-];
-const KNOWN_PERMISSIONS = [
-    "config:write",
-    "build:metadata",
-    "native:write",
-    "autolink:metadata",
-    "template:register",
-    "cloud:provider",
-];
-function isKnownList(value, allowed) {
-    return (Array.isArray(value) &&
-        value.every((candidate) => typeof candidate === "string" && allowed.includes(candidate)));
-}
-function permissions(value) {
-    if (!Array.isArray(value))
-        return [];
-    return value.filter((candidate) => [
-        "config:write",
-        "build:metadata",
-        "native:write",
-        "autolink:metadata",
-        "template:register",
-        "cloud:provider",
-    ].includes(candidate));
-}
-function validPluginDefinition(value) {
-    if (!value || typeof value !== "object")
-        return false;
-    const definition = value;
-    return (definition.apiVersion === LYNXSHIP_PLUGIN_API_VERSION &&
-        typeof definition.name === "string" &&
-        definition.name.length > 0 &&
-        isKnownList(definition.capabilities, KNOWN_CAPABILITIES) &&
-        isKnownList(definition.permissions, KNOWN_PERMISSIONS) &&
-        (definition.platforms === undefined ||
-            isKnownList(definition.platforms, [
-                "all",
-                "android",
-                "ios",
-                "harmonyos",
-                "web",
-                "desktop",
-            ])) &&
-        typeof definition.apply === "function");
-}
-function resolvePackageEntry(root, name) {
-    try {
-        const requireFromProject = createRequire(join(root, "package.json"));
-        let entry;
-        let packagePath;
-        try {
-            entry = requireFromProject.resolve(name);
-            packagePath = packageJsonFromEntry(entry);
-        }
-        catch {
-            packagePath = findInstalledPackageJson(root, name) ?? "";
-            if (!packagePath)
-                throw new Error("Cannot find module '" + name + "'");
-            entry = packagePath;
-        }
-        const packageJson = parsePackageJson(packagePath);
-        const plugin = packageJson.lynxship?.plugin;
-        if (typeof plugin !== "string" || !plugin)
-            return {
-                packagePath,
-                reason: `${name} does not declare package.json#lynxship.plugin`,
-            };
-        const packageRoot = dirname(packagePath);
-        const resolved = resolve(packageRoot, plugin);
-        const outside = relative(packageRoot, resolved).startsWith("..");
-        if (outside)
-            return {
-                packagePath,
-                reason: `${name} points its plugin entry outside the package`,
-            };
-        if (!existsSync(resolved))
-            return {
-                packagePath,
-                reason: `${name} plugin entry does not exist: ${plugin}`,
-            };
-        return { packagePath, entry: resolved };
-    }
-    catch (error) {
-        return {
-            reason: error instanceof Error
-                ? `Cannot resolve ${name}: ${error.message}`
-                : `Cannot resolve ${name}`,
-        };
-    }
-}
-async function resolvePlugin(root, reference, load = true) {
-    const requested = pluginReference(reference);
-    const resolved = resolvePackageEntry(root, requested.name);
-    if (!resolved.packagePath || !resolved.entry) {
-        return {
-            info: {
-                name: requested.name,
-                capabilities: [],
-                permissions: [],
-                status: "missing",
-                reason: resolved.reason ?? "Plugin package was not found",
-            },
-        };
-    }
-    const packageJson = parsePackageJson(resolved.packagePath);
-    const metadata = packageJson.lynxship;
-    const apiVersion = typeof metadata?.apiVersion === "number" ? metadata.apiVersion : undefined;
-    const packageCapabilities = capabilities(metadata?.capabilities);
-    const packagePermissions = permissions(metadata?.permissions);
-    if (!isKnownList(metadata?.capabilities, KNOWN_CAPABILITIES) ||
-        !isKnownList(metadata?.permissions, KNOWN_PERMISSIONS)) {
-        return {
-            info: {
-                name: requested.name,
-                version: typeof packageJson.version === "string"
-                    ? packageJson.version
-                    : undefined,
-                packagePath: resolved.packagePath,
-                entry: resolved.entry,
-                apiVersion,
-                capabilities: packageCapabilities,
-                permissions: packagePermissions,
-                status: "invalid",
-                reason: "Plugin package capabilities and permissions must be arrays of known values",
-            },
-        };
-    }
-    if (apiVersion !== LYNXSHIP_PLUGIN_API_VERSION) {
-        return {
-            info: {
-                name: requested.name,
-                version: typeof packageJson.version === "string"
-                    ? packageJson.version
-                    : undefined,
-                packagePath: resolved.packagePath,
-                entry: resolved.entry,
-                apiVersion,
-                capabilities: packageCapabilities,
-                permissions: packagePermissions,
-                status: "invalid",
-                reason: `Plugin API ${String(apiVersion ?? "missing")} is not supported; expected ${LYNXSHIP_PLUGIN_API_VERSION}`,
-            },
-        };
-    }
-    const info = {
-        name: requested.name,
-        version: typeof packageJson.version === "string" ? packageJson.version : undefined,
-        packagePath: resolved.packagePath,
-        entry: resolved.entry,
-        apiVersion,
-        capabilities: packageCapabilities,
-        permissions: packagePermissions,
-        status: "ready",
-        reason: "Plugin manifest is valid",
-    };
-    if (!load)
-        return { info };
-    try {
-        const module = (await import(pathToFileURL(resolved.entry).href));
-        const definition = module.default ?? module.plugin;
-        if (!validPluginDefinition(definition)) {
-            return {
-                info: {
-                    ...info,
-                    status: "invalid",
-                    reason: "Plugin entry must export a LynxShipPluginDefinition",
-                },
-            };
-        }
-        if (capabilities(definition.capabilities).join(",") !==
-            packageCapabilities.join(",") ||
-            permissions(definition.permissions).join(",") !==
-                packagePermissions.join(",")) {
-            return {
-                info: {
-                    ...info,
-                    status: "invalid",
-                    reason: "Plugin code capabilities/permissions do not match package.json",
-                },
-            };
-        }
-        if (definition.name !== requested.name &&
-            definition.name !== packageJson.name) {
-            return {
-                info: {
-                    ...info,
-                    status: "invalid",
-                    reason: `Plugin entry name '${definition.name}' does not match its package`,
-                },
-            };
-        }
-        return { info, definition };
-    }
-    catch (error) {
-        return {
-            info: {
-                ...info,
-                status: "invalid",
-                reason: error instanceof Error
-                    ? `Plugin entry failed to load: ${error.message}`
-                    : "Plugin entry failed to load",
-            },
-        };
-    }
-}
-function pluginReferences(config) {
-    const value = config.plugins;
-    if (!Array.isArray(value))
-        return [];
-    return value;
-}
-export async function inspectProjectPlugins(root, config) {
-    const references = pluginReferences(config);
-    const plugins = await Promise.all(references.map(async (reference) => (await resolvePlugin(root, reference, false)).info));
-    return { configured: references.length, plugins };
-}
-function appliesToPlatform(platforms, platform) {
-    return (!platforms ||
-        platforms.length === 0 ||
-        platforms.includes("all") ||
-        platforms.includes(platform));
-}
-function mergeJson(left, right) {
-    const result = { ...left };
-    for (const [key, value] of Object.entries(right)) {
-        const current = result[key];
-        if (current &&
-            typeof current === "object" &&
-            !Array.isArray(current) &&
-            value &&
-            typeof value === "object" &&
-            !Array.isArray(value)) {
-            result[key] = mergeJson(current, value);
-        }
-        else {
-            result[key] = value;
-        }
-    }
-    return result;
-}
-function safeProjectFile(root, file) {
-    if (isAbsolute(file))
-        throw new Error(`Plugin native file must be relative: ${file}`);
-    const target = resolve(root, file);
-    const projectRelative = relative(root, target);
-    if (!projectRelative ||
-        projectRelative.startsWith("..") ||
-        isAbsolute(projectRelative))
-        throw new Error(`Plugin native file escapes the project: ${file}`);
-    return target;
-}
-function permissionForContribution(contribution) {
-    const required = [];
-    if (contribution.config)
-        required.push("config:write");
-    if (contribution.build)
-        required.push("build:metadata");
-    if (contribution.native?.length)
-        required.push("native:write");
-    if (contribution.autolink)
-        required.push("autolink:metadata");
-    if (contribution.templates?.length)
-        required.push("template:register");
-    if (contribution.cloud?.length)
-        required.push("cloud:provider");
-    return required;
-}
-function capabilityForPermission(permission) {
-    return permission.split(":")[0];
-}
-function isJsonObject(value) {
-    return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-function assertPluginContribution(plugin, contribution) {
-    if (!isJsonObject(contribution))
-        throw new Error(`Plugin '${plugin.name}' returned an invalid contribution object`);
-    if (contribution.config !== undefined && !isJsonObject(contribution.config))
-        throw new Error(`Plugin '${plugin.name}' returned an invalid config contribution`);
-    if (contribution.native !== undefined && !Array.isArray(contribution.native))
-        throw new Error(`Plugin '${plugin.name}' returned an invalid native contribution`);
-    for (const operation of contribution.native ?? []) {
-        if (!isJsonObject(operation))
-            throw new Error(`Plugin '${plugin.name}' returned an invalid native operation`);
-        if (!["all", "android", "ios", "harmonyos", "web", "desktop"].includes(String(operation.platform)) ||
-            typeof operation.file !== "string" ||
-            operation.file.length === 0 ||
-            !["ensure-text", "append-text", "replace-text", "json-merge"].includes(String(operation.operation)))
-            throw new Error(`Plugin '${plugin.name}' returned an invalid native operation`);
-        if ((operation.operation === "ensure-text" ||
-            operation.operation === "append-text") &&
-            typeof operation.text !== "string")
-            throw new Error(`Plugin '${plugin.name}' returned an invalid text operation`);
-        if (operation.operation === "replace-text" &&
-            (typeof operation.from !== "string" || typeof operation.to !== "string"))
-            throw new Error(`Plugin '${plugin.name}' returned an invalid replacement operation`);
-        if (operation.operation === "json-merge" && !isJsonObject(operation.value))
-            throw new Error(`Plugin '${plugin.name}' returned an invalid JSON merge operation`);
-    }
-    if (contribution.autolink !== undefined) {
-        if (!isJsonObject(contribution.autolink))
-            throw new Error(`Plugin '${plugin.name}' returned an invalid Autolink contribution`);
-        for (const key of ["packageNames", "capabilities"]) {
-            const value = contribution.autolink[key];
-            if (value !== undefined &&
-                (!Array.isArray(value) ||
-                    !value.every((item) => typeof item === "string")))
-                throw new Error(`Plugin '${plugin.name}' returned invalid Autolink metadata`);
-        }
-    }
-    if (contribution.build !== undefined) {
-        if (!isJsonObject(contribution.build))
-            throw new Error(`Plugin '${plugin.name}' returned an invalid build contribution`);
-        for (const key of [
-            "requiredTools",
-            "artifactExtensions",
-            "notes",
-        ]) {
-            const value = contribution.build[key];
-            if (value !== undefined &&
-                (!Array.isArray(value) ||
-                    !value.every((item) => typeof item === "string")))
-                throw new Error(`Plugin '${plugin.name}' returned invalid build metadata`);
-        }
-    }
-    for (const template of Array.isArray(contribution.templates)
-        ? contribution.templates
-        : []) {
-        if (!isJsonObject(template) ||
-            typeof template.id !== "string" ||
-            typeof template.displayName !== "string" ||
-            typeof template.source !== "string")
-            throw new Error(`Plugin '${plugin.name}' returned an invalid template contribution`);
-    }
-    for (const integration of Array.isArray(contribution.cloud)
-        ? contribution.cloud
-        : []) {
-        if (!isJsonObject(integration) ||
-            typeof integration.id !== "string" ||
-            typeof integration.displayName !== "string" ||
-            !Array.isArray(integration.capabilities) ||
-            !integration.capabilities.every((item) => ["build", "artifacts", "updates", "submit"].includes(String(item))))
-            throw new Error(`Plugin '${plugin.name}' returned an invalid cloud contribution`);
-    }
-}
-function assertPluginPermissions(plugin, contribution) {
-    const missing = permissionForContribution(contribution).filter((permission) => !plugin.permissions.includes(permission));
-    const missingCapabilities = permissionForContribution(contribution)
-        .map(capabilityForPermission)
-        .filter((capability) => !plugin.capabilities.includes(capability));
-    if (missing.length)
-        throw new Error(`Plugin '${plugin.name}' returned contributions without declaring permission(s): ${missing.join(", ")}`);
-    if (missingCapabilities.length)
-        throw new Error(`Plugin '${plugin.name}' returned contributions without declaring capability(ies): ${[...new Set(missingCapabilities)].join(", ")}`);
-}
-async function mergeJsonFile(file, value) {
-    const current = JSON.parse(await readFile(file, "utf8"));
-    await writeFile(file, `${JSON.stringify(mergeJson(current, value), null, 2)}\n`);
-}
-async function inspectNativeOperation(root, owned, platform) {
-    const operation = owned.operation;
-    if (!appliesToPlatform([operation.platform], platform))
-        return undefined;
-    const file = safeProjectFile(root, operation.file);
-    const current = existsSync(file) ? await readFile(file, "utf8") : "";
-    let changed = false;
-    if (operation.operation === "json-merge") {
-        if (!existsSync(file))
-            throw new Error(`Plugin JSON target does not exist: ${operation.file}`);
-        const merged = `${JSON.stringify(mergeJson(JSON.parse(current), operation.value), null, 2)}\n`;
-        changed = merged !== current;
-    }
-    else if (operation.operation === "ensure-text") {
-        changed = !current.includes(operation.text);
-    }
-    else if (operation.operation === "append-text") {
-        changed = !current.includes(operation.text);
-    }
-    else if (operation.operation === "replace-text") {
-        if (!current.includes(operation.from))
-            throw new Error(`Plugin replacement target was not found in ${operation.file}`);
-        changed = current.replace(operation.from, operation.to) !== current;
-    }
-    return {
-        plugin: owned.plugin,
-        platform,
-        file: operation.file,
-        operation: operation.operation,
-        changed,
-    };
-}
-async function applyNativeOperation(root, operation, platform) {
-    if (!appliesToPlatform([operation.platform], platform))
-        return;
-    const file = safeProjectFile(root, operation.file);
-    await mkdir(dirname(file), { recursive: true });
-    if (operation.operation === "json-merge") {
-        if (!existsSync(file))
-            throw new Error(`Plugin JSON target does not exist: ${operation.file}`);
-        await mergeJsonFile(file, operation.value);
-        return;
-    }
-    const current = existsSync(file) ? await readFile(file, "utf8") : "";
-    if (operation.operation === "ensure-text") {
-        if (!current.includes(operation.text))
-            await writeFile(file, `${current}${current && !current.endsWith("\n") ? "\n" : ""}${operation.text}\n`);
-        return;
-    }
-    if (operation.operation === "append-text") {
-        if (current.includes(operation.text))
-            return;
-        await writeFile(file, `${current}${current && !current.endsWith("\n") ? "\n" : ""}${operation.text}\n`);
-        return;
-    }
-    if (operation.operation !== "replace-text")
-        return;
-    if (!current.includes(operation.from))
-        throw new Error(`Plugin replacement target was not found in ${operation.file}`);
-    await writeFile(file, current.replace(operation.from, operation.to));
-}
-function assertNativeConflicts(root, operations) {
-    const seen = new Map();
-    for (const owned of operations) {
-        const file = safeProjectFile(root, owned.operation.file);
-        const previous = seen.get(file);
-        if (!previous) {
-            seen.set(file, owned);
-            continue;
-        }
-        const currentOperation = owned.operation;
-        const previousOperation = previous.operation;
-        if (currentOperation.operation === "replace-text" &&
-            previousOperation.operation === "replace-text" &&
-            currentOperation.from === previousOperation.from)
-            throw new Error(`Conflicting or duplicate LynxShip plugins '${previous.plugin}' and '${owned.plugin}' both replace '${currentOperation.from}' in ${currentOperation.file}`);
-    }
-}
-async function applyNativeOperationsAtomically(root, operations, platform) {
-    assertNativeConflicts(root, operations);
-    const backups = new Map();
-    for (const owned of operations) {
-        if (!appliesToPlatform([owned.operation.platform], platform))
-            continue;
-        const file = safeProjectFile(root, owned.operation.file);
-        if (!backups.has(file))
-            backups.set(file, existsSync(file) ? await readFile(file, "utf8") : undefined);
-    }
-    try {
-        const changes = (await Promise.all(operations.map((operation) => inspectNativeOperation(root, operation, platform)))).filter((change) => Boolean(change));
-        for (const owned of operations)
-            await applyNativeOperation(root, owned.operation, platform);
-        return changes;
-    }
-    catch (error) {
-        for (const [file, content] of backups) {
-            if (content === undefined)
-                await rm(file, { force: true });
-            else {
-                await mkdir(dirname(file), { recursive: true });
-                await writeFile(file, content);
-            }
-        }
-        throw new Error(`${error instanceof Error ? error.message : String(error)}; native plugin changes were rolled back`);
-    }
-}
-export async function applyProjectPlugins(root, config, target) {
-    const references = pluginReferences(config);
-    const resolved = [];
-    for (const reference of references)
-        resolved.push(await resolvePlugin(root, reference));
-    const report = {
-        configured: references.length,
-        plugins: resolved.map((plugin) => plugin.info),
-    };
-    const invalid = report.plugins.find((plugin) => plugin.status !== "ready");
-    if (invalid)
-        throw new Error(`LynxShip plugin '${invalid.name}' is invalid: ${invalid.reason}`);
-    let effectiveConfig = JSON.parse(JSON.stringify(config));
-    const applied = [];
-    const templates = [];
-    const cloud = [];
-    const build = [];
-    const autolink = [];
-    const operations = [];
-    for (let index = 0; index < resolved.length; index += 1) {
-        const plugin = resolved[index];
-        const reference = references[index];
-        if (!plugin?.definition || !reference)
-            continue;
-        if (!appliesToPlatform(plugin.definition.platforms, target.platform))
-            continue;
-        const options = pluginReference(reference).options;
-        const context = {
-            rootDir: root,
-            platform: target.platform,
-            profile: target.profile,
-            mode: target.mode ?? "apply",
-            projectId: config.projectId,
-            config: effectiveConfig,
-            options,
-        };
-        const contribution = await plugin.definition.apply(context);
-        if (!contribution) {
-            applied.push(plugin.info.name);
-            continue;
-        }
-        assertPluginContribution(plugin.definition, contribution);
-        assertPluginPermissions(plugin.definition, contribution);
-        if (contribution.config)
-            effectiveConfig = mergeJson(effectiveConfig, contribution.config);
-        for (const operation of contribution.native ?? [])
-            operations.push({ plugin: plugin.info.name, operation });
-        if (contribution.autolink)
-            autolink.push(contribution.autolink);
-        templates.push(...(contribution.templates ?? []));
-        cloud.push(...(contribution.cloud ?? []));
-        if (contribution.build)
-            build.push(contribution.build);
-        applied.push(plugin.info.name);
-    }
-    let changes;
-    if (target.mode === "plan") {
-        assertNativeConflicts(root, operations);
-        changes = (await Promise.all(operations.map((operation) => inspectNativeOperation(root, operation, target.platform)))).filter((change) => Boolean(change));
-    }
-    else {
-        changes = await applyNativeOperationsAtomically(root, operations, target.platform);
-    }
-    return {
-        config: effectiveConfig,
-        report,
-        applied,
-        templates,
-        cloud,
-        build,
-        autolink,
-        changes,
-    };
-}
+export { inspectProjectPlugins } from "./plugins/discovery.js";
+export { applyProjectPlugins } from "./plugins/operations.js";

package/dist/process-runner.d.ts

@@ -18,6 +18,10 @@ export declare function packageManagerScriptCommand(root: string, script: string
     command: string;
     args: string[];
 };
+export declare function packageManagerInstallCommand(root: string, packages: readonly string[]): {
+    command: string;
+    args: string[];
+};
 export declare function runProcess(command: string, args: string[], options: ProcessOptions): Promise<void>;
 /**
  * Run a small probe without printing it as a build event. Non-zero exit codes

package/dist/process-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-runner.d.ts","sourceRoot":"","sources":["../src/process-runner.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAcA;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,EAAO,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAGrC;AAsBD,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,KAAK,CAAC,GAC3C,OAAO,CAAC,qBAAqB,CAAC,CAkChC;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA4BtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUtD"}
+{"version":3,"file":"process-runner.d.ts","sourceRoot":"","sources":["../src/process-runner.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAcA;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,EAAO,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAGrC;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAcrC;AAsBD,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,KAAK,CAAC,GAC3C,OAAO,CAAC,qBAAqB,CAAC,CAkChC;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA4BtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUtD"}

package/dist/process-runner.js

@@ -18,6 +18,20 @@ export function packageManagerScriptCommand(root, script, args = []) {
     const manager = packageManagerCommand(root);
     return { command: manager.command, args: ["run", script, ...args] };
 }
+export function packageManagerInstallCommand(root, packages) {
+    const manager = packageManagerCommand(root);
+    const normalized = manager.command
+        .split(/[\\/]/)
+        .at(-1)
+        ?.toLowerCase()
+        .replace(/\.(?:cmd|bat|exe)$/i, "");
+    const subcommand = normalized === "yarn" || normalized === "pnpm" ? "add" : "install";
+    const exactFlag = normalized === "yarn" ? "--exact" : "--save-exact";
+    return {
+        command: manager.command,
+        args: [subcommand, exactFlag, ...packages],
+    };
+}
 function detectPackageManager(root) {
     try {
         const packageJson = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));

package/dist/remote.d.ts

@@ -1,4 +1,4 @@
-import type { BuildJob, Platform } from "@lynxship/contracts";
+import type { BuildJob, BuildSourceReference, Platform } from "@lynxship/contracts";
 import type { LynxShipConfig } from "./config.js";
 export interface RemoteCliState {
     remoteOrganizationId?: string;
@@ -27,10 +27,31 @@ export interface OtaRollbackRequest {
     releaseId: string;
     reason: string;
 }
+export declare class RemoteApiError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(status: number, message: string, code?: string | undefined);
+}
+export interface RemoteBuildInput {
+    platform: Platform;
+    profile: string;
+    source: BuildSourceReference;
+    idempotencyKey?: string;
+}
 export declare function ensureRemoteTarget(config: LynxShipConfig, state: RemoteCliState): Promise<{
     organizationId: string;
     projectId: string;
 }>;
+export declare function uploadBuildSource(config: LynxShipConfig, state: RemoteCliState, bytes: Buffer): Promise<BuildSourceReference>;
+export declare function createRemoteBuild(config: LynxShipConfig, state: RemoteCliState, input: RemoteBuildInput): Promise<BuildJob>;
+export declare function getRemoteBuild(config: LynxShipConfig, id: string): Promise<BuildJob>;
+export declare function listRemoteBuilds(config: LynxShipConfig, state: RemoteCliState): Promise<BuildJob[]>;
+export declare function cancelRemoteBuild(config: LynxShipConfig, id: string): Promise<BuildJob>;
+export declare function retryRemoteBuild(config: LynxShipConfig, id: string): Promise<BuildJob>;
+export declare function waitForRemoteBuild(config: LynxShipConfig, id: string, options?: {
+    timeoutMs?: number;
+    pollMs?: number;
+}): Promise<BuildJob>;
 export declare function submitRealArtifact(config: LynxShipConfig, state: RemoteCliState, job: BuildJob, latest: boolean): Promise<unknown>;
 export declare function publishOtaRelease(config: LynxShipConfig, state: RemoteCliState, input: OtaPublishRequest): Promise<unknown>;
 export declare function rollbackOtaRelease(config: LynxShipConfig, state: RemoteCliState, input: OtaRollbackRequest): Promise<unknown>;