@penvhq/launcher 0.14.0 → 0.16.0

package/dist/index.d.cts

@@ -92,19 +92,22 @@ declare function add(options: AddOptions): Promise<AddResult>;
  * The file is the user's, so it is scanned rather than parsed and re-emitted:
  * reformatting someone's config — dropping its comments, resorting its keys — to
  * change one string is not the edit that was offered. The scanner understands
- * exactly one thing, the `providers` block, and answers "I do not know this
+ * exactly one thing, the `environments` block, and answers "I do not know this
  * file" for anything else rather than guessing at a rewrite.
+ *
+ * An entry comes in two shapes and both are repointable: the bare package string
+ * is replaced whole, and the object form has its `provider` string replaced.
  */
-/** One environment's entry in the `providers` block. */
-interface ProviderEntry {
+/** One environment's declared provider, as the `environments` block writes it. */
+interface EnvironmentProvider {
     readonly environment: string;
-    /** The package it names today, when the entry declares a `type` string. */
-    readonly type: string | undefined;
+    /** The package it names today — the shorthand string, or the entry's `provider`. */
+    readonly provider: string | undefined;
 }
-/** Every environment the `providers` block names, in the order the file declares them. */
-declare function readProviderEntries(source: string): ProviderEntry[] | undefined;
-/** The same text with one environment pointed at `type`, or `undefined` if it cannot be. */
-declare function setProviderType(source: string, environment: string, type: string): string | undefined;
+/** Every environment the `environments` block names, in the order the file declares them. */
+declare function readEnvironmentProviders(source: string): EnvironmentProvider[] | undefined;
+/** The same text with one environment pointed at `provider`, or `undefined` if it cannot be. */
+declare function setEnvironmentProvider(source: string, environment: string, provider: string): string | undefined;
 
 /**
  * The committed, type-only declaration an added extension contributes.
@@ -117,7 +120,12 @@ declare function setProviderType(source: string, environment: string, type: stri
  *
  * A package points at that declaration with `penv.types` in its `package.json`;
  * one that ships none gets the open base shape under its own name, which is
- * still enough for the `type` field to be checked against something real.
+ * still enough for the `provider` field to be checked against something real.
+ *
+ * This is also where core's reserved entry fields are enforced. A declaration is
+ * the only way a provider's shape enters the system, so refusing one here makes a
+ * collision with `provider` or `keySource` impossible by construction rather than
+ * a check every config load pays for.
  */
 /** What an extension's `package.json` tells `add`, and nothing more. */
 interface ExtensionPackage {
@@ -405,6 +413,17 @@ declare class DeclarationNotSelfContainedError extends PenvError {
     readonly name = "DeclarationNotSelfContainedError";
     constructor(name: string, file: string, specifier: string);
 }
+/**
+ * The declaration a package ships names a field core owns on every entry.
+ *
+ * An environment entry carries the provider's own vocabulary beside core's four
+ * names, so a shape declaring one of them would shadow what penv writes there —
+ * the discriminant, or the key that seals the environment.
+ */
+declare class DeclarationReservedFieldError extends PenvError {
+    readonly name = "DeclarationReservedFieldError";
+    constructor(name: string, file: string, field: string);
+}
 /** A launcher built from source, asked to record which bytes it just ran. */
 declare class EnginePinUnreleasedError extends PenvError {
     readonly name = "EnginePinUnreleasedError";
@@ -433,10 +452,11 @@ declare class UpgradeNoDownloadError extends PenvError {
 /**
  * `penv upgrade` on a machine with nobody at it.
  *
- * Unattended, penv will move the pin only to a version somebody named and only
- * with the flag that says they meant it: what upgrade rewrites is two committed
- * files, and a pipeline that picks the engine is a pipeline choosing which bytes
- * the project runs.
+ * What upgrade rewrites is two committed files, so unattended it needs the flag
+ * that says somebody meant it. The version stays optional there, exactly as it is
+ * interactively: absent means `latest`, the same default `penv add` takes. A
+ * pipeline that wants today's pin rather than today's `latest` runs
+ * `penv install`, which is what the remedy names.
  */
 declare class UpgradeUnattendedError extends PenvError {
     readonly name = "UpgradeUnattendedError";
@@ -731,4 +751,4 @@ interface UpgradeOptions {
 }
 declare function upgrade(options: UpgradeOptions): Promise<void>;
 
-export { AddFlagError, AddLocalFlagError, AddLocalInCiError, AddNoDownloadError, type AddOptions, AddPackageNameError, AddRegistryError, type AddResult, AddSubjectError, AddTrustUnattendedError, ArchiveError, type ArchiveSubject, BUNDLED_ENGINE_PIN, DEFAULT_REGISTRY, DEV_PIN_INTEGRITY, DEV_PIN_VERSION, DeclarationMissingError, DeclarationNotSelfContainedError, type DeclarationSubject, type Delegation, DownloadFailedError, DownloadIntegrityError, ENGINE_BIN, type Engine, EngineEntryError, EnginePinMismatchError, EnginePinUnreleasedError, ExtensionNotImportableError, type ExtensionPackage, ExtensionUnloadableError, type Fetcher, HOME_META_FILE, INSTALL_COMMAND, INTEGRITY_FILE, InstallDeclinedError, type InstallOptions, type InstallState, type Installation, LOCAL_FLAG, type LauncherIo, type LauncherOptions, LocalExtensionUnresolvedError, MIN_PACKAGE_AGE_DAYS, NPM_UPDATE_COMMAND, NoProjectError, OfficialRegistryError, PackageCorruptError, PackageMissingError, PackageTooYoungError, PackageUnknownError, type Pin, type Project, type ProviderEntry, RegistryUnreadableError, type Release, ReleaseIncompleteError, type ReleaseQuery, type Spawner, TRUST_YOUNG_FLAG, type TarEntry, TrustDeclinedError, TrustPublisherMissingError, TrustReasonMissingError, UPGRADE_COMMAND, UpgradeDeclinedError, UpgradeFlagError, UpgradeInstallFailedError, UpgradeNoDownloadError, type UpgradeOptions, UpgradeSubjectError, UpgradeUnattendedError, VersionUnknownError, YES_FLAG, add, assertReleasePin, bundledEngine, declarationPath, engineAt, fetchRelease, findAdoptedRoot, findProject, httpFetcher, inspectInstall, installPin, integrityOf, launcherUpdateCommand, nodeSpawner, packumentUrl, readExtensionPackage, readProviderEntries, readTarball, releaseEnginePin, renderDeclaration, runLauncher, setProviderType, tarballUrl, upgrade, writeDeclaration };
+export { AddFlagError, AddLocalFlagError, AddLocalInCiError, AddNoDownloadError, type AddOptions, AddPackageNameError, AddRegistryError, type AddResult, AddSubjectError, AddTrustUnattendedError, ArchiveError, type ArchiveSubject, BUNDLED_ENGINE_PIN, DEFAULT_REGISTRY, DEV_PIN_INTEGRITY, DEV_PIN_VERSION, DeclarationMissingError, DeclarationNotSelfContainedError, DeclarationReservedFieldError, type DeclarationSubject, type Delegation, DownloadFailedError, DownloadIntegrityError, ENGINE_BIN, type Engine, EngineEntryError, EnginePinMismatchError, EnginePinUnreleasedError, type EnvironmentProvider, ExtensionNotImportableError, type ExtensionPackage, ExtensionUnloadableError, type Fetcher, HOME_META_FILE, INSTALL_COMMAND, INTEGRITY_FILE, InstallDeclinedError, type InstallOptions, type InstallState, type Installation, LOCAL_FLAG, type LauncherIo, type LauncherOptions, LocalExtensionUnresolvedError, MIN_PACKAGE_AGE_DAYS, NPM_UPDATE_COMMAND, NoProjectError, OfficialRegistryError, PackageCorruptError, PackageMissingError, PackageTooYoungError, PackageUnknownError, type Pin, type Project, RegistryUnreadableError, type Release, ReleaseIncompleteError, type ReleaseQuery, type Spawner, TRUST_YOUNG_FLAG, type TarEntry, TrustDeclinedError, TrustPublisherMissingError, TrustReasonMissingError, UPGRADE_COMMAND, UpgradeDeclinedError, UpgradeFlagError, UpgradeInstallFailedError, UpgradeNoDownloadError, type UpgradeOptions, UpgradeSubjectError, UpgradeUnattendedError, VersionUnknownError, YES_FLAG, add, assertReleasePin, bundledEngine, declarationPath, engineAt, fetchRelease, findAdoptedRoot, findProject, httpFetcher, inspectInstall, installPin, integrityOf, launcherUpdateCommand, nodeSpawner, packumentUrl, readEnvironmentProviders, readExtensionPackage, readTarball, releaseEnginePin, renderDeclaration, runLauncher, setEnvironmentProvider, tarballUrl, upgrade, writeDeclaration };

package/dist/index.d.ts

@@ -92,19 +92,22 @@ declare function add(options: AddOptions): Promise<AddResult>;
  * The file is the user's, so it is scanned rather than parsed and re-emitted:
  * reformatting someone's config — dropping its comments, resorting its keys — to
  * change one string is not the edit that was offered. The scanner understands
- * exactly one thing, the `providers` block, and answers "I do not know this
+ * exactly one thing, the `environments` block, and answers "I do not know this
  * file" for anything else rather than guessing at a rewrite.
+ *
+ * An entry comes in two shapes and both are repointable: the bare package string
+ * is replaced whole, and the object form has its `provider` string replaced.
  */
-/** One environment's entry in the `providers` block. */
-interface ProviderEntry {
+/** One environment's declared provider, as the `environments` block writes it. */
+interface EnvironmentProvider {
     readonly environment: string;
-    /** The package it names today, when the entry declares a `type` string. */
-    readonly type: string | undefined;
+    /** The package it names today — the shorthand string, or the entry's `provider`. */
+    readonly provider: string | undefined;
 }
-/** Every environment the `providers` block names, in the order the file declares them. */
-declare function readProviderEntries(source: string): ProviderEntry[] | undefined;
-/** The same text with one environment pointed at `type`, or `undefined` if it cannot be. */
-declare function setProviderType(source: string, environment: string, type: string): string | undefined;
+/** Every environment the `environments` block names, in the order the file declares them. */
+declare function readEnvironmentProviders(source: string): EnvironmentProvider[] | undefined;
+/** The same text with one environment pointed at `provider`, or `undefined` if it cannot be. */
+declare function setEnvironmentProvider(source: string, environment: string, provider: string): string | undefined;
 
 /**
  * The committed, type-only declaration an added extension contributes.
@@ -117,7 +120,12 @@ declare function setProviderType(source: string, environment: string, type: stri
  *
  * A package points at that declaration with `penv.types` in its `package.json`;
  * one that ships none gets the open base shape under its own name, which is
- * still enough for the `type` field to be checked against something real.
+ * still enough for the `provider` field to be checked against something real.
+ *
+ * This is also where core's reserved entry fields are enforced. A declaration is
+ * the only way a provider's shape enters the system, so refusing one here makes a
+ * collision with `provider` or `keySource` impossible by construction rather than
+ * a check every config load pays for.
  */
 /** What an extension's `package.json` tells `add`, and nothing more. */
 interface ExtensionPackage {
@@ -405,6 +413,17 @@ declare class DeclarationNotSelfContainedError extends PenvError {
     readonly name = "DeclarationNotSelfContainedError";
     constructor(name: string, file: string, specifier: string);
 }
+/**
+ * The declaration a package ships names a field core owns on every entry.
+ *
+ * An environment entry carries the provider's own vocabulary beside core's four
+ * names, so a shape declaring one of them would shadow what penv writes there —
+ * the discriminant, or the key that seals the environment.
+ */
+declare class DeclarationReservedFieldError extends PenvError {
+    readonly name = "DeclarationReservedFieldError";
+    constructor(name: string, file: string, field: string);
+}
 /** A launcher built from source, asked to record which bytes it just ran. */
 declare class EnginePinUnreleasedError extends PenvError {
     readonly name = "EnginePinUnreleasedError";
@@ -433,10 +452,11 @@ declare class UpgradeNoDownloadError extends PenvError {
 /**
  * `penv upgrade` on a machine with nobody at it.
  *
- * Unattended, penv will move the pin only to a version somebody named and only
- * with the flag that says they meant it: what upgrade rewrites is two committed
- * files, and a pipeline that picks the engine is a pipeline choosing which bytes
- * the project runs.
+ * What upgrade rewrites is two committed files, so unattended it needs the flag
+ * that says somebody meant it. The version stays optional there, exactly as it is
+ * interactively: absent means `latest`, the same default `penv add` takes. A
+ * pipeline that wants today's pin rather than today's `latest` runs
+ * `penv install`, which is what the remedy names.
  */
 declare class UpgradeUnattendedError extends PenvError {
     readonly name = "UpgradeUnattendedError";
@@ -731,4 +751,4 @@ interface UpgradeOptions {
 }
 declare function upgrade(options: UpgradeOptions): Promise<void>;
 
-export { AddFlagError, AddLocalFlagError, AddLocalInCiError, AddNoDownloadError, type AddOptions, AddPackageNameError, AddRegistryError, type AddResult, AddSubjectError, AddTrustUnattendedError, ArchiveError, type ArchiveSubject, BUNDLED_ENGINE_PIN, DEFAULT_REGISTRY, DEV_PIN_INTEGRITY, DEV_PIN_VERSION, DeclarationMissingError, DeclarationNotSelfContainedError, type DeclarationSubject, type Delegation, DownloadFailedError, DownloadIntegrityError, ENGINE_BIN, type Engine, EngineEntryError, EnginePinMismatchError, EnginePinUnreleasedError, ExtensionNotImportableError, type ExtensionPackage, ExtensionUnloadableError, type Fetcher, HOME_META_FILE, INSTALL_COMMAND, INTEGRITY_FILE, InstallDeclinedError, type InstallOptions, type InstallState, type Installation, LOCAL_FLAG, type LauncherIo, type LauncherOptions, LocalExtensionUnresolvedError, MIN_PACKAGE_AGE_DAYS, NPM_UPDATE_COMMAND, NoProjectError, OfficialRegistryError, PackageCorruptError, PackageMissingError, PackageTooYoungError, PackageUnknownError, type Pin, type Project, type ProviderEntry, RegistryUnreadableError, type Release, ReleaseIncompleteError, type ReleaseQuery, type Spawner, TRUST_YOUNG_FLAG, type TarEntry, TrustDeclinedError, TrustPublisherMissingError, TrustReasonMissingError, UPGRADE_COMMAND, UpgradeDeclinedError, UpgradeFlagError, UpgradeInstallFailedError, UpgradeNoDownloadError, type UpgradeOptions, UpgradeSubjectError, UpgradeUnattendedError, VersionUnknownError, YES_FLAG, add, assertReleasePin, bundledEngine, declarationPath, engineAt, fetchRelease, findAdoptedRoot, findProject, httpFetcher, inspectInstall, installPin, integrityOf, launcherUpdateCommand, nodeSpawner, packumentUrl, readExtensionPackage, readProviderEntries, readTarball, releaseEnginePin, renderDeclaration, runLauncher, setProviderType, tarballUrl, upgrade, writeDeclaration };
+export { AddFlagError, AddLocalFlagError, AddLocalInCiError, AddNoDownloadError, type AddOptions, AddPackageNameError, AddRegistryError, type AddResult, AddSubjectError, AddTrustUnattendedError, ArchiveError, type ArchiveSubject, BUNDLED_ENGINE_PIN, DEFAULT_REGISTRY, DEV_PIN_INTEGRITY, DEV_PIN_VERSION, DeclarationMissingError, DeclarationNotSelfContainedError, DeclarationReservedFieldError, type DeclarationSubject, type Delegation, DownloadFailedError, DownloadIntegrityError, ENGINE_BIN, type Engine, EngineEntryError, EnginePinMismatchError, EnginePinUnreleasedError, type EnvironmentProvider, ExtensionNotImportableError, type ExtensionPackage, ExtensionUnloadableError, type Fetcher, HOME_META_FILE, INSTALL_COMMAND, INTEGRITY_FILE, InstallDeclinedError, type InstallOptions, type InstallState, type Installation, LOCAL_FLAG, type LauncherIo, type LauncherOptions, LocalExtensionUnresolvedError, MIN_PACKAGE_AGE_DAYS, NPM_UPDATE_COMMAND, NoProjectError, OfficialRegistryError, PackageCorruptError, PackageMissingError, PackageTooYoungError, PackageUnknownError, type Pin, type Project, RegistryUnreadableError, type Release, ReleaseIncompleteError, type ReleaseQuery, type Spawner, TRUST_YOUNG_FLAG, type TarEntry, TrustDeclinedError, TrustPublisherMissingError, TrustReasonMissingError, UPGRADE_COMMAND, UpgradeDeclinedError, UpgradeFlagError, UpgradeInstallFailedError, UpgradeNoDownloadError, type UpgradeOptions, UpgradeSubjectError, UpgradeUnattendedError, VersionUnknownError, YES_FLAG, add, assertReleasePin, bundledEngine, declarationPath, engineAt, fetchRelease, findAdoptedRoot, findProject, httpFetcher, inspectInstall, installPin, integrityOf, launcherUpdateCommand, nodeSpawner, packumentUrl, readEnvironmentProviders, readExtensionPackage, readTarball, releaseEnginePin, renderDeclaration, runLauncher, setEnvironmentProvider, tarballUrl, upgrade, writeDeclaration };

package/dist/index.js

@@ -14,6 +14,7 @@ import {
   DEV_PIN_VERSION,
   DeclarationMissingError,
   DeclarationNotSelfContainedError,
+  DeclarationReservedFieldError,
   DownloadFailedError,
   DownloadIntegrityError,
   ENGINE_BIN,
@@ -66,17 +67,17 @@ import {
   launcherUpdateCommand,
   nodeSpawner,
   packumentUrl,
+  readEnvironmentProviders,
   readExtensionPackage,
-  readProviderEntries,
   readTarball,
   releaseEnginePin,
   renderDeclaration,
   runLauncher,
-  setProviderType,
+  setEnvironmentProvider,
   tarballUrl,
   upgrade,
   writeDeclaration
-} from "./chunk-WA5LM767.js";
+} from "./chunk-HQTTS5BH.js";
 export {
   AddFlagError,
   AddLocalFlagError,
@@ -93,6 +94,7 @@ export {
   DEV_PIN_VERSION,
   DeclarationMissingError,
   DeclarationNotSelfContainedError,
+  DeclarationReservedFieldError,
   DownloadFailedError,
   DownloadIntegrityError,
   ENGINE_BIN,
@@ -145,13 +147,13 @@ export {
   launcherUpdateCommand,
   nodeSpawner,
   packumentUrl,
+  readEnvironmentProviders,
   readExtensionPackage,
-  readProviderEntries,
   readTarball,
   releaseEnginePin,
   renderDeclaration,
   runLauncher,
-  setProviderType,
+  setEnvironmentProvider,
   tarballUrl,
   upgrade,
   writeDeclaration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@penvhq/launcher",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "The stable penv launcher: it verifies the engine your project pins and hands over the command.",
   "license": "MIT",
   "repository": {
@@ -28,8 +28,8 @@
   ],
   "dependencies": {
     "zod": "4.4.3",
-    "@penvhq/cli": "0.14.0",
-    "@penvhq/core": "0.14.0"
+    "@penvhq/cli": "0.16.0",
+    "@penvhq/core": "0.16.0"
   },
   "scripts": {
     "build": "tsup"