@lynxship/cli 0.1.15 → 0.1.18

package/dist/index.js

@@ -3,6 +3,7 @@ import { access, mkdir, readFile, writeFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { createHash, randomBytes, randomUUID } from "node:crypto";
 import { basename, dirname, join, resolve } from "node:path";
+import { detectLynxFramework } from "./frameworks.js";
 import { BuildOrchestrator } from "@lynxship/build-orchestrator";
 import { JsonRepository } from "@lynxship/db";
 import { assert, createId, sha256, } from "@lynxship/contracts";
@@ -34,6 +35,7 @@ import { hasHarmonyHost, runRealHarmonyBuild } from "./harmony-build.js";
 import { hasWebConfiguration, runRealWebBuild } from "./web-build.js";
 import { hasDesktopHost, runRealDesktopBuild } from "./desktop-build.js";
 import { extractDevServerUrl, shouldPrintDevServerQr } from "./dev-qr.js";
+import { applyProjectPlugins, inspectProjectPlugins } from "./plugins.js";
 import { inspectDesktopTarget, inspectHarmonyTarget, inspectWebTarget, } from "./target-toolchain.js";
 const rawArgs = process.argv.slice(2);
 const args = [...rawArgs];
@@ -215,7 +217,20 @@ async function executeBuild(options, showResult = true) {
     // Host initialization can write lynxship.json (for example, the generated
     // iOS scheme). Always read it again before resolving the build profile so a
     // first build uses the host that was just created in the same invocation.
-    const effectiveConfig = wait && !local ? await loadConfig(root) : config;
+    const loadedConfig = wait && !local ? await loadConfig(root) : config;
+    const pluginApplication = wait && !local
+        ? await applyProjectPlugins(root, loadedConfig, { platform, profile })
+        : {
+            config: loadedConfig,
+            report: { configured: 0, plugins: [] },
+            applied: [],
+            templates: [],
+            cloud: [],
+            build: [],
+            changes: [],
+            autolink: [],
+        };
+    const effectiveConfig = pluginApplication.config;
     if (platform === "android" || platform === "ios")
         await requireAutolinkReady(root, platform);
     const runtime = await inspectRuntimeFingerprint(root, platform, effectiveConfig);
@@ -364,13 +379,14 @@ async function executeBuild(options, showResult = true) {
     }
     return result;
 }
-async function buildSharedLynxBundle() {
+async function buildSharedLynxBundle(miso) {
     const progress = ui.progress("Shared Lynx bundle");
     try {
         progress.update(undefined, "Building the shared Lynx bundle once for native targets…");
         await buildLynxBundle(root, {
             quiet: json,
             onOutput: (message) => progress.event(message),
+            miso,
         });
         progress.update(100, "Shared native Lynx bundle ready");
     }
@@ -416,6 +432,7 @@ function commandTitle(command) {
         devtool: "Lynx DevTool diagnostics",
         trace: "Lynx Trace diagnostics",
         recorder: "Lynx Recorder diagnostics",
+        plugin: "LynxShip plugins",
     }[command] ?? command);
 }
 function helpText() {
@@ -431,6 +448,10 @@ Commands:
   devtool doctor          Check Lynx DevTool integration and dev runtime
   trace doctor            Check Lynx Trace prerequisites
   recorder doctor         Check Lynx Recorder prerequisites
+  plugin list             List project plugins and their capabilities
+  plugin doctor            Validate plugin packages without modifying native files
+  plugin apply             Apply project plugin native changes for a platform
+  plugin apply --dry-run   Preview plugin native changes without writing files
   autolink check          Check Lynx native-library Autolink wiring
   autolink codegen        Run the project's Native Module codegen script
   ota doctor              Check native OTA host integration
@@ -515,6 +536,9 @@ Global options:
 Node support: Node 22/24 LTS or Node 26 Current. Use Node 24 LTS for production.`;
 }
 async function looksLikeLynxProject() {
+    const framework = await detectLynxFramework(root);
+    if (framework.framework !== "unknown")
+        return true;
     const configFiles = [
         "lynx.config.ts",
         "lynx.config.js",
@@ -900,6 +924,80 @@ async function main() {
         });
         return;
     }
+    if (command === "plugin") {
+        const subcommand = args.shift() ?? "list";
+        assert(["list", "doctor", "apply"].includes(subcommand), "CLI_PLUGIN_COMMAND", "Use \`lynxship plugin list\`, \`lynxship plugin doctor\` or \`lynxship plugin apply\`.");
+        await requireProjectRoot();
+        const config = await loadConfig(root);
+        const report = await inspectProjectPlugins(root, config);
+        if (subcommand === "apply") {
+            const platform = platformValue(flag("--platform", "android"));
+            const profile = flag("--profile", "production");
+            const dryRun = args.includes("--dry-run");
+            const result = await applyProjectPlugins(root, config, {
+                platform,
+                profile,
+                mode: dryRun ? "plan" : "apply",
+            });
+            printValue({
+                status: dryRun ? "planned" : "applied",
+                platform,
+                profile,
+                plugins: result.applied,
+                nativeChanges: result.changes.filter((change) => change.changed)
+                    .length,
+                changes: result.changes,
+                templates: result.templates,
+                cloud: result.cloud,
+                build: result.build,
+            }, {
+                title: `LynxShip plugins · ${platform}`,
+                rows: [
+                    {
+                        label: "Applied",
+                        value: result.applied.length ? result.applied.join(", ") : "none",
+                        valueColor: "green",
+                    },
+                    {
+                        label: "Native changes",
+                        value: String(result.changes.filter((change) => change.changed).length),
+                        valueColor: "blue",
+                    },
+                ],
+                done: dryRun
+                    ? "No native files were modified; review the planned changes."
+                    : "Project plugin changes are applied atomically and idempotently.",
+            });
+            return;
+        }
+        const invalid = report.plugins.filter((plugin) => plugin.status !== "ready");
+        printValue(report, {
+            title: `LynxShip plugins · ${subcommand}`,
+            rows: report.plugins.length > 0
+                ? report.plugins.map((plugin) => ({
+                    label: plugin.name,
+                    value: `${plugin.status} · ${plugin.capabilities.join(", ") || "no capabilities"} · ${plugin.reason}`,
+                    valueColor: plugin.status === "ready"
+                        ? "green"
+                        : plugin.status === "missing"
+                            ? "red"
+                            : "yellow",
+                }))
+                : [
+                    {
+                        label: "Plugins",
+                        value: "none configured",
+                        valueColor: "muted",
+                    },
+                ],
+            done: invalid.length === 0
+                ? "All project plugin manifests are valid."
+                : "Fix the invalid plugin package before building.",
+        });
+        if (subcommand === "doctor" && invalid.length > 0)
+            process.exitCode = 1;
+        return;
+    }
     if (command === "doctor") {
         const config = await loadConfig(root);
         const configuration = await readConfigurationStatus();
@@ -940,7 +1038,39 @@ async function main() {
         const nodeMajor = Number(process.versions.node.split(".")[0]);
         const nodeSupported = nodeMajor >= 22;
         const nodeRecommended = nodeMajor % 2 === 0;
+        const framework = await detectLynxFramework(root);
+        const pluginReport = await inspectProjectPlugins(root, config);
+        const invalidPlugins = pluginReport.plugins.filter((plugin) => plugin.status !== "ready");
         const checks = [
+            {
+                name: "lynx-framework",
+                ok: framework.framework !== "unknown",
+                status: framework.framework === "unknown"
+                    ? "warn"
+                    : framework.experimental
+                        ? "warn"
+                        : "pass",
+                value: framework.framework === "unknown"
+                    ? "unknown · verify the official Lynx/Rspeedy integration"
+                    : framework.label +
+                        " · " +
+                        framework.evidence +
+                        (framework.experimental ? " · early access" : ""),
+            },
+            ...(framework.framework === "miso"
+                ? [
+                    {
+                        name: "miso-nix",
+                        ok: commandExists("nix"),
+                        status: commandExists("nix")
+                            ? "pass"
+                            : "fail",
+                        value: commandExists("nix")
+                            ? "Nix detected"
+                            : "missing · fix: install Nix and rerun doctor",
+                    },
+                ]
+                : []),
             {
                 name: "node",
                 ok: nodeSupported,
@@ -967,6 +1097,16 @@ async function main() {
                 status: config.projectId ? "pass" : "fail",
                 value: config.projectId ? "found" : "missing · fix: lynxship init",
             },
+            {
+                name: "lynxship-plugins",
+                ok: invalidPlugins.length === 0,
+                status: invalidPlugins.length === 0 ? "pass" : "fail",
+                value: invalidPlugins.length === 0
+                    ? pluginReport.configured === 0
+                        ? "none configured"
+                        : `${pluginReport.configured} plugin(s) ready`
+                    : `${invalidPlugins.map((plugin) => plugin.name).join(", ")} · fix: lynxship plugin doctor`,
+            },
             {
                 name: "credential-store",
                 ok: true,
@@ -1719,7 +1859,7 @@ async function main() {
         return;
     }
     if (buildAll && wait && !local)
-        await buildSharedLynxBundle();
+        await buildSharedLynxBundle(resolveProfile(config, profile).miso);
     const progress = ui.progress("All Lynx targets build");
     const progressValues = {};
     const progressLabels = {};

package/dist/ios-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ios-build.d.ts","sourceRoot":"","sources":["../src/ios-build.ts"],"names":[],"mappings":"AAYA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAyHD;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB;AAoED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuD7B;AAgCD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GACL,OAAO,CAAC,IAAI,CAAC,CAcf;AAkND,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAcxE;AA+DD,wBAAsB,eAAe,CACnC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,QAAQ,CAAC,CAqNnB"}
+{"version":3,"file":"ios-build.d.ts","sourceRoot":"","sources":["../src/ios-build.ts"],"names":[],"mappings":"AAYA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAyHD;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB;AAoED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuD7B;AAgCD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GACL,OAAO,CAAC,IAAI,CAAC,CAcf;AAmND,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAcxE;AA+DD,wBAAsB,eAAe,CACnC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,QAAQ,CAAC,CAsNnB"}

package/dist/ios-build.js

@@ -264,6 +264,7 @@ async function runRealIosSimulatorBuild(job, options) {
             await buildLynxBundle(options.root, {
                 quiet: options.quiet,
                 onOutput: options.onEvent,
+                miso: options.profile.miso,
             });
         }
         if (ios.bundleScript) {
@@ -454,6 +455,7 @@ export async function runRealIosBuild(job, options) {
             await buildLynxBundle(options.root, {
                 quiet: options.quiet,
                 onOutput: options.onEvent,
+                miso: options.profile.miso,
             });
         }
         if (ios.bundleScript) {

package/dist/plugin-api.d.ts

@@ -0,0 +1,2 @@
+export * from "@lynxship/plugin-api";
+//# sourceMappingURL=plugin-api.d.ts.map

package/dist/plugin-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-api.d.ts","sourceRoot":"","sources":["../src/plugin-api.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/plugin-api.js

@@ -0,0 +1 @@
+export * from "@lynxship/plugin-api";

package/dist/plugins.d.ts

@@ -0,0 +1,35 @@
+import type { Platform } from "@lynxship/contracts";
+import { type BuildContribution, type CloudIntegrationContribution, type PluginCapability, type AutolinkContribution, type PluginPermission, type PluginPlanChange, type TemplateContribution } from "@lynxship/plugin-api";
+import type { LynxShipConfig } from "./config.js";
+export interface ProjectPluginInfo {
+    name: string;
+    version?: string;
+    packagePath?: string;
+    entry?: string;
+    apiVersion?: number;
+    capabilities: PluginCapability[];
+    permissions: PluginPermission[];
+    status: "ready" | "missing" | "invalid";
+    reason: string;
+}
+export interface PluginReport {
+    configured: number;
+    plugins: ProjectPluginInfo[];
+}
+export interface PluginApplication {
+    config: LynxShipConfig;
+    report: PluginReport;
+    applied: string[];
+    templates: TemplateContribution[];
+    cloud: CloudIntegrationContribution[];
+    build: BuildContribution[];
+    changes: PluginPlanChange[];
+    autolink: AutolinkContribution[];
+}
+export declare function inspectProjectPlugins(root: string, config: LynxShipConfig): Promise<PluginReport>;
+export declare function applyProjectPlugins(root: string, config: LynxShipConfig, target: {
+    platform: Platform;
+    profile: string;
+    mode?: "plan" | "apply";
+}): Promise<PluginApplication>;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EAKjC,KAAK,gBAAgB,EAErB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EAGrB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAclD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,KAAK,EAAE,4BAA4B,EAAE,CAAC;IACtC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAqUD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,YAAY,CAAC,CAQvB;AA+XD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACvE,OAAO,CAAC,iBAAiB,CAAC,CAqF5B"}