@penvhq/launcher 0.9.3 → 0.9.5

package/dist/bin.cjs

@@ -155,7 +155,38 @@ var AddFlagError = class extends import_core.PenvError {
     super(
       "PENV_ADD_FLAG",
       `\`penv add\` does not understand \`${flag}\``,
-      `Run \`penv add <package>\` with \`${TRUST_YOUNG_FLAG}\` or \`--registry <url>\` \u2014 those are the two it takes.`
+      `Run \`penv add <package>\` with \`${TRUST_YOUNG_FLAG}\`, \`--registry <url>\`, or \`${LOCAL_FLAG}\` \u2014 those are the three it takes.`
+    );
+  }
+};
+var LOCAL_FLAG = "--local";
+var AddLocalFlagError = class extends import_core.PenvError {
+  name = "AddLocalFlagError";
+  constructor(subject) {
+    super(
+      "PENV_ADD_LOCAL_FLAG",
+      `\`penv add ${LOCAL_FLAG}\` cannot take ${subject}`,
+      `${LOCAL_FLAG} adds the package this project already builds, so there is no release to name and nothing to pin. Publish it and run \`penv add <package>\` to pin one.`
+    );
+  }
+};
+var LocalExtensionUnresolvedError = class extends import_core.PenvError {
+  name = "LocalExtensionUnresolvedError";
+  constructor(name, root) {
+    super(
+      "PENV_LOCAL_EXTENSION_UNRESOLVED",
+      `${name} does not resolve from ${root}`,
+      `${LOCAL_FLAG} records that penv should read this package out of the project, so the project has to have it \u2014 add it as a dependency of the root (a workspace link is one), then run this again.`
+    );
+  }
+};
+var AddLocalInCiError = class extends import_core.PenvError {
+  name = "AddLocalInCiError";
+  constructor(name) {
+    super(
+      "PENV_ADD_LOCAL_IN_CI",
+      `Adding ${name} writes ${import_core.LOCAL_EXTENSIONS_PATH}, and CI does not decide what a project develops`,
+      `Run \`penv add ${LOCAL_FLAG} ${name}\` from a terminal and commit what it writes.`
     );
   }
 };
@@ -412,6 +443,7 @@ var import_core9 = require("@penvhq/core");
 
 // src/add.ts
 var import_node_fs5 = require("fs");
+var import_node_module2 = require("module");
 var import_node_path5 = require("path");
 var import_core6 = require("@penvhq/core");
 
@@ -594,14 +626,20 @@ function readExtensionPackage(dir) {
   try {
     parsed = JSON.parse((0, import_node_fs2.readFileSync)((0, import_node_path2.join)(dir, "package.json"), "utf8"));
   } catch {
-    return { types: void 0, onboard: void 0 };
+    return { name: void 0, version: void 0, types: void 0, onboard: void 0 };
   }
   const penv = field(parsed, "penv");
-  return { types: text(field(penv, "types")), onboard: text(field(penv, "onboard")) };
+  return {
+    name: text(field(parsed, "name")),
+    version: text(field(parsed, "version")),
+    types: text(field(penv, "types")),
+    onboard: text(field(penv, "onboard"))
+  };
 }
 function header(subject) {
-  const provenance = subject.attested ? "npm records a provenance attestation for it" : "npm records no provenance attestation for it";
-  return `// Written by \`penv add ${subject.name}\`, and committed.
+  const local = subject.local === true;
+  const provenance = local ? "resolved from this project, not from a published release" : subject.attested ? "npm records a provenance attestation for it" : "npm records no provenance attestation for it";
+  return `// Written by \`penv add ${local ? "--local " : ""}${subject.name}\`, and committed.
 // ${subject.name} ${subject.version} \u2014 ${provenance}.
 //
 // Types only: this declares the shape of the provider's \`penv.config.ts\`
@@ -994,8 +1032,13 @@ function parseRequest(argv) {
   let spec;
   let registry;
   let trustYoung = false;
+  let local = false;
   for (let index = 0; index < argv.length; index += 1) {
     const token = argv[index] ?? "";
+    if (token === LOCAL_FLAG) {
+      local = true;
+      continue;
+    }
     if (token === TRUST_YOUNG_FLAG) {
       trustYoung = true;
       continue;
@@ -1024,7 +1067,18 @@ function parseRequest(argv) {
   if (!PACKAGE_NAME.test(name) || version === "") {
     throw new AddPackageNameError(spec);
   }
-  return { name, version, registry, trustYoung };
+  if (local) {
+    if (version !== void 0) {
+      throw new AddLocalFlagError("a version");
+    }
+    if (registry !== void 0) {
+      throw new AddLocalFlagError(`\`${REGISTRY_FLAG}\``);
+    }
+    if (trustYoung) {
+      throw new AddLocalFlagError(`\`${TRUST_YOUNG_FLAG}\``);
+    }
+  }
+  return { name, version, registry, trustYoung, local };
 }
 function tierOf(request) {
   if (request.name.startsWith(import_core6.OFFICIAL_SCOPE)) {
@@ -1157,9 +1211,69 @@ async function offerOnboarding(io2, name, onboard) {
   io2.out(`Run \`${command}\` to finish setting ${name} up.`);
   return void 0;
 }
+function resolvePackageDir(name, root) {
+  const require2 = (0, import_node_module2.createRequire)((0, import_node_path5.resolve)(root, "noop.js"));
+  try {
+    return (0, import_node_path5.dirname)(require2.resolve(`${name}/package.json`));
+  } catch {
+    let dir;
+    try {
+      dir = (0, import_node_path5.dirname)(require2.resolve(name));
+    } catch {
+      return void 0;
+    }
+    for (let current = dir, parent = (0, import_node_path5.dirname)(dir); current !== parent; parent = (0, import_node_path5.dirname)(current)) {
+      if (readExtensionPackage(current).name === name) {
+        return current;
+      }
+      current = parent;
+    }
+    return void 0;
+  }
+}
+function recordLocalExtension(root, name) {
+  const file = (0, import_core6.localExtensionsFile)(root);
+  let current;
+  try {
+    current = (0, import_node_fs5.readFileSync)(file, "utf8");
+  } catch {
+    current = "[]";
+  }
+  (0, import_node_fs5.mkdirSync)((0, import_node_path5.dirname)(file), { recursive: true });
+  (0, import_node_fs5.writeFileSync)(file, (0, import_core6.serializeLocalExtensions)([...(0, import_core6.parseLocalExtensions)(current), name]));
+}
+async function addLocal(options, request) {
+  const { io: io2, root } = options;
+  if (options.ci === true) {
+    throw new AddLocalInCiError(request.name);
+  }
+  const dir = resolvePackageDir(request.name, root);
+  if (dir === void 0) {
+    throw new LocalExtensionUnresolvedError(request.name, root);
+  }
+  const installed = readExtensionPackage(dir);
+  const declaration = writeDeclaration({
+    root,
+    dir,
+    name: request.name,
+    version: installed.version ?? "unpublished",
+    attested: false,
+    local: true,
+    types: installed.types
+  });
+  recordLocalExtension(root, request.name);
+  io2.out(`\u2713 ${request.name} resolves from this project \u2014 nothing is pinned`);
+  io2.out(`\u2713 ${import_core6.LOCAL_EXTENSIONS_PATH} records it`);
+  io2.out(`\u2713 ${declaration} declares its config type`);
+  await offerConfigEdit(options, request.name);
+  return { onboard: await offerOnboarding(io2, request.name, installed.onboard) };
+}
 async function add(options) {
   const { io: io2, fetcher, home, root, manifestFile } = options;
   const request = parseRequest(options.argv);
+  if (request.local) {
+    return addLocal(options, request);
+  }
   const tier = tierOf(request);
   const now = (options.now ?? (() => /* @__PURE__ */ new Date()))();
   if (options.noDownload === true) {
@@ -1217,8 +1331,8 @@ var DEV_PIN_INTEGRITY = "sha512-development-build-not-a-published-release";
 var DEV_PIN_VERSION = "0.0.0-dev";
 var BUNDLED_ENGINE_PIN = {
   package: import_core7.ENGINE_PACKAGE,
-  version: "0.9.3",
-  integrity: "sha512-9ZPRFCovPXXFYxT7SWJth8IX1Rgu/FXl8+60Pn8MBu5UYG4m4l0fBi1aFwnxVVcriAnFmxNtNG4hwn1a1IliWw=="
+  version: "0.9.5",
+  integrity: "sha512-cacsvynscs6G0NThpGaK1BfKy3POQSoogI/vvQNZ5sTZaftzwg4mPtUpT+i2GSc3KbYAHQu4Kq9MpYLOvSvulA=="
 };
 function assertReleasePin(pin) {
   if (pin.integrity === DEV_PIN_INTEGRITY || pin.version === DEV_PIN_VERSION) {
@@ -1358,7 +1472,7 @@ async function launch(options) {
       return delegate(options, options.bundledEngine(), forwarded, home, cwd);
     }
     if (ADOPTS.has(first)) {
-      return adopt(options, forwarded, home, cwd);
+      return adopt(options, forwarded, home, cwd, noDownload);
     }
     throw new NoProjectError(cwd);
   }
@@ -1382,7 +1496,7 @@ async function launch(options) {
   const engine = engineAt(engineDir, enginePin.name, enginePin.version);
   return delegate(options, engine, forwarded, home, cwd);
 }
-async function adopt(options, forwarded, home, cwd) {
+async function adopt(options, forwarded, home, cwd, noDownload) {
   const engine = options.bundledEngine();
   const code = await delegate(options, engine, forwarded, home, cwd);
   if (code !== 0) {
@@ -1402,8 +1516,26 @@ async function adopt(options, forwarded, home, cwd) {
     (0, import_core9.serializeManifest)({ format: import_core9.MANIFEST_FORMAT, engine: pin, extensions: {} })
   );
   options.io.out(`\u2713 ${import_core9.MANIFEST_PATH} pins ${pin.package} ${pin.version}`);
+  await ensureAdoptedEngine(
+    options,
+    { name: pin.package, version: pin.version, integrity: pin.integrity },
+    home,
+    noDownload
+  );
   return 0;
 }
+async function ensureAdoptedEngine(options, pin, home, noDownload) {
+  try {
+    await ensure(options, "engines", pin, home, noDownload);
+  } catch (error) {
+    if (!(error instanceof PackageMissingError || error instanceof InstallDeclinedError)) {
+      report(error, options.io);
+    }
+    options.io.out(
+      `\u2192 Run \`${INSTALL_COMMAND}\` to install ${pin.name} ${pin.version} before your first \`penv run\`.`
+    );
+  }
+}
 async function ensure(options, kind, pin, home, noDownload) {
   const { io: io2, env, fetcher } = options;
   const { dir, state } = inspectInstall(home, kind, pin);