@penvhq/launcher 0.14.0 → 0.16.0

package/dist/index.cjs

@@ -35,6 +35,7 @@ __export(src_exports, {
   DEV_PIN_VERSION: () => DEV_PIN_VERSION,
   DeclarationMissingError: () => DeclarationMissingError,
   DeclarationNotSelfContainedError: () => DeclarationNotSelfContainedError,
+  DeclarationReservedFieldError: () => DeclarationReservedFieldError,
   DownloadFailedError: () => DownloadFailedError,
   DownloadIntegrityError: () => DownloadIntegrityError,
   ENGINE_BIN: () => ENGINE_BIN,
@@ -87,13 +88,13 @@ __export(src_exports, {
   launcherUpdateCommand: () => launcherUpdateCommand,
   nodeSpawner: () => nodeSpawner,
   packumentUrl: () => packumentUrl,
+  readEnvironmentProviders: () => readEnvironmentProviders,
   readExtensionPackage: () => readExtensionPackage,
-  readProviderEntries: () => readProviderEntries,
   readTarball: () => readTarball,
   releaseEnginePin: () => releaseEnginePin,
   renderDeclaration: () => renderDeclaration,
   runLauncher: () => runLauncher,
-  setProviderType: () => setProviderType,
+  setEnvironmentProvider: () => setEnvironmentProvider,
   tarballUrl: () => tarballUrl,
   upgrade: () => upgrade,
   writeDeclaration: () => writeDeclaration
@@ -181,7 +182,7 @@ function readKey(source, index) {
   const match = /^[A-Za-z_$][A-Za-z0-9_$]*/.exec(source.slice(index));
   return match === null ? void 0 : { key: match[0], end: index + match[0].length };
 }
-function typeSlotIn(source, open, close) {
+function providerSlotIn(source, open, close) {
   let i = skipTrivia(source, open + 1);
   while (i < close - 1) {
     const key = readKey(source, i);
@@ -197,7 +198,7 @@ function typeSlotIn(source, open, close) {
     let valueEnd;
     if (QUOTES.has(ch)) {
       valueEnd = skipString(source, valueStart);
-      if (key.key === "type" && ch !== "`") {
+      if (key.key === "provider" && ch !== "`") {
         return {
           start: valueStart,
           end: valueEnd,
@@ -220,8 +221,33 @@ function typeSlotIn(source, open, close) {
   }
   return void 0;
 }
-function scan(source) {
-  const found = /(?:^|[\s{,;])providers\s*:\s*\{/.exec(source);
+function blankComments(source) {
+  let out = "";
+  let i = 0;
+  while (i < source.length) {
+    const ch = source.charAt(i);
+    if (QUOTES.has(ch)) {
+      const end = skipString(source, i);
+      out += source.slice(i, end);
+      i = end;
+      continue;
+    }
+    if (ch === "/" && (source.charAt(i + 1) === "/" || source.charAt(i + 1) === "*")) {
+      const line = source.charAt(i + 1) === "/";
+      const found = line ? source.indexOf("\n", i) : source.indexOf("*/", i + 2);
+      const end = found === -1 ? source.length : line ? found : found + 2;
+      out += source.slice(i, end).replace(/[^\n]/g, " ");
+      i = end;
+      continue;
+    }
+    out += ch;
+    i += 1;
+  }
+  return out;
+}
+function scan(raw) {
+  const source = blankComments(raw);
+  const found = /(?:^|[\s{,;])environments\s*:\s*\{/.exec(source);
   if (found === null) {
     return void 0;
   }
@@ -242,31 +268,42 @@ function scan(source) {
       return void 0;
     }
     const entryOpen = skipTrivia(source, colon + 1);
-    if (source.charAt(entryOpen) !== "{") {
-      return void 0;
-    }
-    const entryClose = matchBrace(source, entryOpen);
-    if (entryClose === -1) {
+    const ch = source.charAt(entryOpen);
+    let entryEnd;
+    let slot;
+    if (ch === "{") {
+      entryEnd = matchBrace(source, entryOpen);
+      if (entryEnd === -1) {
+        return void 0;
+      }
+      slot = providerSlotIn(source, entryOpen, entryEnd);
+    } else if (QUOTES.has(ch)) {
+      entryEnd = skipString(source, entryOpen);
+      slot = ch === "`" ? void 0 : {
+        start: entryOpen,
+        end: entryEnd,
+        value: source.slice(entryOpen + 1, entryEnd - 1)
+      };
+    } else {
       return void 0;
     }
-    const slot = typeSlotIn(source, entryOpen, entryClose);
-    entries.push({ environment: key.key, type: slot?.value, slot });
-    i = skipTrivia(source, entryClose);
+    entries.push({ environment: key.key, provider: slot?.value, slot });
+    i = skipTrivia(source, entryEnd);
     if (source.charAt(i) === ",") {
       i = skipTrivia(source, i + 1);
     }
   }
   return entries;
 }
-function readProviderEntries(source) {
-  return scan(source)?.map(({ environment, type }) => ({ environment, type }));
+function readEnvironmentProviders(source) {
+  return scan(source)?.map(({ environment, provider }) => ({ environment, provider }));
 }
-function setProviderType(source, environment, type) {
+function setEnvironmentProvider(source, environment, provider) {
   const entry = scan(source)?.find((candidate) => candidate.environment === environment);
   if (entry?.slot === void 0) {
     return void 0;
   }
-  return `${source.slice(0, entry.slot.start)}${JSON.stringify(type)}${source.slice(entry.slot.end)}`;
+  return `${source.slice(0, entry.slot.start)}${JSON.stringify(provider)}${source.slice(entry.slot.end)}`;
 }
 
 // src/declaration.ts
@@ -590,6 +627,26 @@ var DeclarationNotSelfContainedError = class extends import_core.PenvError {
     );
   }
 };
+var DeclarationReservedFieldError = class extends import_core.PenvError {
+  name = "DeclarationReservedFieldError";
+  constructor(name, file, field2) {
+    super(
+      "PENV_DECLARATION_RESERVED_FIELD",
+      `The declaration ${name} ships at \`${file}\` declares \`${field2}\`, which penv owns on every environment entry`,
+      `Report it to ${name}. penv reserves ${import_core.RESERVED_ENTRY_FIELDS.map((reserved) => `\`${reserved}\``).join(", ")} inside an \`environments\` entry, so a provider names its own fields in its own vocabulary \u2014 \`project\`, \`path\` \u2014 and leaves those four to penv.`
+    );
+  }
+};
+var DeclarationShapeUnreadableError = class extends import_core.PenvError {
+  name = "DeclarationShapeUnreadableError";
+  constructor(name, file, member) {
+    super(
+      "PENV_DECLARATION_SHAPE_UNREADABLE",
+      member === void 0 ? `The declaration ${name} ships at \`${file}\` has a \`ProviderConfigMap\` member penv cannot read` : `The declaration ${name} ships at \`${file}\` writes \`${member}\` as something other than an entry shape`,
+      `Report it to ${name}. Each \`ProviderConfigMap\` member is written as its own object literal \u2014 \`"@acme/provider-x": { readonly path: string }\` \u2014 so penv can check it names none of ${import_core.RESERVED_ENTRY_FIELDS.map((reserved) => `\`${reserved}\``).join(", ")}, which it owns on every environment entry.`
+    );
+  }
+};
 var EnginePinUnreleasedError = class extends import_core.PenvError {
   name = "EnginePinUnreleasedError";
   constructor() {
@@ -646,7 +703,7 @@ var UpgradeUnattendedError = class extends import_core.PenvError {
     super(
       "PENV_UPGRADE_UNATTENDED",
       `Upgrading rewrites ${import_core.MANIFEST_PATH} and package.json, and this run has nobody to decide that`,
-      `Run \`${UPGRADE_COMMAND} <version> ${YES_FLAG}\` \u2014 unattended, penv moves the pin only to a version you named. In CI, run \`${INSTALL_COMMAND}\`: it installs what the committed manifest already pins.`
+      `Run \`${UPGRADE_COMMAND} ${YES_FLAG}\` to take what \`latest\` points at, or \`${UPGRADE_COMMAND} <version> ${YES_FLAG}\` to name one. In CI, run \`${INSTALL_COMMAND}\`: it installs what the committed manifest already pins.`
     );
   }
 };
@@ -720,7 +777,7 @@ function openShape(name) {
 
 declare module "${AUGMENTATION_TARGET}" {
   interface ProviderConfigMap {
-    ${JSON.stringify(name)}: ProviderConfig & { readonly type: ${JSON.stringify(name)} };
+    ${JSON.stringify(name)}: ProviderConfig & { readonly provider: ${JSON.stringify(name)} };
   }
 }
 `;
@@ -738,12 +795,166 @@ function assertSelfContained(name, file, source) {
     }
   }
 }
+function endOfString(source, index) {
+  const quote = source.charAt(index);
+  let i = index + 1;
+  while (i < source.length) {
+    const ch = source.charAt(i);
+    if (ch === "\\") {
+      i += 2;
+      continue;
+    }
+    if (ch === quote) {
+      return i + 1;
+    }
+    i += 1;
+  }
+  return source.length;
+}
+function withoutComments(source) {
+  let out = "";
+  let i = 0;
+  while (i < source.length) {
+    const ch = source.charAt(i);
+    if (ch === '"' || ch === "'" || ch === "`") {
+      const end = endOfString(source, i);
+      out += source.slice(i, end);
+      i = end;
+      continue;
+    }
+    if (ch === "/" && (source.charAt(i + 1) === "/" || source.charAt(i + 1) === "*")) {
+      const line = source.charAt(i + 1) === "/";
+      const end = line ? source.indexOf("\n", i) : source.indexOf("*/", i + 2);
+      i = end === -1 ? source.length : line ? end : end + 2;
+      out += " ";
+      continue;
+    }
+    out += ch;
+    i += 1;
+  }
+  return out;
+}
+var RESERVED_FIELDS = [...import_core2.RESERVED_ENTRY_FIELDS].sort((a, b) => b.length - a.length);
+var RESERVED_MEMBER = new RegExp(
+  `(?:^|[\\s;{,])(?:readonly\\s+)?(["']?)(${RESERVED_FIELDS.join("|")})\\1\\s*\\??\\s*:`
+);
+function endOfBrace(code, open) {
+  let depth = 0;
+  let i = open;
+  while (i < code.length) {
+    const ch = code.charAt(i);
+    if (ch === '"' || ch === "'" || ch === "`") {
+      i = endOfString(code, i);
+      continue;
+    }
+    if (ch === "{" || ch === "[" || ch === "(") {
+      depth += 1;
+    } else if (ch === "}" || ch === "]" || ch === ")") {
+      depth -= 1;
+      if (depth === 0) {
+        return i + 1;
+      }
+    }
+    i += 1;
+  }
+  return -1;
+}
+function ownMembers(body) {
+  let members = "";
+  let depth = 0;
+  let i = 0;
+  while (i < body.length) {
+    const ch = body.charAt(i);
+    if (ch === '"' || ch === "'" || ch === "`") {
+      const end = endOfString(body, i);
+      if (depth === 0) {
+        members += body.slice(i, end);
+      }
+      i = end;
+      continue;
+    }
+    if (ch === "{" || ch === "[" || ch === "(") {
+      depth += 1;
+    } else if (ch === "}" || ch === "]" || ch === ")") {
+      depth -= 1;
+    } else if (depth === 0) {
+      members += ch;
+      i += 1;
+      continue;
+    }
+    if (depth <= 1) {
+      members += " ";
+    }
+    i += 1;
+  }
+  return members;
+}
+var MEMBER_NAME = /^(?:readonly\s+)?(?:(["'])([^"']*)\1|([A-Za-z_$][\w$]*))\s*\??\s*:/;
+function mapMembers(source) {
+  const code = withoutComments(source);
+  const map = /interface\s+ProviderConfigMap\s*\{/.exec(code);
+  if (map === null) {
+    return [];
+  }
+  const open = map.index + map[0].length - 1;
+  const close = endOfBrace(code, open);
+  if (close === -1) {
+    return { unreadable: void 0 };
+  }
+  const members = [];
+  let i = open + 1;
+  for (; ; ) {
+    while (/\s|;|,/.test(code.charAt(i))) {
+      i += 1;
+    }
+    if (i >= close - 1) {
+      return members;
+    }
+    const name = MEMBER_NAME.exec(code.slice(i, close - 1));
+    if (name === null) {
+      return { unreadable: void 0 };
+    }
+    let value = i + name[0].length;
+    while (/\s/.test(code.charAt(value))) {
+      value += 1;
+    }
+    const declared = name[2] ?? name[3] ?? "";
+    if (code.charAt(value) !== "{") {
+      return { unreadable: declared };
+    }
+    const end = endOfBrace(code, value);
+    if (end === -1) {
+      return { unreadable: declared };
+    }
+    members.push({ name: declared, body: code.slice(value + 1, end - 1) });
+    i = end;
+    while (/\s/.test(code.charAt(i))) {
+      i += 1;
+    }
+    if (i < close - 1 && code.charAt(i) !== ";" && code.charAt(i) !== ",") {
+      return { unreadable: declared };
+    }
+  }
+}
+function assertEntryShapesAreReadable(name, file, source) {
+  const members = mapMembers(source);
+  if (!Array.isArray(members)) {
+    throw new DeclarationShapeUnreadableError(name, file, members.unreadable);
+  }
+  for (const member of members) {
+    const field2 = RESERVED_MEMBER.exec(ownMembers(member.body))?.[2];
+    if (field2 !== void 0) {
+      throw new DeclarationReservedFieldError(name, file, field2);
+    }
+  }
+}
 function renderDeclaration(subject, shipped) {
   if (shipped === void 0) {
     return `${header(subject)}
 ${openShape(subject.name)}`;
   }
   assertSelfContained(subject.name, shipped.file, shipped.source);
+  assertEntryShapesAreReadable(subject.name, shipped.file, shipped.source);
   const body = shipped.source.replace(/^/, "").trimEnd();
   return `${header(subject)}
 ${body}
@@ -1240,30 +1451,33 @@ function chooseEnvironments(answer, offered) {
 function quoted(environments) {
   return environments.map((environment) => `\`${environment}\``).join(", ");
 }
+function blindAdvice(name) {
+  const spec = JSON.stringify(name);
+  return `Point an environment at ${name} in penv.config.ts: \`production: ${spec}\`, or \`production: { provider: ${spec} }\` plus the provider's own fields and a \`keySource\`.`;
+}
 function configAdvice(name, pointing, unpointed) {
-  const add2 = `Add \`type: ${JSON.stringify(name)}\``;
   if (pointing.length === 0) {
-    return `${add2} to an environment in penv.config.ts.`;
+    return blindAdvice(name);
   }
-  return `${quoted(pointing)} already ${pointing.length === 1 ? "points" : "point"} at ${name}. ${add2} to ${quoted(unpointed)} in penv.config.ts if ${unpointed.length === 1 ? "it" : "they"} should too.`;
+  return `${quoted(pointing)} already ${pointing.length === 1 ? "points" : "point"} at ${name}. Point ${quoted(unpointed)} at it in penv.config.ts if ${unpointed.length === 1 ? "it" : "they"} should too.`;
 }
 async function offerConfigEdit(options, name, ask) {
   const { io, root } = options;
   const configFile = (0, import_core5.findConfigFile)(root);
-  const blind = `Add \`type: ${JSON.stringify(name)}\` to an environment in penv.config.ts.`;
+  const blind = blindAdvice(name);
   if (configFile === void 0) {
     io.out(blind);
     return;
   }
   const shown = (0, import_node_path4.relative)(root, configFile).split(import_node_path4.sep).join("/");
   let current = (0, import_node_fs4.readFileSync)(configFile, "utf8");
-  const entries = readProviderEntries(current);
+  const entries = readEnvironmentProviders(current);
   if (entries === void 0 || entries.length === 0) {
     io.out(blind);
     return;
   }
-  const pointing = entries.filter((entry) => entry.type === name).map((entry) => entry.environment);
-  const offered = entries.filter((entry) => entry.type !== name).map((entry) => entry.environment);
+  const pointing = entries.filter((entry) => entry.provider === name).map((entry) => entry.environment);
+  const offered = entries.filter((entry) => entry.provider !== name).map((entry) => entry.environment);
   if (offered.length === 0) {
     return;
   }
@@ -1282,9 +1496,9 @@ async function offerConfigEdit(options, name, ask) {
     return;
   }
   for (const environment of chosen) {
-    const next = setProviderType(current, environment, name);
+    const next = setEnvironmentProvider(current, environment, name);
     if (next === void 0) {
-      io.out(`Add \`type: ${JSON.stringify(name)}\` to \`${environment}\` in ${shown}.`);
+      io.out(`Add \`provider: ${JSON.stringify(name)}\` to \`${environment}\` in ${shown}.`);
       continue;
     }
     current = next;
@@ -1618,8 +1832,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_core8.ENGINE_PACKAGE,
-  version: "0.14.0",
-  integrity: "sha512-2EJHq5DSuqyfscjhFZmaszT4dZdYfboJJzyFwTZkJPWdcVZmXODhsqF2xtG+9U/MYojo6rmQzVlHXhVQRnooXg=="
+  version: "0.16.0",
+  integrity: "sha512-DSA07wrSown70tU/9ix9yozJihsQjHFPN3/iXLiH6sS6LYT+/PWBFmVI6C2tH/qaUL2GGh4mgRHL8LGM749C8Q=="
 };
 function assertReleasePin(pin) {
   if (pin.integrity === DEV_PIN_INTEGRITY || pin.version === DEV_PIN_VERSION) {
@@ -1717,7 +1931,7 @@ async function upgrade(options) {
   if (options.noDownload === true) {
     throw new UpgradeNoDownloadError();
   }
-  if ((options.ci === true || !io.interactive) && !(request.yes && request.version !== void 0)) {
+  if ((options.ci === true || !io.interactive) && !request.yes) {
     throw new UpgradeUnattendedError();
   }
   const release = await fetchRelease({
@@ -2047,6 +2261,7 @@ async function delegate(options, engine, forwarded, home, cwd) {
   DEV_PIN_VERSION,
   DeclarationMissingError,
   DeclarationNotSelfContainedError,
+  DeclarationReservedFieldError,
   DownloadFailedError,
   DownloadIntegrityError,
   ENGINE_BIN,
@@ -2099,13 +2314,13 @@ async function delegate(options, engine, forwarded, home, cwd) {
   launcherUpdateCommand,
   nodeSpawner,
   packumentUrl,
+  readEnvironmentProviders,
   readExtensionPackage,
-  readProviderEntries,
   readTarball,
   releaseEnginePin,
   renderDeclaration,
   runLauncher,
-  setProviderType,
+  setEnvironmentProvider,
   tarballUrl,
   upgrade,
   writeDeclaration