@verdaccio/config 9.0.0-next-9.10 → 9.0.0-next-9.12

package/README.md

@@ -33,41 +33,125 @@ To start using `@verdaccio/config`, import the `ConfigBuilder` class and begin c
 
 ## `ConfigBuilder` constructor
 
-The `ConfigBuilder` class is a helper configuration builder constructor used to programmatically create configuration objects for testing or other purposes.
+The `ConfigBuilder` class is a helper configuration builder constructor used to programmatically create configuration objects for testing or other purposes. All setter methods return `this` for fluent chaining.
 
 ```typescript
-
 import { ConfigBuilder } from '@verdaccio/config';
+import { constants } from '@verdaccio/core';
+
+const config = ConfigBuilder.build()
+  .addStorage('./storage')
+  .addSecurity({
+    api: {
+      jwt: { sign: { expiresIn: '7d' }, verify: {} },
+      legacy: false,
+    },
+    web: {
+      sign: { expiresIn: '1h' },
+      verify: {},
+    },
+  })
+  .addAuth({
+    htpasswd: { file: '.htpasswd' },
+  })
+  .addUplink('npmjs', { url: 'https://registry.npmjs.org/' })
+  .addPackageAccess('@scope/*', {
+    access: constants.ROLES.$AUTH,
+    publish: constants.ROLES.$AUTH,
+    proxy: 'npmjs',
+  })
+  .addWeb({ title: 'My Registry', darkMode: true, primaryColor: '#4b5e40' })
+  .addLogger({ type: 'stdout', format: 'pretty', level: 'info' })
+  .addMiddlewares({ audit: { enabled: true } })
+  .addFlags({ changePassword: true })
+  .addI18n({ web: 'en-US' });
 
-// Create a new configuration builder instance
-const config = ConfigBuilder.build({ security: { api: { legacy: false } } });
-
-// Add package access configuration
-configBuilder.addPackageAccess('@scope/*', { access: 'read', publish: 'write' });
-
-// Add an uplink configuration
-configBuilder.addUplink('npmjs', { url: 'https://registry.npmjs.org/' });
+// Get the configuration object
+const configObj = config.getConfig();
 
-// Add security configuration
-configBuilder.addSecurity({ allow_offline: true });
+// Get the configuration as YAML text
+const configYaml = config.getAsYaml();
+```
 
-// Get the configuration object
-const config = configBuilder.getConfig();
+You can also pass an initial partial configuration to `ConfigBuilder.build()`:
 
-// Get the configuration yaml text
-const config = configBuilder.getAsYaml();
+```typescript
+const config = ConfigBuilder.build({ security: { api: { legacy: false } } });
 ```
 
 ### Methods
 
-- `addPackageAccess(pattern: string, pkgAccess: PackageAccessYaml)`: Adds package access configuration.
+- `addPackageAccess(pattern: string, pkgAccess: PackageAccessYaml)`: Adds package access configuration for a pattern.
 - `addUplink(id: string, uplink: UpLinkConf)`: Adds an uplink configuration.
-- `addSecurity(security: Partial<Security>)`: Adds security configuration.
-- `addAuth(auth: Partial<AuthConf>)`: Adds authentication configuration.
-- `addLogger(log: LoggerConfItem)`: Adds logger configuration.
-- `addStorage(storage: string | object)`: Adds storage configuration.
+- `addSecurity(security: Partial<Security>)`: Merges security configuration.
+- `addAuth(auth: Partial<AuthConf>)`: Merges authentication configuration.
+- `addLogger(log: LoggerConfigItem)`: Sets logger configuration.
+- `addServer(server: Partial<ServerSettingsConf>)`: Merges server settings.
+- `addStorage(storage: string | object)`: Sets storage path (string) or store plugin configuration (object).
+- `addWeb(web: Partial<WebConf>)`: Merges web UI configuration.
+- `addListen(listen: ListenAddress)`: Sets listen address.
+- `addHttps(https: HttpsConf)`: Sets HTTPS configuration.
+- `addPublish(publish: Partial<PublishOptions>)`: Merges publish options.
+- `addFlags(flags: Partial<FlagsConfig>)`: Merges feature flags.
+- `addNotify(notify: Notifications | Notifications[])`: Sets notification hooks.
+- `addMiddlewares(middlewares: any)`: Merges middlewares configuration.
+- `addFilters(filters: any)`: Merges filters configuration.
+- `addMaxBodySize(maxBodySize: string)`: Sets the max body size (e.g., `'50mb'`).
+- `addUserRateLimit(rateLimit: RateLimit)`: Merges user rate limit settings.
+- `addUrlPrefix(urlPrefix: string)`: Sets URL prefix.
+- `addI18n(i18n: ConfigYaml['i18n'])`: Sets i18n configuration.
+- `addUserAgent(userAgent: string)`: Sets the user agent string.
+- `addHttpProxy(httpProxy: string)`: Sets the HTTP proxy.
+- `addHttpsProxy(httpsProxy: string)`: Sets the HTTPS proxy.
+- `addNoProxy(noProxy: string)`: Sets the no-proxy exclusion list.
+- `addPlugins(plugins: string)`: Sets the plugins directory path.
+- `addNotifications(notifications: Notifications)`: Sets notifications configuration.
 - `getConfig(): ConfigYaml`: Retrieves the configuration object.
-- `getAsYaml(): string`: Retrieves the configuration object as YAML format.
+- `getAsYaml(): string`: Retrieves the configuration as YAML format.
+
+## Using `ConfigBuilder` with `runServer`
+
+The `ConfigBuilder` pairs with `runServer` from the `verdaccio` package to start a registry programmatically:
+
+```typescript
+import { runServer } from 'verdaccio';
+
+import { ConfigBuilder } from '@verdaccio/config';
+import { constants } from '@verdaccio/core';
+
+const config = ConfigBuilder.build()
+  .addStorage('./storage')
+  .addAuth({ htpasswd: { file: '.htpasswd' } })
+  .addUplink('npmjs', { url: 'https://registry.npmjs.org/' })
+  .addPackageAccess(constants.PACKAGE_ACCESS.SCOPE, {
+    access: constants.ROLES.$AUTH,
+    publish: constants.ROLES.$AUTH,
+    proxy: 'npmjs',
+  })
+  .addPackageAccess(constants.PACKAGE_ACCESS.ALL, {
+    access: constants.ROLES.$ALL,
+    publish: constants.ROLES.$AUTH,
+    proxy: 'npmjs',
+  })
+  .addWeb({ title: 'My Registry', darkMode: true })
+  .addMiddlewares({ audit: { enabled: true } })
+  .addLogger({ type: 'stdout', format: 'pretty', level: 'info' })
+  .addSecurity({
+    api: { jwt: { sign: { expiresIn: '7d' }, verify: {} }, legacy: false },
+    web: { sign: { expiresIn: '1h' }, verify: {} },
+  })
+  .addI18n({ web: 'en-US' });
+
+runServer(config.getConfig())
+  .then((app) => {
+    app.listen(4873, () => {
+      console.log('verdaccio running on port 4873');
+    });
+  })
+  .catch((err) => {
+    console.error(err);
+  });
+```
 
 ## `getDefaultConfig`
 

package/build/builder.d.ts

@@ -1,4 +1,4 @@
-import { AuthConf, ConfigYaml, LoggerConfigItem, PackageAccessYaml, Security, ServerSettingsConf, UpLinkConf } from '@verdaccio/types';
+import { AuthConf, ConfigYaml, FlagsConfig, HttpsConf, ListenAddress, LoggerConfigItem, Notifications, PackageAccessYaml, PublishOptions, RateLimit, Security, ServerSettingsConf, UpLinkConf, WebConf } from '@verdaccio/types';
 /**
  * Helper configuration builder constructor, used to build the configuration for testing or
  * programatically creating a configuration.
@@ -14,6 +14,24 @@ export default class ConfigBuilder {
     addLogger(log: LoggerConfigItem): this;
     addServer(server: Partial<ServerSettingsConf>): this;
     addStorage(storage: string | object): this;
+    addWeb(web: Partial<WebConf>): this;
+    addListen(listen: ListenAddress): this;
+    addHttps(https: HttpsConf): this;
+    addPublish(publish: Partial<PublishOptions>): this;
+    addFlags(flags: Partial<FlagsConfig>): this;
+    addNotify(notify: Notifications | Notifications[]): this;
+    addMiddlewares(middlewares: any): this;
+    addFilters(filters: any): this;
+    addMaxBodySize(maxBodySize: string): this;
+    addUserRateLimit(rateLimit: RateLimit): this;
+    addUrlPrefix(urlPrefix: string): this;
+    addI18n(i18n: ConfigYaml['i18n']): this;
+    addUserAgent(userAgent: string): this;
+    addHttpProxy(httpProxy: string): this;
+    addHttpsProxy(httpsProxy: string): this;
+    addNoProxy(noProxy: string): this;
+    addPlugins(plugins: string): this;
+    addNotifications(notifications: Notifications): this;
     getConfig(): ConfigYaml;
     getAsYaml(): string;
 }

package/build/builder.js

@@ -10,11 +10,11 @@ let lodash_es = require("lodash-es");
 var ConfigBuilder = class ConfigBuilder {
 	config;
 	constructor(config) {
-		this.config = (0, lodash_es.merge)(config, {
+		this.config = (0, lodash_es.merge)({
 			uplinks: {},
 			packages: {},
 			security: {}
-		});
+		}, config);
 	}
 	static build(config) {
 		return new ConfigBuilder(config);
@@ -48,6 +48,78 @@ var ConfigBuilder = class ConfigBuilder {
 		else this.config.store = storage;
 		return this;
 	}
+	addWeb(web) {
+		this.config.web = (0, lodash_es.merge)(this.config.web, web);
+		return this;
+	}
+	addListen(listen) {
+		this.config.listen = listen;
+		return this;
+	}
+	addHttps(https) {
+		this.config.https = https;
+		return this;
+	}
+	addPublish(publish) {
+		this.config.publish = (0, lodash_es.merge)(this.config.publish, publish);
+		return this;
+	}
+	addFlags(flags) {
+		this.config.flags = (0, lodash_es.merge)(this.config.flags, flags);
+		return this;
+	}
+	addNotify(notify) {
+		this.config.notify = notify;
+		return this;
+	}
+	addMiddlewares(middlewares) {
+		this.config.middlewares = (0, lodash_es.merge)(this.config.middlewares, middlewares);
+		return this;
+	}
+	addFilters(filters) {
+		this.config.filters = (0, lodash_es.merge)(this.config.filters, filters);
+		return this;
+	}
+	addMaxBodySize(maxBodySize) {
+		this.config.max_body_size = maxBodySize;
+		return this;
+	}
+	addUserRateLimit(rateLimit) {
+		this.config.userRateLimit = (0, lodash_es.merge)(this.config.userRateLimit, rateLimit);
+		return this;
+	}
+	addUrlPrefix(urlPrefix) {
+		this.config.url_prefix = urlPrefix;
+		return this;
+	}
+	addI18n(i18n) {
+		this.config.i18n = i18n;
+		return this;
+	}
+	addUserAgent(userAgent) {
+		this.config.user_agent = userAgent;
+		return this;
+	}
+	addHttpProxy(httpProxy) {
+		this.config.http_proxy = httpProxy;
+		return this;
+	}
+	addHttpsProxy(httpsProxy) {
+		this.config.https_proxy = httpsProxy;
+		return this;
+	}
+	addNoProxy(noProxy) {
+		this.config.no_proxy = noProxy;
+		return this;
+	}
+	addPlugins(plugins) {
+		this.config.plugins = plugins;
+		return this;
+	}
+	addNotifications(notifications) {
+		this.config.notifications = notifications;
+		return this;
+	}
 	getConfig() {
 		return this.config;
 	}

package/build/builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder.js","names":[],"sources":["../src/builder.ts"],"sourcesContent":["import { merge } from 'lodash-es';\n\nimport type {\n  AuthConf,\n  ConfigYaml,\n  LoggerConfigItem,\n  PackageAccessYaml,\n  Security,\n  ServerSettingsConf,\n  UpLinkConf,\n} from '@verdaccio/types';\n\nimport { fromJStoYAML } from '.';\n\n/**\n * Helper configuration builder constructor, used to build the configuration for testing or\n * programatically creating a configuration.\n */\nexport default class ConfigBuilder {\n  private config: ConfigYaml;\n\n  public constructor(config?: Partial<ConfigYaml>) {\n    this.config = merge(config, { uplinks: {}, packages: {}, security: {} });\n  }\n\n  public static build(config?: Partial<ConfigYaml>): ConfigBuilder {\n    return new ConfigBuilder(config);\n  }\n\n  public addPackageAccess(pattern: string, pkgAccess: PackageAccessYaml) {\n    // @ts-ignore\n    this.config.packages[pattern] = pkgAccess;\n    return this;\n  }\n\n  public addUplink(id: string, uplink: UpLinkConf) {\n    this.config.uplinks[id] = uplink;\n    return this;\n  }\n\n  public addSecurity(security: Partial<Security>) {\n    this.config.security = merge(this.config.security, security);\n    return this;\n  }\n\n  public addAuth(auth: Partial<AuthConf>) {\n    this.config.auth = merge(this.config.auth, auth);\n    return this;\n  }\n\n  public addLogger(log: LoggerConfigItem) {\n    this.config.log = log;\n    return this;\n  }\n\n  public addServer(server: Partial<ServerSettingsConf>) {\n    this.config.server = merge(this.config.server, server);\n    return this;\n  }\n\n  public addStorage(storage: string | object) {\n    if (typeof storage === 'string') {\n      this.config.storage = storage;\n    } else {\n      this.config.store = storage;\n    }\n    return this;\n  }\n\n  public getConfig(): ConfigYaml {\n    return this.config;\n  }\n\n  public getAsYaml(): string {\n    return fromJStoYAML(this.config) as string;\n  }\n}\n"],"mappings":";;;;;;;;;AAkBA,IAAqB,gBAArB,MAAqB,cAAc;CACjC;CAEA,YAAmB,QAA8B;AAC/C,OAAK,UAAA,GAAA,UAAA,OAAe,QAAQ;GAAE,SAAS,EAAE;GAAE,UAAU,EAAE;GAAE,UAAU,EAAE;GAAE,CAAC;;CAG1E,OAAc,MAAM,QAA6C;AAC/D,SAAO,IAAI,cAAc,OAAO;;CAGlC,iBAAwB,SAAiB,WAA8B;AAErE,OAAK,OAAO,SAAS,WAAW;AAChC,SAAO;;CAGT,UAAiB,IAAY,QAAoB;AAC/C,OAAK,OAAO,QAAQ,MAAM;AAC1B,SAAO;;CAGT,YAAmB,UAA6B;AAC9C,OAAK,OAAO,YAAA,GAAA,UAAA,OAAiB,KAAK,OAAO,UAAU,SAAS;AAC5D,SAAO;;CAGT,QAAe,MAAyB;AACtC,OAAK,OAAO,QAAA,GAAA,UAAA,OAAa,KAAK,OAAO,MAAM,KAAK;AAChD,SAAO;;CAGT,UAAiB,KAAuB;AACtC,OAAK,OAAO,MAAM;AAClB,SAAO;;CAGT,UAAiB,QAAqC;AACpD,OAAK,OAAO,UAAA,GAAA,UAAA,OAAe,KAAK,OAAO,QAAQ,OAAO;AACtD,SAAO;;CAGT,WAAkB,SAA0B;AAC1C,MAAI,OAAO,YAAY,SACrB,MAAK,OAAO,UAAU;MAEtB,MAAK,OAAO,QAAQ;AAEtB,SAAO;;CAGT,YAA+B;AAC7B,SAAO,KAAK;;CAGd,YAA2B;AACzB,SAAO,cAAA,aAAa,KAAK,OAAO"}
+{"version":3,"file":"builder.js","names":[],"sources":["../src/builder.ts"],"sourcesContent":["import { merge } from 'lodash-es';\n\nimport type {\n  AuthConf,\n  ConfigYaml,\n  FlagsConfig,\n  HttpsConf,\n  ListenAddress,\n  LoggerConfigItem,\n  Notifications,\n  PackageAccessYaml,\n  PublishOptions,\n  RateLimit,\n  Security,\n  ServerSettingsConf,\n  UpLinkConf,\n  WebConf,\n} from '@verdaccio/types';\n\nimport { fromJStoYAML } from '.';\n\n/**\n * Helper configuration builder constructor, used to build the configuration for testing or\n * programatically creating a configuration.\n */\nexport default class ConfigBuilder {\n  private config: ConfigYaml;\n\n  public constructor(config?: Partial<ConfigYaml>) {\n    this.config = merge({ uplinks: {}, packages: {}, security: {} }, config);\n  }\n\n  public static build(config?: Partial<ConfigYaml>): ConfigBuilder {\n    return new ConfigBuilder(config);\n  }\n\n  public addPackageAccess(pattern: string, pkgAccess: PackageAccessYaml) {\n    // PackageAccessYaml uses string for publish/access while PackageAccess uses string[]\n    // The config parser normalizes these later, so the cast is safe here\n    (this.config.packages as Record<string, PackageAccessYaml>)[pattern] = pkgAccess;\n    return this;\n  }\n\n  public addUplink(id: string, uplink: UpLinkConf) {\n    this.config.uplinks[id] = uplink;\n    return this;\n  }\n\n  public addSecurity(security: Partial<Security>) {\n    this.config.security = merge(this.config.security, security);\n    return this;\n  }\n\n  public addAuth(auth: Partial<AuthConf>) {\n    this.config.auth = merge(this.config.auth, auth);\n    return this;\n  }\n\n  public addLogger(log: LoggerConfigItem) {\n    this.config.log = log;\n    return this;\n  }\n\n  public addServer(server: Partial<ServerSettingsConf>) {\n    this.config.server = merge(this.config.server, server);\n    return this;\n  }\n\n  public addStorage(storage: string | object) {\n    if (typeof storage === 'string') {\n      this.config.storage = storage;\n    } else {\n      this.config.store = storage;\n    }\n    return this;\n  }\n\n  public addWeb(web: Partial<WebConf>) {\n    this.config.web = merge(this.config.web, web);\n    return this;\n  }\n\n  public addListen(listen: ListenAddress) {\n    this.config.listen = listen;\n    return this;\n  }\n\n  public addHttps(https: HttpsConf) {\n    this.config.https = https;\n    return this;\n  }\n\n  public addPublish(publish: Partial<PublishOptions>) {\n    this.config.publish = merge(this.config.publish, publish);\n    return this;\n  }\n\n  public addFlags(flags: Partial<FlagsConfig>) {\n    this.config.flags = merge(this.config.flags, flags);\n    return this;\n  }\n\n  public addNotify(notify: Notifications | Notifications[]) {\n    this.config.notify = notify;\n    return this;\n  }\n\n  public addMiddlewares(middlewares: any) {\n    this.config.middlewares = merge(this.config.middlewares, middlewares);\n    return this;\n  }\n\n  public addFilters(filters: any) {\n    this.config.filters = merge(this.config.filters, filters);\n    return this;\n  }\n\n  public addMaxBodySize(maxBodySize: string) {\n    this.config.max_body_size = maxBodySize;\n    return this;\n  }\n\n  public addUserRateLimit(rateLimit: RateLimit) {\n    this.config.userRateLimit = merge(this.config.userRateLimit, rateLimit);\n    return this;\n  }\n\n  public addUrlPrefix(urlPrefix: string) {\n    this.config.url_prefix = urlPrefix;\n    return this;\n  }\n\n  public addI18n(i18n: ConfigYaml['i18n']) {\n    this.config.i18n = i18n;\n    return this;\n  }\n\n  public addUserAgent(userAgent: string) {\n    this.config.user_agent = userAgent;\n    return this;\n  }\n\n  public addHttpProxy(httpProxy: string) {\n    this.config.http_proxy = httpProxy;\n    return this;\n  }\n\n  public addHttpsProxy(httpsProxy: string) {\n    this.config.https_proxy = httpsProxy;\n    return this;\n  }\n\n  public addNoProxy(noProxy: string) {\n    this.config.no_proxy = noProxy;\n    return this;\n  }\n\n  public addPlugins(plugins: string) {\n    this.config.plugins = plugins;\n    return this;\n  }\n\n  public addNotifications(notifications: Notifications) {\n    this.config.notifications = notifications;\n    return this;\n  }\n\n  public getConfig(): ConfigYaml {\n    return this.config;\n  }\n\n  public getAsYaml(): string {\n    return fromJStoYAML(this.config) as string;\n  }\n}\n"],"mappings":";;;;;;;;;AAyBA,IAAqB,gBAArB,MAAqB,cAAc;CACjC;CAEA,YAAmB,QAA8B;AAC/C,OAAK,UAAA,GAAA,UAAA,OAAe;GAAE,SAAS,EAAE;GAAE,UAAU,EAAE;GAAE,UAAU,EAAE;GAAE,EAAE,OAAO;;CAG1E,OAAc,MAAM,QAA6C;AAC/D,SAAO,IAAI,cAAc,OAAO;;CAGlC,iBAAwB,SAAiB,WAA8B;AAGpE,OAAK,OAAO,SAA+C,WAAW;AACvE,SAAO;;CAGT,UAAiB,IAAY,QAAoB;AAC/C,OAAK,OAAO,QAAQ,MAAM;AAC1B,SAAO;;CAGT,YAAmB,UAA6B;AAC9C,OAAK,OAAO,YAAA,GAAA,UAAA,OAAiB,KAAK,OAAO,UAAU,SAAS;AAC5D,SAAO;;CAGT,QAAe,MAAyB;AACtC,OAAK,OAAO,QAAA,GAAA,UAAA,OAAa,KAAK,OAAO,MAAM,KAAK;AAChD,SAAO;;CAGT,UAAiB,KAAuB;AACtC,OAAK,OAAO,MAAM;AAClB,SAAO;;CAGT,UAAiB,QAAqC;AACpD,OAAK,OAAO,UAAA,GAAA,UAAA,OAAe,KAAK,OAAO,QAAQ,OAAO;AACtD,SAAO;;CAGT,WAAkB,SAA0B;AAC1C,MAAI,OAAO,YAAY,SACrB,MAAK,OAAO,UAAU;MAEtB,MAAK,OAAO,QAAQ;AAEtB,SAAO;;CAGT,OAAc,KAAuB;AACnC,OAAK,OAAO,OAAA,GAAA,UAAA,OAAY,KAAK,OAAO,KAAK,IAAI;AAC7C,SAAO;;CAGT,UAAiB,QAAuB;AACtC,OAAK,OAAO,SAAS;AACrB,SAAO;;CAGT,SAAgB,OAAkB;AAChC,OAAK,OAAO,QAAQ;AACpB,SAAO;;CAGT,WAAkB,SAAkC;AAClD,OAAK,OAAO,WAAA,GAAA,UAAA,OAAgB,KAAK,OAAO,SAAS,QAAQ;AACzD,SAAO;;CAGT,SAAgB,OAA6B;AAC3C,OAAK,OAAO,SAAA,GAAA,UAAA,OAAc,KAAK,OAAO,OAAO,MAAM;AACnD,SAAO;;CAGT,UAAiB,QAAyC;AACxD,OAAK,OAAO,SAAS;AACrB,SAAO;;CAGT,eAAsB,aAAkB;AACtC,OAAK,OAAO,eAAA,GAAA,UAAA,OAAoB,KAAK,OAAO,aAAa,YAAY;AACrE,SAAO;;CAGT,WAAkB,SAAc;AAC9B,OAAK,OAAO,WAAA,GAAA,UAAA,OAAgB,KAAK,OAAO,SAAS,QAAQ;AACzD,SAAO;;CAGT,eAAsB,aAAqB;AACzC,OAAK,OAAO,gBAAgB;AAC5B,SAAO;;CAGT,iBAAwB,WAAsB;AAC5C,OAAK,OAAO,iBAAA,GAAA,UAAA,OAAsB,KAAK,OAAO,eAAe,UAAU;AACvE,SAAO;;CAGT,aAAoB,WAAmB;AACrC,OAAK,OAAO,aAAa;AACzB,SAAO;;CAGT,QAAe,MAA0B;AACvC,OAAK,OAAO,OAAO;AACnB,SAAO;;CAGT,aAAoB,WAAmB;AACrC,OAAK,OAAO,aAAa;AACzB,SAAO;;CAGT,aAAoB,WAAmB;AACrC,OAAK,OAAO,aAAa;AACzB,SAAO;;CAGT,cAAqB,YAAoB;AACvC,OAAK,OAAO,cAAc;AAC1B,SAAO;;CAGT,WAAkB,SAAiB;AACjC,OAAK,OAAO,WAAW;AACvB,SAAO;;CAGT,WAAkB,SAAiB;AACjC,OAAK,OAAO,UAAU;AACtB,SAAO;;CAGT,iBAAwB,eAA8B;AACpD,OAAK,OAAO,gBAAgB;AAC5B,SAAO;;CAGT,YAA+B;AAC7B,SAAO,KAAK;;CAGd,YAA2B;AACzB,SAAO,cAAA,aAAa,KAAK,OAAO"}

package/build/builder.mjs

@@ -9,11 +9,11 @@ import { merge } from "lodash-es";
 var ConfigBuilder = class ConfigBuilder {
 	config;
 	constructor(config) {
-		this.config = merge(config, {
+		this.config = merge({
 			uplinks: {},
 			packages: {},
 			security: {}
-		});
+		}, config);
 	}
 	static build(config) {
 		return new ConfigBuilder(config);
@@ -47,6 +47,78 @@ var ConfigBuilder = class ConfigBuilder {
 		else this.config.store = storage;
 		return this;
 	}
+	addWeb(web) {
+		this.config.web = merge(this.config.web, web);
+		return this;
+	}
+	addListen(listen) {
+		this.config.listen = listen;
+		return this;
+	}
+	addHttps(https) {
+		this.config.https = https;
+		return this;
+	}
+	addPublish(publish) {
+		this.config.publish = merge(this.config.publish, publish);
+		return this;
+	}
+	addFlags(flags) {
+		this.config.flags = merge(this.config.flags, flags);
+		return this;
+	}
+	addNotify(notify) {
+		this.config.notify = notify;
+		return this;
+	}
+	addMiddlewares(middlewares) {
+		this.config.middlewares = merge(this.config.middlewares, middlewares);
+		return this;
+	}
+	addFilters(filters) {
+		this.config.filters = merge(this.config.filters, filters);
+		return this;
+	}
+	addMaxBodySize(maxBodySize) {
+		this.config.max_body_size = maxBodySize;
+		return this;
+	}
+	addUserRateLimit(rateLimit) {
+		this.config.userRateLimit = merge(this.config.userRateLimit, rateLimit);
+		return this;
+	}
+	addUrlPrefix(urlPrefix) {
+		this.config.url_prefix = urlPrefix;
+		return this;
+	}
+	addI18n(i18n) {
+		this.config.i18n = i18n;
+		return this;
+	}
+	addUserAgent(userAgent) {
+		this.config.user_agent = userAgent;
+		return this;
+	}
+	addHttpProxy(httpProxy) {
+		this.config.http_proxy = httpProxy;
+		return this;
+	}
+	addHttpsProxy(httpsProxy) {
+		this.config.https_proxy = httpsProxy;
+		return this;
+	}
+	addNoProxy(noProxy) {
+		this.config.no_proxy = noProxy;
+		return this;
+	}
+	addPlugins(plugins) {
+		this.config.plugins = plugins;
+		return this;
+	}
+	addNotifications(notifications) {
+		this.config.notifications = notifications;
+		return this;
+	}
 	getConfig() {
 		return this.config;
 	}

package/build/builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"builder.mjs","names":[],"sources":["../src/builder.ts"],"sourcesContent":["import { merge } from 'lodash-es';\n\nimport type {\n  AuthConf,\n  ConfigYaml,\n  LoggerConfigItem,\n  PackageAccessYaml,\n  Security,\n  ServerSettingsConf,\n  UpLinkConf,\n} from '@verdaccio/types';\n\nimport { fromJStoYAML } from '.';\n\n/**\n * Helper configuration builder constructor, used to build the configuration for testing or\n * programatically creating a configuration.\n */\nexport default class ConfigBuilder {\n  private config: ConfigYaml;\n\n  public constructor(config?: Partial<ConfigYaml>) {\n    this.config = merge(config, { uplinks: {}, packages: {}, security: {} });\n  }\n\n  public static build(config?: Partial<ConfigYaml>): ConfigBuilder {\n    return new ConfigBuilder(config);\n  }\n\n  public addPackageAccess(pattern: string, pkgAccess: PackageAccessYaml) {\n    // @ts-ignore\n    this.config.packages[pattern] = pkgAccess;\n    return this;\n  }\n\n  public addUplink(id: string, uplink: UpLinkConf) {\n    this.config.uplinks[id] = uplink;\n    return this;\n  }\n\n  public addSecurity(security: Partial<Security>) {\n    this.config.security = merge(this.config.security, security);\n    return this;\n  }\n\n  public addAuth(auth: Partial<AuthConf>) {\n    this.config.auth = merge(this.config.auth, auth);\n    return this;\n  }\n\n  public addLogger(log: LoggerConfigItem) {\n    this.config.log = log;\n    return this;\n  }\n\n  public addServer(server: Partial<ServerSettingsConf>) {\n    this.config.server = merge(this.config.server, server);\n    return this;\n  }\n\n  public addStorage(storage: string | object) {\n    if (typeof storage === 'string') {\n      this.config.storage = storage;\n    } else {\n      this.config.store = storage;\n    }\n    return this;\n  }\n\n  public getConfig(): ConfigYaml {\n    return this.config;\n  }\n\n  public getAsYaml(): string {\n    return fromJStoYAML(this.config) as string;\n  }\n}\n"],"mappings":";;;;;;;;AAkBA,IAAqB,gBAArB,MAAqB,cAAc;CACjC;CAEA,YAAmB,QAA8B;AAC/C,OAAK,SAAS,MAAM,QAAQ;GAAE,SAAS,EAAE;GAAE,UAAU,EAAE;GAAE,UAAU,EAAE;GAAE,CAAC;;CAG1E,OAAc,MAAM,QAA6C;AAC/D,SAAO,IAAI,cAAc,OAAO;;CAGlC,iBAAwB,SAAiB,WAA8B;AAErE,OAAK,OAAO,SAAS,WAAW;AAChC,SAAO;;CAGT,UAAiB,IAAY,QAAoB;AAC/C,OAAK,OAAO,QAAQ,MAAM;AAC1B,SAAO;;CAGT,YAAmB,UAA6B;AAC9C,OAAK,OAAO,WAAW,MAAM,KAAK,OAAO,UAAU,SAAS;AAC5D,SAAO;;CAGT,QAAe,MAAyB;AACtC,OAAK,OAAO,OAAO,MAAM,KAAK,OAAO,MAAM,KAAK;AAChD,SAAO;;CAGT,UAAiB,KAAuB;AACtC,OAAK,OAAO,MAAM;AAClB,SAAO;;CAGT,UAAiB,QAAqC;AACpD,OAAK,OAAO,SAAS,MAAM,KAAK,OAAO,QAAQ,OAAO;AACtD,SAAO;;CAGT,WAAkB,SAA0B;AAC1C,MAAI,OAAO,YAAY,SACrB,MAAK,OAAO,UAAU;MAEtB,MAAK,OAAO,QAAQ;AAEtB,SAAO;;CAGT,YAA+B;AAC7B,SAAO,KAAK;;CAGd,YAA2B;AACzB,SAAO,aAAa,KAAK,OAAO"}
+{"version":3,"file":"builder.mjs","names":[],"sources":["../src/builder.ts"],"sourcesContent":["import { merge } from 'lodash-es';\n\nimport type {\n  AuthConf,\n  ConfigYaml,\n  FlagsConfig,\n  HttpsConf,\n  ListenAddress,\n  LoggerConfigItem,\n  Notifications,\n  PackageAccessYaml,\n  PublishOptions,\n  RateLimit,\n  Security,\n  ServerSettingsConf,\n  UpLinkConf,\n  WebConf,\n} from '@verdaccio/types';\n\nimport { fromJStoYAML } from '.';\n\n/**\n * Helper configuration builder constructor, used to build the configuration for testing or\n * programatically creating a configuration.\n */\nexport default class ConfigBuilder {\n  private config: ConfigYaml;\n\n  public constructor(config?: Partial<ConfigYaml>) {\n    this.config = merge({ uplinks: {}, packages: {}, security: {} }, config);\n  }\n\n  public static build(config?: Partial<ConfigYaml>): ConfigBuilder {\n    return new ConfigBuilder(config);\n  }\n\n  public addPackageAccess(pattern: string, pkgAccess: PackageAccessYaml) {\n    // PackageAccessYaml uses string for publish/access while PackageAccess uses string[]\n    // The config parser normalizes these later, so the cast is safe here\n    (this.config.packages as Record<string, PackageAccessYaml>)[pattern] = pkgAccess;\n    return this;\n  }\n\n  public addUplink(id: string, uplink: UpLinkConf) {\n    this.config.uplinks[id] = uplink;\n    return this;\n  }\n\n  public addSecurity(security: Partial<Security>) {\n    this.config.security = merge(this.config.security, security);\n    return this;\n  }\n\n  public addAuth(auth: Partial<AuthConf>) {\n    this.config.auth = merge(this.config.auth, auth);\n    return this;\n  }\n\n  public addLogger(log: LoggerConfigItem) {\n    this.config.log = log;\n    return this;\n  }\n\n  public addServer(server: Partial<ServerSettingsConf>) {\n    this.config.server = merge(this.config.server, server);\n    return this;\n  }\n\n  public addStorage(storage: string | object) {\n    if (typeof storage === 'string') {\n      this.config.storage = storage;\n    } else {\n      this.config.store = storage;\n    }\n    return this;\n  }\n\n  public addWeb(web: Partial<WebConf>) {\n    this.config.web = merge(this.config.web, web);\n    return this;\n  }\n\n  public addListen(listen: ListenAddress) {\n    this.config.listen = listen;\n    return this;\n  }\n\n  public addHttps(https: HttpsConf) {\n    this.config.https = https;\n    return this;\n  }\n\n  public addPublish(publish: Partial<PublishOptions>) {\n    this.config.publish = merge(this.config.publish, publish);\n    return this;\n  }\n\n  public addFlags(flags: Partial<FlagsConfig>) {\n    this.config.flags = merge(this.config.flags, flags);\n    return this;\n  }\n\n  public addNotify(notify: Notifications | Notifications[]) {\n    this.config.notify = notify;\n    return this;\n  }\n\n  public addMiddlewares(middlewares: any) {\n    this.config.middlewares = merge(this.config.middlewares, middlewares);\n    return this;\n  }\n\n  public addFilters(filters: any) {\n    this.config.filters = merge(this.config.filters, filters);\n    return this;\n  }\n\n  public addMaxBodySize(maxBodySize: string) {\n    this.config.max_body_size = maxBodySize;\n    return this;\n  }\n\n  public addUserRateLimit(rateLimit: RateLimit) {\n    this.config.userRateLimit = merge(this.config.userRateLimit, rateLimit);\n    return this;\n  }\n\n  public addUrlPrefix(urlPrefix: string) {\n    this.config.url_prefix = urlPrefix;\n    return this;\n  }\n\n  public addI18n(i18n: ConfigYaml['i18n']) {\n    this.config.i18n = i18n;\n    return this;\n  }\n\n  public addUserAgent(userAgent: string) {\n    this.config.user_agent = userAgent;\n    return this;\n  }\n\n  public addHttpProxy(httpProxy: string) {\n    this.config.http_proxy = httpProxy;\n    return this;\n  }\n\n  public addHttpsProxy(httpsProxy: string) {\n    this.config.https_proxy = httpsProxy;\n    return this;\n  }\n\n  public addNoProxy(noProxy: string) {\n    this.config.no_proxy = noProxy;\n    return this;\n  }\n\n  public addPlugins(plugins: string) {\n    this.config.plugins = plugins;\n    return this;\n  }\n\n  public addNotifications(notifications: Notifications) {\n    this.config.notifications = notifications;\n    return this;\n  }\n\n  public getConfig(): ConfigYaml {\n    return this.config;\n  }\n\n  public getAsYaml(): string {\n    return fromJStoYAML(this.config) as string;\n  }\n}\n"],"mappings":";;;;;;;;AAyBA,IAAqB,gBAArB,MAAqB,cAAc;CACjC;CAEA,YAAmB,QAA8B;AAC/C,OAAK,SAAS,MAAM;GAAE,SAAS,EAAE;GAAE,UAAU,EAAE;GAAE,UAAU,EAAE;GAAE,EAAE,OAAO;;CAG1E,OAAc,MAAM,QAA6C;AAC/D,SAAO,IAAI,cAAc,OAAO;;CAGlC,iBAAwB,SAAiB,WAA8B;AAGpE,OAAK,OAAO,SAA+C,WAAW;AACvE,SAAO;;CAGT,UAAiB,IAAY,QAAoB;AAC/C,OAAK,OAAO,QAAQ,MAAM;AAC1B,SAAO;;CAGT,YAAmB,UAA6B;AAC9C,OAAK,OAAO,WAAW,MAAM,KAAK,OAAO,UAAU,SAAS;AAC5D,SAAO;;CAGT,QAAe,MAAyB;AACtC,OAAK,OAAO,OAAO,MAAM,KAAK,OAAO,MAAM,KAAK;AAChD,SAAO;;CAGT,UAAiB,KAAuB;AACtC,OAAK,OAAO,MAAM;AAClB,SAAO;;CAGT,UAAiB,QAAqC;AACpD,OAAK,OAAO,SAAS,MAAM,KAAK,OAAO,QAAQ,OAAO;AACtD,SAAO;;CAGT,WAAkB,SAA0B;AAC1C,MAAI,OAAO,YAAY,SACrB,MAAK,OAAO,UAAU;MAEtB,MAAK,OAAO,QAAQ;AAEtB,SAAO;;CAGT,OAAc,KAAuB;AACnC,OAAK,OAAO,MAAM,MAAM,KAAK,OAAO,KAAK,IAAI;AAC7C,SAAO;;CAGT,UAAiB,QAAuB;AACtC,OAAK,OAAO,SAAS;AACrB,SAAO;;CAGT,SAAgB,OAAkB;AAChC,OAAK,OAAO,QAAQ;AACpB,SAAO;;CAGT,WAAkB,SAAkC;AAClD,OAAK,OAAO,UAAU,MAAM,KAAK,OAAO,SAAS,QAAQ;AACzD,SAAO;;CAGT,SAAgB,OAA6B;AAC3C,OAAK,OAAO,QAAQ,MAAM,KAAK,OAAO,OAAO,MAAM;AACnD,SAAO;;CAGT,UAAiB,QAAyC;AACxD,OAAK,OAAO,SAAS;AACrB,SAAO;;CAGT,eAAsB,aAAkB;AACtC,OAAK,OAAO,cAAc,MAAM,KAAK,OAAO,aAAa,YAAY;AACrE,SAAO;;CAGT,WAAkB,SAAc;AAC9B,OAAK,OAAO,UAAU,MAAM,KAAK,OAAO,SAAS,QAAQ;AACzD,SAAO;;CAGT,eAAsB,aAAqB;AACzC,OAAK,OAAO,gBAAgB;AAC5B,SAAO;;CAGT,iBAAwB,WAAsB;AAC5C,OAAK,OAAO,gBAAgB,MAAM,KAAK,OAAO,eAAe,UAAU;AACvE,SAAO;;CAGT,aAAoB,WAAmB;AACrC,OAAK,OAAO,aAAa;AACzB,SAAO;;CAGT,QAAe,MAA0B;AACvC,OAAK,OAAO,OAAO;AACnB,SAAO;;CAGT,aAAoB,WAAmB;AACrC,OAAK,OAAO,aAAa;AACzB,SAAO;;CAGT,aAAoB,WAAmB;AACrC,OAAK,OAAO,aAAa;AACzB,SAAO;;CAGT,cAAqB,YAAoB;AACvC,OAAK,OAAO,cAAc;AAC1B,SAAO;;CAGT,WAAkB,SAAiB;AACjC,OAAK,OAAO,WAAW;AACvB,SAAO;;CAGT,WAAkB,SAAiB;AACjC,OAAK,OAAO,UAAU;AACtB,SAAO;;CAGT,iBAAwB,eAA8B;AACpD,OAAK,OAAO,gBAAgB;AAC5B,SAAO;;CAGT,YAA+B;AAC7B,SAAO,KAAK;;CAGd,YAA2B;AACzB,SAAO,aAAa,KAAK,OAAO"}

package/build/parse.js

@@ -74,6 +74,7 @@ function getConfigParsed(config) {
 		}
 	} else if (typeof config === "object" && config !== null) {
 		configurationParsed = config;
+		if (!configurationParsed.configPath) configurationParsed.configPath = process.cwd();
 		if (!configurationParsed.self_path) {
 			debug$1("self_path not defined, using config path location");
 			configurationParsed.self_path = configurationParsed.configPath;

package/build/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","names":[],"sources":["../src/parse.ts"],"sourcesContent":["import buildDebug from 'debug';\nimport YAML from 'js-yaml';\nimport { isObject } from 'lodash-es';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport { API_ERROR, APP_ERROR } from '@verdaccio/core';\nimport type { ConfigYaml } from '@verdaccio/types';\n\nimport { findConfigFile } from './config-path';\nimport { fileExists } from './config-utils';\n\nconst debug = buildDebug('verdaccio:config:parse');\n\n/**\n * Parse a config file from yaml to JSON.\n * @param configPath the absolute path of the configuration file\n */\nexport function parseConfigFile(configPath: string): ConfigYaml & {\n  // @deprecated use configPath instead\n  config_path: string;\n  configPath: string;\n} {\n  debug('parse config file %s', configPath);\n  if (!fileExists(configPath)) {\n    throw new Error(`config file does not exist or not reachable`);\n  }\n  debug('parsing config file: %o', configPath);\n  try {\n    if (/\\.ya?ml$/i.test(configPath)) {\n      const yamlConfig = YAML.load(fs.readFileSync(configPath, 'utf8'), {\n        strict: false,\n      }) as ConfigYaml;\n\n      return Object.assign({}, yamlConfig, {\n        configPath,\n        // @deprecated use configPath instead\n        config_path: configPath,\n      });\n    }\n\n    const jsonConfig = require(configPath) as ConfigYaml;\n    return Object.assign({}, jsonConfig, {\n      configPath,\n      // @deprecated use configPath instead\n      config_path: configPath,\n    });\n  } catch (e: any) {\n    if (e.code !== 'MODULE_NOT_FOUND') {\n      debug('config module not found %o error: %o', configPath, e.message);\n      throw Error(APP_ERROR.CONFIG_NOT_VALID);\n    }\n\n    throw e;\n  }\n}\n\nexport function fromJStoYAML(config: Partial<ConfigYaml>): string | null {\n  debug('convert config from JSON to YAML');\n  if (isObject(config)) {\n    return YAML.dump(config);\n  } else {\n    throw new Error(`config is not a valid object`);\n  }\n}\n\n/**\n * Parses and returns a configuration object of type `ConfigYaml`.\n *\n * If a string or `undefined` is provided, it is interpreted as a path to a config file\n * (or uses a default location). The config file is then loaded and parsed.\n * If an object is provided, it is assumed to be a pre-parsed configuration.\n * Backward compability: ensures the returned configuration object has a `self_path` property set,\n * either to the config file path or to a property within the object.\n *\n * @param {string | ConfigYaml} [config] - Optional. A path to the configuration file (string),\n *                                         a pre-parsed config object, or `undefined`.\n * @returns {ConfigYaml} The parsed configuration object with a guaranteed `self_path` property.\n * @throws {Error} If the provided config is neither a string, undefined, nor an object.\n */\nexport function getConfigParsed(config?: string | ConfigYaml): ConfigYaml {\n  debug('getConfigParsed called with config: %o', typeof config);\n  let configurationParsed: ConfigYaml;\n  if (config === undefined || typeof config === 'string') {\n    debug('using default configuration');\n    const configPathLocation = findConfigFile(config);\n    configurationParsed = parseConfigFile(configPathLocation);\n\n    // @ts-expect-error\n    if (!configurationParsed.self_path) {\n      debug('self_path not defined, using config path location');\n\n      // @ts-expect-error\n      configurationParsed.self_path = path.resolve(configPathLocation);\n    }\n  } else if (typeof config === 'object' && config !== null) {\n    configurationParsed = config;\n\n    // @ts-expect-error\n    if (!configurationParsed.self_path) {\n      debug('self_path not defined, using config path location');\n\n      // @ts-expect-error\n      configurationParsed.self_path = configurationParsed.configPath;\n    }\n  } else {\n    throw new Error(API_ERROR.CONFIG_BAD_FORMAT);\n  }\n  return configurationParsed;\n}\n"],"mappings":";;;;;;;;;;;;;;AAYA,IAAM,WAAA,GAAA,MAAA,SAAmB,yBAAyB;;;;;AAMlD,SAAgB,gBAAgB,YAI9B;AACA,SAAM,wBAAwB,WAAW;AACzC,KAAI,CAAC,qBAAA,WAAW,WAAW,CACzB,OAAM,IAAI,MAAM,8CAA8C;AAEhE,SAAM,2BAA2B,WAAW;AAC5C,KAAI;AACF,MAAI,YAAY,KAAK,WAAW,EAAE;GAChC,MAAM,aAAa,QAAA,QAAK,KAAK,QAAA,QAAG,aAAa,YAAY,OAAO,EAAE,EAChE,QAAQ,OACT,CAAC;AAEF,UAAO,OAAO,OAAO,EAAE,EAAE,YAAY;IACnC;IAEA,aAAa;IACd,CAAC;;EAGJ,MAAM,aAAa,QAAQ,WAAW;AACtC,SAAO,OAAO,OAAO,EAAE,EAAE,YAAY;GACnC;GAEA,aAAa;GACd,CAAC;UACK,GAAQ;AACf,MAAI,EAAE,SAAS,oBAAoB;AACjC,WAAM,wCAAwC,YAAY,EAAE,QAAQ;AACpE,SAAM,MAAM,gBAAA,UAAU,iBAAiB;;AAGzC,QAAM;;;AAIV,SAAgB,aAAa,QAA4C;AACvE,SAAM,mCAAmC;AACzC,MAAA,GAAA,UAAA,UAAa,OAAO,CAClB,QAAO,QAAA,QAAK,KAAK,OAAO;KAExB,OAAM,IAAI,MAAM,+BAA+B;;;;;;;;;;;;;;;;AAkBnD,SAAgB,gBAAgB,QAA0C;AACxE,SAAM,0CAA0C,OAAO,OAAO;CAC9D,IAAI;AACJ,KAAI,WAAW,KAAA,KAAa,OAAO,WAAW,UAAU;AACtD,UAAM,8BAA8B;EACpC,MAAM,qBAAqB,oBAAA,eAAe,OAAO;AACjD,wBAAsB,gBAAgB,mBAAmB;AAGzD,MAAI,CAAC,oBAAoB,WAAW;AAClC,WAAM,oDAAoD;AAG1D,uBAAoB,YAAY,UAAA,QAAK,QAAQ,mBAAmB;;YAEzD,OAAO,WAAW,YAAY,WAAW,MAAM;AACxD,wBAAsB;AAGtB,MAAI,CAAC,oBAAoB,WAAW;AAClC,WAAM,oDAAoD;AAG1D,uBAAoB,YAAY,oBAAoB;;OAGtD,OAAM,IAAI,MAAM,gBAAA,UAAU,kBAAkB;AAE9C,QAAO"}
+{"version":3,"file":"parse.js","names":[],"sources":["../src/parse.ts"],"sourcesContent":["import buildDebug from 'debug';\nimport YAML from 'js-yaml';\nimport { isObject } from 'lodash-es';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport { API_ERROR, APP_ERROR } from '@verdaccio/core';\nimport type { ConfigYaml } from '@verdaccio/types';\n\nimport { findConfigFile } from './config-path';\nimport { fileExists } from './config-utils';\n\nconst debug = buildDebug('verdaccio:config:parse');\n\n/**\n * Parse a config file from yaml to JSON.\n * @param configPath the absolute path of the configuration file\n */\nexport function parseConfigFile(configPath: string): ConfigYaml & {\n  // @deprecated use configPath instead\n  config_path: string;\n  configPath: string;\n} {\n  debug('parse config file %s', configPath);\n  if (!fileExists(configPath)) {\n    throw new Error(`config file does not exist or not reachable`);\n  }\n  debug('parsing config file: %o', configPath);\n  try {\n    if (/\\.ya?ml$/i.test(configPath)) {\n      const yamlConfig = YAML.load(fs.readFileSync(configPath, 'utf8'), {\n        strict: false,\n      }) as ConfigYaml;\n\n      return Object.assign({}, yamlConfig, {\n        configPath,\n        // @deprecated use configPath instead\n        config_path: configPath,\n      });\n    }\n\n    const jsonConfig = require(configPath) as ConfigYaml;\n    return Object.assign({}, jsonConfig, {\n      configPath,\n      // @deprecated use configPath instead\n      config_path: configPath,\n    });\n  } catch (e: any) {\n    if (e.code !== 'MODULE_NOT_FOUND') {\n      debug('config module not found %o error: %o', configPath, e.message);\n      throw Error(APP_ERROR.CONFIG_NOT_VALID);\n    }\n\n    throw e;\n  }\n}\n\nexport function fromJStoYAML(config: Partial<ConfigYaml>): string | null {\n  debug('convert config from JSON to YAML');\n  if (isObject(config)) {\n    return YAML.dump(config);\n  } else {\n    throw new Error(`config is not a valid object`);\n  }\n}\n\n/**\n * Parses and returns a configuration object of type `ConfigYaml`.\n *\n * If a string or `undefined` is provided, it is interpreted as a path to a config file\n * (or uses a default location). The config file is then loaded and parsed.\n * If an object is provided, it is assumed to be a pre-parsed configuration.\n * Backward compability: ensures the returned configuration object has a `self_path` property set,\n * either to the config file path or to a property within the object.\n *\n * @param {string | ConfigYaml} [config] - Optional. A path to the configuration file (string),\n *                                         a pre-parsed config object, or `undefined`.\n * @returns {ConfigYaml} The parsed configuration object with a guaranteed `self_path` property.\n * @throws {Error} If the provided config is neither a string, undefined, nor an object.\n */\nexport function getConfigParsed(config?: string | ConfigYaml): ConfigYaml {\n  debug('getConfigParsed called with config: %o', typeof config);\n  let configurationParsed: ConfigYaml;\n  if (config === undefined || typeof config === 'string') {\n    debug('using default configuration');\n    const configPathLocation = findConfigFile(config);\n    configurationParsed = parseConfigFile(configPathLocation);\n\n    // @ts-expect-error\n    if (!configurationParsed.self_path) {\n      debug('self_path not defined, using config path location');\n\n      // @ts-expect-error\n      configurationParsed.self_path = path.resolve(configPathLocation);\n    }\n  } else if (typeof config === 'object' && config !== null) {\n    configurationParsed = config;\n\n    // When config is provided as an object (programmatic API), ensure configPath\n    // is set so the Config constructor does not throw.\n    if (!configurationParsed.configPath) {\n      configurationParsed.configPath = process.cwd();\n    }\n\n    // @ts-expect-error\n    if (!configurationParsed.self_path) {\n      debug('self_path not defined, using config path location');\n\n      // @ts-expect-error\n      configurationParsed.self_path = configurationParsed.configPath;\n    }\n  } else {\n    throw new Error(API_ERROR.CONFIG_BAD_FORMAT);\n  }\n  return configurationParsed;\n}\n"],"mappings":";;;;;;;;;;;;;;AAYA,IAAM,WAAA,GAAA,MAAA,SAAmB,yBAAyB;;;;;AAMlD,SAAgB,gBAAgB,YAI9B;AACA,SAAM,wBAAwB,WAAW;AACzC,KAAI,CAAC,qBAAA,WAAW,WAAW,CACzB,OAAM,IAAI,MAAM,8CAA8C;AAEhE,SAAM,2BAA2B,WAAW;AAC5C,KAAI;AACF,MAAI,YAAY,KAAK,WAAW,EAAE;GAChC,MAAM,aAAa,QAAA,QAAK,KAAK,QAAA,QAAG,aAAa,YAAY,OAAO,EAAE,EAChE,QAAQ,OACT,CAAC;AAEF,UAAO,OAAO,OAAO,EAAE,EAAE,YAAY;IACnC;IAEA,aAAa;IACd,CAAC;;EAGJ,MAAM,aAAa,QAAQ,WAAW;AACtC,SAAO,OAAO,OAAO,EAAE,EAAE,YAAY;GACnC;GAEA,aAAa;GACd,CAAC;UACK,GAAQ;AACf,MAAI,EAAE,SAAS,oBAAoB;AACjC,WAAM,wCAAwC,YAAY,EAAE,QAAQ;AACpE,SAAM,MAAM,gBAAA,UAAU,iBAAiB;;AAGzC,QAAM;;;AAIV,SAAgB,aAAa,QAA4C;AACvE,SAAM,mCAAmC;AACzC,MAAA,GAAA,UAAA,UAAa,OAAO,CAClB,QAAO,QAAA,QAAK,KAAK,OAAO;KAExB,OAAM,IAAI,MAAM,+BAA+B;;;;;;;;;;;;;;;;AAkBnD,SAAgB,gBAAgB,QAA0C;AACxE,SAAM,0CAA0C,OAAO,OAAO;CAC9D,IAAI;AACJ,KAAI,WAAW,KAAA,KAAa,OAAO,WAAW,UAAU;AACtD,UAAM,8BAA8B;EACpC,MAAM,qBAAqB,oBAAA,eAAe,OAAO;AACjD,wBAAsB,gBAAgB,mBAAmB;AAGzD,MAAI,CAAC,oBAAoB,WAAW;AAClC,WAAM,oDAAoD;AAG1D,uBAAoB,YAAY,UAAA,QAAK,QAAQ,mBAAmB;;YAEzD,OAAO,WAAW,YAAY,WAAW,MAAM;AACxD,wBAAsB;AAItB,MAAI,CAAC,oBAAoB,WACvB,qBAAoB,aAAa,QAAQ,KAAK;AAIhD,MAAI,CAAC,oBAAoB,WAAW;AAClC,WAAM,oDAAoD;AAG1D,uBAAoB,YAAY,oBAAoB;;OAGtD,OAAM,IAAI,MAAM,gBAAA,UAAU,kBAAkB;AAE9C,QAAO"}

package/build/parse.mjs

@@ -70,6 +70,7 @@ function getConfigParsed(config) {
 		}
 	} else if (typeof config === "object" && config !== null) {
 		configurationParsed = config;
+		if (!configurationParsed.configPath) configurationParsed.configPath = process.cwd();
 		if (!configurationParsed.self_path) {
 			debug("self_path not defined, using config path location");
 			configurationParsed.self_path = configurationParsed.configPath;

package/build/parse.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parse.mjs","names":[],"sources":["../src/parse.ts"],"sourcesContent":["import buildDebug from 'debug';\nimport YAML from 'js-yaml';\nimport { isObject } from 'lodash-es';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport { API_ERROR, APP_ERROR } from '@verdaccio/core';\nimport type { ConfigYaml } from '@verdaccio/types';\n\nimport { findConfigFile } from './config-path';\nimport { fileExists } from './config-utils';\n\nconst debug = buildDebug('verdaccio:config:parse');\n\n/**\n * Parse a config file from yaml to JSON.\n * @param configPath the absolute path of the configuration file\n */\nexport function parseConfigFile(configPath: string): ConfigYaml & {\n  // @deprecated use configPath instead\n  config_path: string;\n  configPath: string;\n} {\n  debug('parse config file %s', configPath);\n  if (!fileExists(configPath)) {\n    throw new Error(`config file does not exist or not reachable`);\n  }\n  debug('parsing config file: %o', configPath);\n  try {\n    if (/\\.ya?ml$/i.test(configPath)) {\n      const yamlConfig = YAML.load(fs.readFileSync(configPath, 'utf8'), {\n        strict: false,\n      }) as ConfigYaml;\n\n      return Object.assign({}, yamlConfig, {\n        configPath,\n        // @deprecated use configPath instead\n        config_path: configPath,\n      });\n    }\n\n    const jsonConfig = require(configPath) as ConfigYaml;\n    return Object.assign({}, jsonConfig, {\n      configPath,\n      // @deprecated use configPath instead\n      config_path: configPath,\n    });\n  } catch (e: any) {\n    if (e.code !== 'MODULE_NOT_FOUND') {\n      debug('config module not found %o error: %o', configPath, e.message);\n      throw Error(APP_ERROR.CONFIG_NOT_VALID);\n    }\n\n    throw e;\n  }\n}\n\nexport function fromJStoYAML(config: Partial<ConfigYaml>): string | null {\n  debug('convert config from JSON to YAML');\n  if (isObject(config)) {\n    return YAML.dump(config);\n  } else {\n    throw new Error(`config is not a valid object`);\n  }\n}\n\n/**\n * Parses and returns a configuration object of type `ConfigYaml`.\n *\n * If a string or `undefined` is provided, it is interpreted as a path to a config file\n * (or uses a default location). The config file is then loaded and parsed.\n * If an object is provided, it is assumed to be a pre-parsed configuration.\n * Backward compability: ensures the returned configuration object has a `self_path` property set,\n * either to the config file path or to a property within the object.\n *\n * @param {string | ConfigYaml} [config] - Optional. A path to the configuration file (string),\n *                                         a pre-parsed config object, or `undefined`.\n * @returns {ConfigYaml} The parsed configuration object with a guaranteed `self_path` property.\n * @throws {Error} If the provided config is neither a string, undefined, nor an object.\n */\nexport function getConfigParsed(config?: string | ConfigYaml): ConfigYaml {\n  debug('getConfigParsed called with config: %o', typeof config);\n  let configurationParsed: ConfigYaml;\n  if (config === undefined || typeof config === 'string') {\n    debug('using default configuration');\n    const configPathLocation = findConfigFile(config);\n    configurationParsed = parseConfigFile(configPathLocation);\n\n    // @ts-expect-error\n    if (!configurationParsed.self_path) {\n      debug('self_path not defined, using config path location');\n\n      // @ts-expect-error\n      configurationParsed.self_path = path.resolve(configPathLocation);\n    }\n  } else if (typeof config === 'object' && config !== null) {\n    configurationParsed = config;\n\n    // @ts-expect-error\n    if (!configurationParsed.self_path) {\n      debug('self_path not defined, using config path location');\n\n      // @ts-expect-error\n      configurationParsed.self_path = configurationParsed.configPath;\n    }\n  } else {\n    throw new Error(API_ERROR.CONFIG_BAD_FORMAT);\n  }\n  return configurationParsed;\n}\n"],"mappings":";;;;;;;;;;AAYA,IAAM,QAAQ,WAAW,yBAAyB;;;;;AAMlD,SAAgB,gBAAgB,YAI9B;AACA,OAAM,wBAAwB,WAAW;AACzC,KAAI,CAAC,WAAW,WAAW,CACzB,OAAM,IAAI,MAAM,8CAA8C;AAEhE,OAAM,2BAA2B,WAAW;AAC5C,KAAI;AACF,MAAI,YAAY,KAAK,WAAW,EAAE;GAChC,MAAM,aAAa,KAAK,KAAK,GAAG,aAAa,YAAY,OAAO,EAAE,EAChE,QAAQ,OACT,CAAC;AAEF,UAAO,OAAO,OAAO,EAAE,EAAE,YAAY;IACnC;IAEA,aAAa;IACd,CAAC;;EAGJ,MAAM,aAAA,UAAqB,WAAW;AACtC,SAAO,OAAO,OAAO,EAAE,EAAE,YAAY;GACnC;GAEA,aAAa;GACd,CAAC;UACK,GAAQ;AACf,MAAI,EAAE,SAAS,oBAAoB;AACjC,SAAM,wCAAwC,YAAY,EAAE,QAAQ;AACpE,SAAM,MAAM,UAAU,iBAAiB;;AAGzC,QAAM;;;AAIV,SAAgB,aAAa,QAA4C;AACvE,OAAM,mCAAmC;AACzC,KAAI,SAAS,OAAO,CAClB,QAAO,KAAK,KAAK,OAAO;KAExB,OAAM,IAAI,MAAM,+BAA+B;;;;;;;;;;;;;;;;AAkBnD,SAAgB,gBAAgB,QAA0C;AACxE,OAAM,0CAA0C,OAAO,OAAO;CAC9D,IAAI;AACJ,KAAI,WAAW,KAAA,KAAa,OAAO,WAAW,UAAU;AACtD,QAAM,8BAA8B;EACpC,MAAM,qBAAqB,eAAe,OAAO;AACjD,wBAAsB,gBAAgB,mBAAmB;AAGzD,MAAI,CAAC,oBAAoB,WAAW;AAClC,SAAM,oDAAoD;AAG1D,uBAAoB,YAAY,KAAK,QAAQ,mBAAmB;;YAEzD,OAAO,WAAW,YAAY,WAAW,MAAM;AACxD,wBAAsB;AAGtB,MAAI,CAAC,oBAAoB,WAAW;AAClC,SAAM,oDAAoD;AAG1D,uBAAoB,YAAY,oBAAoB;;OAGtD,OAAM,IAAI,MAAM,UAAU,kBAAkB;AAE9C,QAAO"}
+{"version":3,"file":"parse.mjs","names":[],"sources":["../src/parse.ts"],"sourcesContent":["import buildDebug from 'debug';\nimport YAML from 'js-yaml';\nimport { isObject } from 'lodash-es';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport { API_ERROR, APP_ERROR } from '@verdaccio/core';\nimport type { ConfigYaml } from '@verdaccio/types';\n\nimport { findConfigFile } from './config-path';\nimport { fileExists } from './config-utils';\n\nconst debug = buildDebug('verdaccio:config:parse');\n\n/**\n * Parse a config file from yaml to JSON.\n * @param configPath the absolute path of the configuration file\n */\nexport function parseConfigFile(configPath: string): ConfigYaml & {\n  // @deprecated use configPath instead\n  config_path: string;\n  configPath: string;\n} {\n  debug('parse config file %s', configPath);\n  if (!fileExists(configPath)) {\n    throw new Error(`config file does not exist or not reachable`);\n  }\n  debug('parsing config file: %o', configPath);\n  try {\n    if (/\\.ya?ml$/i.test(configPath)) {\n      const yamlConfig = YAML.load(fs.readFileSync(configPath, 'utf8'), {\n        strict: false,\n      }) as ConfigYaml;\n\n      return Object.assign({}, yamlConfig, {\n        configPath,\n        // @deprecated use configPath instead\n        config_path: configPath,\n      });\n    }\n\n    const jsonConfig = require(configPath) as ConfigYaml;\n    return Object.assign({}, jsonConfig, {\n      configPath,\n      // @deprecated use configPath instead\n      config_path: configPath,\n    });\n  } catch (e: any) {\n    if (e.code !== 'MODULE_NOT_FOUND') {\n      debug('config module not found %o error: %o', configPath, e.message);\n      throw Error(APP_ERROR.CONFIG_NOT_VALID);\n    }\n\n    throw e;\n  }\n}\n\nexport function fromJStoYAML(config: Partial<ConfigYaml>): string | null {\n  debug('convert config from JSON to YAML');\n  if (isObject(config)) {\n    return YAML.dump(config);\n  } else {\n    throw new Error(`config is not a valid object`);\n  }\n}\n\n/**\n * Parses and returns a configuration object of type `ConfigYaml`.\n *\n * If a string or `undefined` is provided, it is interpreted as a path to a config file\n * (or uses a default location). The config file is then loaded and parsed.\n * If an object is provided, it is assumed to be a pre-parsed configuration.\n * Backward compability: ensures the returned configuration object has a `self_path` property set,\n * either to the config file path or to a property within the object.\n *\n * @param {string | ConfigYaml} [config] - Optional. A path to the configuration file (string),\n *                                         a pre-parsed config object, or `undefined`.\n * @returns {ConfigYaml} The parsed configuration object with a guaranteed `self_path` property.\n * @throws {Error} If the provided config is neither a string, undefined, nor an object.\n */\nexport function getConfigParsed(config?: string | ConfigYaml): ConfigYaml {\n  debug('getConfigParsed called with config: %o', typeof config);\n  let configurationParsed: ConfigYaml;\n  if (config === undefined || typeof config === 'string') {\n    debug('using default configuration');\n    const configPathLocation = findConfigFile(config);\n    configurationParsed = parseConfigFile(configPathLocation);\n\n    // @ts-expect-error\n    if (!configurationParsed.self_path) {\n      debug('self_path not defined, using config path location');\n\n      // @ts-expect-error\n      configurationParsed.self_path = path.resolve(configPathLocation);\n    }\n  } else if (typeof config === 'object' && config !== null) {\n    configurationParsed = config;\n\n    // When config is provided as an object (programmatic API), ensure configPath\n    // is set so the Config constructor does not throw.\n    if (!configurationParsed.configPath) {\n      configurationParsed.configPath = process.cwd();\n    }\n\n    // @ts-expect-error\n    if (!configurationParsed.self_path) {\n      debug('self_path not defined, using config path location');\n\n      // @ts-expect-error\n      configurationParsed.self_path = configurationParsed.configPath;\n    }\n  } else {\n    throw new Error(API_ERROR.CONFIG_BAD_FORMAT);\n  }\n  return configurationParsed;\n}\n"],"mappings":";;;;;;;;;;AAYA,IAAM,QAAQ,WAAW,yBAAyB;;;;;AAMlD,SAAgB,gBAAgB,YAI9B;AACA,OAAM,wBAAwB,WAAW;AACzC,KAAI,CAAC,WAAW,WAAW,CACzB,OAAM,IAAI,MAAM,8CAA8C;AAEhE,OAAM,2BAA2B,WAAW;AAC5C,KAAI;AACF,MAAI,YAAY,KAAK,WAAW,EAAE;GAChC,MAAM,aAAa,KAAK,KAAK,GAAG,aAAa,YAAY,OAAO,EAAE,EAChE,QAAQ,OACT,CAAC;AAEF,UAAO,OAAO,OAAO,EAAE,EAAE,YAAY;IACnC;IAEA,aAAa;IACd,CAAC;;EAGJ,MAAM,aAAA,UAAqB,WAAW;AACtC,SAAO,OAAO,OAAO,EAAE,EAAE,YAAY;GACnC;GAEA,aAAa;GACd,CAAC;UACK,GAAQ;AACf,MAAI,EAAE,SAAS,oBAAoB;AACjC,SAAM,wCAAwC,YAAY,EAAE,QAAQ;AACpE,SAAM,MAAM,UAAU,iBAAiB;;AAGzC,QAAM;;;AAIV,SAAgB,aAAa,QAA4C;AACvE,OAAM,mCAAmC;AACzC,KAAI,SAAS,OAAO,CAClB,QAAO,KAAK,KAAK,OAAO;KAExB,OAAM,IAAI,MAAM,+BAA+B;;;;;;;;;;;;;;;;AAkBnD,SAAgB,gBAAgB,QAA0C;AACxE,OAAM,0CAA0C,OAAO,OAAO;CAC9D,IAAI;AACJ,KAAI,WAAW,KAAA,KAAa,OAAO,WAAW,UAAU;AACtD,QAAM,8BAA8B;EACpC,MAAM,qBAAqB,eAAe,OAAO;AACjD,wBAAsB,gBAAgB,mBAAmB;AAGzD,MAAI,CAAC,oBAAoB,WAAW;AAClC,SAAM,oDAAoD;AAG1D,uBAAoB,YAAY,KAAK,QAAQ,mBAAmB;;YAEzD,OAAO,WAAW,YAAY,WAAW,MAAM;AACxD,wBAAsB;AAItB,MAAI,CAAC,oBAAoB,WACvB,qBAAoB,aAAa,QAAQ,KAAK;AAIhD,MAAI,CAAC,oBAAoB,WAAW;AAClC,SAAM,oDAAoD;AAG1D,uBAAoB,YAAY,oBAAoB;;OAGtD,OAAM,IAAI,MAAM,UAAU,kBAAkB;AAE9C,QAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verdaccio/config",
-  "version": "9.0.0-next-9.10",
+  "version": "9.0.0-next-9.12",
   "description": "Verdaccio Configuration",
   "main": "./build/index.js",
   "types": "build/index.d.ts",
@@ -33,7 +33,7 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@verdaccio/core": "9.0.0-next-9.10",
+    "@verdaccio/core": "9.0.0-next-9.12",
     "debug": "4.4.3",
     "js-yaml": "4.1.1",
     "lodash-es": "4.17.23"