@cqse/commons 1.0.0-beta.7 → 1.0.5

package/lib/index.cjs

@@ -0,0 +1,7 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`node:process`);c=s(c);let l=require(`node:crypto`);var u=class extends Error{constructor(e){super(`Implement me!`),this._implementMeFor=e}get message(){return this._implementMeFor?`Implement me for: ${this._implementMeFor}`:`Implement me!`}},d=class extends Error{},f=class extends Error{},p=class extends Error{},m=class{static require(e,t){if(!e)throw new f(t)}static requireDefined(e,t){if(e||typeof e==`number`||typeof e==`boolean`||typeof e==`string`||e instanceof String)return e;throw t?new f(t):new f(`Reference must be defined.`)}static requireNonEmpty(e,t){if(this.requireDefined(e),e.length===0)throw new f(t);return e}static requireStringPattern(e,t,n){if(this.requireDefined(e),this.requireDefined(t),!e.match(t))throw new f(n);return e}};function h(e,t){return t.startsWith(e)?t.substring(e.length):t}const g={order:999,title:`Application`};function _(e){if(e.type===`int`||e.type===`string`)return 1;if(e.type===`bool`)return 0;if(e.type===`string[]`)return 1/0;throw new p(`Unsupported parameter type "${e.type}" for parameter "${e.longParameter}".`)}function v(e){return e.replace(/^-+/,``).replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function y(e){return e.replace(/^--/,``).toUpperCase().replace(/-/g,`_`)}var b=class e{constructor(){this.parameters=new Map,this.shortToLongParameterMap=new Map,this.sequentialParameters=[],this.argumentChecks=[]}addParameter(e,t,n,r={}){let i=v(t),a=y(t);this.describeParameter(i,{parameterId:i,longParameter:t,type:n,shortParameter:e,help:r.help??``,default:r.default,internal:r.internal??!1,group:r.group,environmentVariableName:a})}addArgumentCheck(e){this.argumentChecks.push(e)}addRequiredArgumentFor(e){let t=this.lookupParameter(e);if(t===void 0)throw new p(`Unknown parameter "${e}".`);if(t.default!==void 0)throw new p(`Parameter "${e}" is required, but has a default value.`);this.argumentChecks.push(n=>{if(n[e]===void 0)return`Missing required argument for parameter "${t.longParameter}"\n\tParameter description: ${t.help}`})}describeParameter(e,t){if(this.parameters.set(e,t),t.shortParameter){let n=t.shortParameter.replace(/^-/,``).trim().toLowerCase();if(n.length<1||n.length>3)throw new p(`Short parameter "${n}" is invalid.`);let r=this.shortToLongParameterMap.get(n);if(r!==void 0&&r!==e)throw new p(`Short parameter "${n}" is already mapped to parameter "${r}".`);this.shortToLongParameterMap.set(n,t.parameterId)}t.longParameter.startsWith(`--`)||this.sequentialParameters.push(e)}lookupParameter(e){let t=this.parameters.get(e);if(t===void 0){let n=this.shortToLongParameterMap.get(e);n!==void 0&&(t=this.parameters.get(n))}return t}getParameters(){return Array.from(this.parameters.values())}getArgumentChecks(){return this.argumentChecks}getSequentialParameters(){return this.sequentialParameters}clone(){let t=new e;for(let e of this.parameters.values())t.describeParameter(e.parameterId,e);for(let e of this.argumentChecks)t.addArgumentCheck(e);return t}addAllOf(e){for(let t of e.getParameters())this.describeParameter(t.parameterId,t);for(let t of e.getArgumentChecks())this.addArgumentCheck(t)}};function x(e,t){let n={},r,i=[],a=0;function o(){if(r){if(a<1/0&&a>0)throw new p(`Missing value for parameter "${r.longParameter}".`);if(r.type===`bool`)n[r.parameterId]=!0,r=void 0;else if(r.type===`string[]`){let e=n[r.parameterId],t=C(i.join(`,`));T(e)?n[r.parameterId]=e.concat(t):n[r.parameterId]=t}else{if(i.length!==1)throw new p(`Invalid value for parameter "${r.longParameter}": Expected a single value, got ${i.length}.`);n[r.parameterId]=w(i[0],r)}r=void 0,i=[]}}for(let n of e){if(n.startsWith(`-`)){o();let e=v(n);if(r=t.lookupParameter(e),!r)throw new p(`Unknown configuration parameter: ${n}`);a=_(r)}else{if(!r)throw new p(`Unexpected or unnamed argument, or unknown parameter '${n}' supplied. Please specify a parameter name (for example, --input) for each argument.`);i.push(n),a--}a===0&&o()}o();for(let e of t.getParameters())if(n[e.parameterId]===void 0){n[e.parameterId]=e.default;let t=c.default.env[e.environmentVariableName];t&&!e.disableEnvironmentVariableOverride&&(n[e.parameterId]=w(t,e))}return n}function S(e){return e=e.trim(),e.startsWith(`"`)&&e.endsWith(`"`)||e.startsWith(`'`)&&e.endsWith(`'`)||e.startsWith("`")&&e.endsWith("`")?e.substring(1,e.length-1):e}function C(e){return e?e.split(`,`).map(e=>S(e)):[]}function w(e,t){if(t.type===`int`){let n=parseInt(e,10);if(isNaN(n))throw new p(`Invalid value for parameter "${t.longParameter}": Expected an integer, got "${e}".`);return n}else if(t.type===`bool`){let n=e.toLowerCase();if(n===`true`||n===`1`)return!0;if(n===`false`||n===`0`)return!1;throw new p(`Invalid value for parameter "${t.longParameter}": Expected a boolean, got "${e}".`)}else if(t.type===`string`)return S(e);else if(t.type===`string[]`)return C(e);else throw new p(`Unsupported parameter type "${t.type}" for parameter "${t.longParameter}".`)}function T(e){return Array.isArray(e)&&e.every(e=>typeof e==`string`)}function E(e,t){let n={},r=[];for(let i of e.split(`
+`)){let e=i.trim();if(e.startsWith(`#`)||e.length===0)continue;if(!e.includes(`=`)&&t.getSequentialParameters().length>0){r.push(e);continue}let[a,o]=e.split(`=`),s=v(a),c=t.lookupParameter(s);if(c)if(T(n[s])&&c.type===`string[]`){let e=w(o,c);if(T(e))n[s]=n[s].concat(e);else throw new p(`Invalid value for parameter "${c.longParameter}": Expected a list of strings, got "${o}".`)}else n[s]=w(o,c);else throw new p(`Unknown configuration parameter: ${a}`)}return{options:n,unnamedArguments:r}}function D(e,t,n=!1){let r=[];t&&(r.push(t),r.push(``)),n||r.push(`Usage:`);let i=A(e);for(let e of i){e.groupTitle&&(r.push(``),r.push(`# ${e.groupTitle}`),r.push(``)),e.groupHint&&(r.push(O(e.groupHint,80)),r.push(``));for(let t of e.parameters){if(t.internal)continue;function e(){let e=t.environmentVariableName;return t.type===`bool`?``:t.type===`string[]`?` ${e}, .., ${e}`:` ${e}`}let i=[];n?i.push(`Parameter "${t.parameterId}" (${t.type})`):(t.shortParameter&&i.push(`${t.shortParameter}${e()}`),i.push(`${t.longParameter}${e()}`));let a=k(O(t.help,80)),o=t.default?`Default: ${t.default}`:void 0;r.push(`  ${i.join(`, `)}`),a&&r.push(`\t${a}`),o&&r.push(`\t${o}`)}}r.push(``),console.log(r.join(`
+`))}function O(e,t){e=e.replace(/\n/g,` `);let n=e.split(` `),r=[],i=``;for(let e of n)i.length+e.length+1>t&&(r.push(i),i=``),i.length>0&&(i+=` `),i+=e;return i.length>0&&r.push(i),r.join(`
+`)}function k(e){if(e)return e.replace(/\n/g,`
+	`)}function A(e){let t=new Map,n=new Map,r=new Map;for(let i of e.getParameters()){let e=i.group?.title;i.group&&n.set(e,i.group.order),i.group?.hints&&r.set(e,i.group?.hints);let a=t.get(e)||[];a.push(i),t.set(e,a)}return Array.from(t.entries()).sort(([e],[t])=>(n.get(e)??Number.MAX_VALUE)-(n.get(t)??Number.MAX_VALUE)).map(([e,t])=>({groupTitle:e,groupHint:r.get(e),parameters:t.sort((e,t)=>e.longParameter.localeCompare(t.longParameter))}))}function j(e,t,n){let r=!0;n||=e=>{console.error(e)};for(let i of e.getArgumentChecks()){let e=i(t);e&&(n(`Invalid configuration: `+e),r=!1)}return r}function M(e,t,n,r){n??=c.default.argv.slice(2);let i=e.clone();i.addParameter(`-h`,`--help`,`bool`,{help:`Show this help message and exit.`,group:g,disableEnvironmentVariableOverride:!0}),i.addParameter(`-v`,`--version`,`bool`,{help:`Show the version number and exit.`,group:g,disableEnvironmentVariableOverride:!0});let a=x(n,i);return a.version&&(console.log(`${t.name} v${t.version}`),c.default.exit(0)),a.help&&(D(i,t.about),c.default.exit(0)),r&&r(a),j(i,a)||(console.error(`
+Arguments were missing or invalid. Please check the --help for more information. Exiting with error code 1.`),c.default.exit(1)),a}function N(e,t){let n=e.clone();return n.addAllOf(t),n}var P=class e{constructor(e,t,n,r){this.baseConfiguration=m.requireDefined(n),this.redefinableParameters=m.requireDefined(t),this.allParameters=m.requireDefined(e),this.overwrites=r??{},this.hash=void 0}get(e){return this.assertParameterExists(e),this.overwrites[e]??this.baseConfiguration[e]}set(e,t){if(this.redefinableParameters.lookupParameter(e)===void 0)throw Error(`Unknown configuration parameter: ${e}`);this.overwriteConfig(e,t),this.hash=void 0}overwriteConfig(e,t){let n=v(e);if(this.assertParameterExists(n),t===void 0){delete this.overwrites[n];return}this.overwrites[n]=this.castConfigArgument(n,t),this.hash=void 0}castConfigArgument(e,t){let n=this.getParameter(e).type;if(n===`int`){if(typeof t==`number`)return Math.floor(t);if(typeof t==`string`)return parseInt(t,10);if(typeof t==`boolean`)return t?1:0}else if(n===`bool`){if(typeof t==`boolean`)return t;if(typeof t==`string`)return t.toLowerCase()===`true`;if(typeof t==`number`)return t!==0}else if(n===`string[]`){if(t===void 0||t==null)return[];if(Array.isArray(t))return t.map(String);if(typeof t==`string`)return t.split(`,`).map(e=>e.trim())}else return String(t);throw Error(`Cannot cast value of type ${typeof t} to ${n}`)}assertParameterExists(e){if(this.allParameters.lookupParameter(e)===void 0)throw Error(`Unknown configuration parameter: ${e}`)}getParameter(e){let t=this.redefinableParameters.lookupParameter(e);if(t===void 0)throw Error(`Unknown configuration parameter: ${e}`);return t}getHash(){if(this.hash===void 0){let e=(0,l.createHash)(`sha256`);for(let[t,n]of Object.entries(this.baseConfiguration))e.update(t),e.update(String(n));for(let[t,n]of Object.entries(this.overwrites))e.update(t),e.update(String(n));this.hash=e.digest(`hex`)}return this.hash}copy(){let t=JSON.parse(JSON.stringify(this.overwrites));return new e(this.allParameters,this.redefinableParameters,this.baseConfiguration,t)}};function F(e){return new Proxy(e,{get(t,n){return e.get(n.toString())},set(t,n,r){return e.set(n.toString(),r),!0}})}const I={order:1,title:`Collector Connectivity`},L={order:1,title:`Teamscale Server`},R={order:2,title:`Upload to Teamscale`,hints:"NOTE: We generally recommend to set these parameters per app during the instrumentation process, that is, on the instrumenter side, for example, by setting `--config-id` or specifying single options via `--collector-option`. The following parameters are supposed to take effect if the application is instrumented with the `--coverage-target-from-collector` flag."},z={order:3,title:`Coverage Dumping`},B={order:4,title:`Upload to Artifactory`},V={order:5,title:`Logging Behavior`};function H(){let e=new b;function t(t,n,r,i){e.addParameter(t,n,r,i)}return t(`-k`,`--keep-coverage-files`,`bool`,{help:`Whether to keep the coverage files on disk after a successful upload to Teamscale.`,default:!1,group:z}),t(`-t`,`--dump-after-mins`,`int`,{help:`Dump the coverage information every N minutes.`,default:120,group:z}),t(void 0,`--artifactory-server-url`,`string`,{help:`Upload the coverage to the given Artifactory server URL. The URL may include a subpath on the artifactory server, e.g. https://artifactory.acme.com/my-repo/my/subpath`,group:B}),t(void 0,`--artifactory-user`,`string`,{help:`The user for uploading coverage to Artifactory. Only needed when not using the --artifactory-access-token option`,group:B}),t(void 0,`--artifactory-password`,`string`,{help:`The password for uploading coverage to Artifactory. Only needed when not using the --artifactory-access-token option`,group:B}),t(void 0,`--artifactory-access-token`,`string`,{help:`The access_token for uploading coverage to Artifactory.`,group:B}),t(void 0,`--artifactory-path-suffix`,`string`,{help:`(optional): The path within the storage location between the default path and the uploaded artifact.`,group:B}),t(void 0,`--teamscale-project`,`string`,{help:`The project ID to upload coverage to.`,group:R}),t(void 0,`--teamscale-partition`,`string`,{help:`The partition to upload coverage to.`,group:R}),t(void 0,`--teamscale-repository`,`string`,{help:`The repository to upload coverage for. Optional: Only needed when uploading via revision to a project that has more than one connector.`,group:R}),t(void 0,`--teamscale-message`,`string`,{help:`The commit message shown within Teamscale for the coverage upload.`,default:`JavaScript coverage upload`,group:R}),e}function U(){let e=H();function t(t,n,r,i){e.addParameter(t,n,r,i)}return t(`-p`,`--port`,`int`,{help:`The port to receive coverage information on.`,default:54678,group:I,disableEnvironmentVariableOverride:!0}),t(`-l`,`--log-to-file`,`string`,{help:`Log file`,default:`logs/collector-combined.log`,group:V,disableEnvironmentVariableOverride:!0}),t(`-e`,`--log-level`,`string`,{help:`Log level`,default:`info`,group:V,disableEnvironmentVariableOverride:!0}),t(`-j`,`--json-log`,`bool`,{help:`Additional JSON-like log file format.`,group:V,disableEnvironmentVariableOverride:!0}),t(`-c`,`--enable-control-port`,`int`,{help:`Enables the remote control API on the specified port (<=0 means "disabled").`,default:0,group:I}),t(`-s`,`--teamscale-server-url`,`string`,{help:`Upload the coverage to the given Teamscale server URL, for example, https://teamscale.dev.example.com:8080/production.`,group:L}),t(`-u`,`--teamscale-user`,`string`,{help:`The user for uploading coverage to Teamscale.`,group:L}),t(`-a`,`--teamscale-access-token`,`string`,{help:`The API key to use for uploading to Teamscale.`,group:L}),t(void 0,`--http-proxy`,`string`,{help:`(optional): The HTTP/HTTPS proxy address that should be used in the format: http://host:port/ or http://username:password@host:port/.`,group:I}),t(`-f`,`--dump-folder`,`string`,{help:`Target folder for coverage files.`,default:`./coverage`,group:z}),e.addArgumentCheck(e=>{if(e.teamscaleServerUrl&&(!e.teamscaleUser||!e.teamscaleAccessToken))return`The Teamscale user name and access token must be given if the Teamscale server URL is given.`}),e}function W(){let e=H();function t(t,n,r,i){e.addParameter(t,n,r,i)}function n(e,n,r){t(void 0,e,n,r)}return n(`--dump-to-folder`,`string`,{help:`Coverage should be dumped to a folder on the server that the collector is running on.
+Specifies the name of the subfolder within the collector's dump folder (--dump-folder of the collector) where coverage files should be placed.`,group:z}),e}function G(e){if(typeof e==`string`){if(/^[a-zA-Z0-9_-]+:([0-9]+|HEAD|head)$/.test(e))return!0;if(/^[0-9]+$/.test(e))return!1;if(/^[a-zA-Z0-9]{7,40}$/.test(e))return!0}return!1}exports.CONFIG_GROUP_APP=g,exports.ConfigurationParameters=b,exports.ConfigurationWithOverwrites=P,exports.Contract=m,exports.IllegalArgumentException=f,exports.IllegalStateException=d,exports.ImplementMeException=u,exports.InvalidConfigurationException=p,exports.buildPredefinableParameters=H,exports.buildReconfigurableCollectorParameters=W,exports.buildStaticCollectorParameters=U,exports.checkArguments=j,exports.isValidCommitInfo=G,exports.longParameterToEnvironmentVariableName=y,exports.makeConfigProxy=F,exports.parameterNameToParameterId=v,exports.parameterUnion=N,exports.parseArguments=x,exports.parseConfigFile=E,exports.printHelp=D,exports.processCommandLine=M,exports.removePrefix=h;

package/lib/index.mjs

@@ -0,0 +1,8 @@
+import e from"node:process";import{createHash as t}from"node:crypto";var n=class extends Error{constructor(e){super(`Implement me!`),this._implementMeFor=e}get message(){return this._implementMeFor?`Implement me for: ${this._implementMeFor}`:`Implement me!`}},r=class extends Error{},i=class extends Error{},a=class extends Error{},o=class{static require(e,t){if(!e)throw new i(t)}static requireDefined(e,t){if(e||typeof e==`number`||typeof e==`boolean`||typeof e==`string`||e instanceof String)return e;throw t?new i(t):new i(`Reference must be defined.`)}static requireNonEmpty(e,t){if(this.requireDefined(e),e.length===0)throw new i(t);return e}static requireStringPattern(e,t,n){if(this.requireDefined(e),this.requireDefined(t),!e.match(t))throw new i(n);return e}};function s(e,t){return t.startsWith(e)?t.substring(e.length):t}const c={order:999,title:`Application`};function l(e){if(e.type===`int`||e.type===`string`)return 1;if(e.type===`bool`)return 0;if(e.type===`string[]`)return 1/0;throw new a(`Unsupported parameter type "${e.type}" for parameter "${e.longParameter}".`)}function u(e){return e.replace(/^-+/,``).replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function d(e){return e.replace(/^--/,``).toUpperCase().replace(/-/g,`_`)}var f=class e{constructor(){this.parameters=new Map,this.shortToLongParameterMap=new Map,this.sequentialParameters=[],this.argumentChecks=[]}addParameter(e,t,n,r={}){let i=u(t),a=d(t);this.describeParameter(i,{parameterId:i,longParameter:t,type:n,shortParameter:e,help:r.help??``,default:r.default,internal:r.internal??!1,group:r.group,environmentVariableName:a})}addArgumentCheck(e){this.argumentChecks.push(e)}addRequiredArgumentFor(e){let t=this.lookupParameter(e);if(t===void 0)throw new a(`Unknown parameter "${e}".`);if(t.default!==void 0)throw new a(`Parameter "${e}" is required, but has a default value.`);this.argumentChecks.push(n=>{if(n[e]===void 0)return`Missing required argument for parameter "${t.longParameter}"\n\tParameter description: ${t.help}`})}describeParameter(e,t){if(this.parameters.set(e,t),t.shortParameter){let n=t.shortParameter.replace(/^-/,``).trim().toLowerCase();if(n.length<1||n.length>3)throw new a(`Short parameter "${n}" is invalid.`);let r=this.shortToLongParameterMap.get(n);if(r!==void 0&&r!==e)throw new a(`Short parameter "${n}" is already mapped to parameter "${r}".`);this.shortToLongParameterMap.set(n,t.parameterId)}t.longParameter.startsWith(`--`)||this.sequentialParameters.push(e)}lookupParameter(e){let t=this.parameters.get(e);if(t===void 0){let n=this.shortToLongParameterMap.get(e);n!==void 0&&(t=this.parameters.get(n))}return t}getParameters(){return Array.from(this.parameters.values())}getArgumentChecks(){return this.argumentChecks}getSequentialParameters(){return this.sequentialParameters}clone(){let t=new e;for(let e of this.parameters.values())t.describeParameter(e.parameterId,e);for(let e of this.argumentChecks)t.addArgumentCheck(e);return t}addAllOf(e){for(let t of e.getParameters())this.describeParameter(t.parameterId,t);for(let t of e.getArgumentChecks())this.addArgumentCheck(t)}};function p(t,n){let r={},i,o=[],s=0;function c(){if(i){if(s<1/0&&s>0)throw new a(`Missing value for parameter "${i.longParameter}".`);if(i.type===`bool`)r[i.parameterId]=!0,i=void 0;else if(i.type===`string[]`){let e=r[i.parameterId],t=h(o.join(`,`));_(e)?r[i.parameterId]=e.concat(t):r[i.parameterId]=t}else{if(o.length!==1)throw new a(`Invalid value for parameter "${i.longParameter}": Expected a single value, got ${o.length}.`);r[i.parameterId]=g(o[0],i)}i=void 0,o=[]}}for(let e of t){if(e.startsWith(`-`)){c();let t=u(e);if(i=n.lookupParameter(t),!i)throw new a(`Unknown configuration parameter: ${e}`);s=l(i)}else{if(!i)throw new a(`Unexpected or unnamed argument, or unknown parameter '${e}' supplied. Please specify a parameter name (for example, --input) for each argument.`);o.push(e),s--}s===0&&c()}c();for(let t of n.getParameters())if(r[t.parameterId]===void 0){r[t.parameterId]=t.default;let n=e.env[t.environmentVariableName];n&&!t.disableEnvironmentVariableOverride&&(r[t.parameterId]=g(n,t))}return r}function m(e){return e=e.trim(),e.startsWith(`"`)&&e.endsWith(`"`)||e.startsWith(`'`)&&e.endsWith(`'`)||e.startsWith("`")&&e.endsWith("`")?e.substring(1,e.length-1):e}function h(e){return e?e.split(`,`).map(e=>m(e)):[]}function g(e,t){if(t.type===`int`){let n=parseInt(e,10);if(isNaN(n))throw new a(`Invalid value for parameter "${t.longParameter}": Expected an integer, got "${e}".`);return n}else if(t.type===`bool`){let n=e.toLowerCase();if(n===`true`||n===`1`)return!0;if(n===`false`||n===`0`)return!1;throw new a(`Invalid value for parameter "${t.longParameter}": Expected a boolean, got "${e}".`)}else if(t.type===`string`)return m(e);else if(t.type===`string[]`)return h(e);else throw new a(`Unsupported parameter type "${t.type}" for parameter "${t.longParameter}".`)}function _(e){return Array.isArray(e)&&e.every(e=>typeof e==`string`)}function v(e,t){let n={},r=[];for(let i of e.split(`
+`)){let e=i.trim();if(e.startsWith(`#`)||e.length===0)continue;if(!e.includes(`=`)&&t.getSequentialParameters().length>0){r.push(e);continue}let[o,s]=e.split(`=`),c=u(o),l=t.lookupParameter(c);if(l)if(_(n[c])&&l.type===`string[]`){let e=g(s,l);if(_(e))n[c]=n[c].concat(e);else throw new a(`Invalid value for parameter "${l.longParameter}": Expected a list of strings, got "${s}".`)}else n[c]=g(s,l);else throw new a(`Unknown configuration parameter: ${o}`)}return{options:n,unnamedArguments:r}}function y(e,t,n=!1){let r=[];t&&(r.push(t),r.push(``)),n||r.push(`Usage:`);let i=S(e);for(let e of i){e.groupTitle&&(r.push(``),r.push(`# ${e.groupTitle}`),r.push(``)),e.groupHint&&(r.push(b(e.groupHint,80)),r.push(``));for(let t of e.parameters){if(t.internal)continue;function e(){let e=t.environmentVariableName;return t.type===`bool`?``:t.type===`string[]`?` ${e}, .., ${e}`:` ${e}`}let i=[];n?i.push(`Parameter "${t.parameterId}" (${t.type})`):(t.shortParameter&&i.push(`${t.shortParameter}${e()}`),i.push(`${t.longParameter}${e()}`));let a=x(b(t.help,80)),o=t.default?`Default: ${t.default}`:void 0;r.push(`  ${i.join(`, `)}`),a&&r.push(`\t${a}`),o&&r.push(`\t${o}`)}}r.push(``),console.log(r.join(`
+`))}function b(e,t){e=e.replace(/\n/g,` `);let n=e.split(` `),r=[],i=``;for(let e of n)i.length+e.length+1>t&&(r.push(i),i=``),i.length>0&&(i+=` `),i+=e;return i.length>0&&r.push(i),r.join(`
+`)}function x(e){if(e)return e.replace(/\n/g,`
+	`)}function S(e){let t=new Map,n=new Map,r=new Map;for(let i of e.getParameters()){let e=i.group?.title;i.group&&n.set(e,i.group.order),i.group?.hints&&r.set(e,i.group?.hints);let a=t.get(e)||[];a.push(i),t.set(e,a)}return Array.from(t.entries()).sort(([e],[t])=>(n.get(e)??Number.MAX_VALUE)-(n.get(t)??Number.MAX_VALUE)).map(([e,t])=>({groupTitle:e,groupHint:r.get(e),parameters:t.sort((e,t)=>e.longParameter.localeCompare(t.longParameter))}))}function C(e,t,n){let r=!0;n||=e=>{console.error(e)};for(let i of e.getArgumentChecks()){let e=i(t);e&&(n(`Invalid configuration: `+e),r=!1)}return r}function w(t,n,r,i){r??=e.argv.slice(2);let a=t.clone();a.addParameter(`-h`,`--help`,`bool`,{help:`Show this help message and exit.`,group:c,disableEnvironmentVariableOverride:!0}),a.addParameter(`-v`,`--version`,`bool`,{help:`Show the version number and exit.`,group:c,disableEnvironmentVariableOverride:!0});let o=p(r,a);return o.version&&(console.log(`${n.name} v${n.version}`),e.exit(0)),o.help&&(y(a,n.about),e.exit(0)),i&&i(o),C(a,o)||(console.error(`
+Arguments were missing or invalid. Please check the --help for more information. Exiting with error code 1.`),e.exit(1)),o}function T(e,t){let n=e.clone();return n.addAllOf(t),n}var E=class e{constructor(e,t,n,r){this.baseConfiguration=o.requireDefined(n),this.redefinableParameters=o.requireDefined(t),this.allParameters=o.requireDefined(e),this.overwrites=r??{},this.hash=void 0}get(e){return this.assertParameterExists(e),this.overwrites[e]??this.baseConfiguration[e]}set(e,t){if(this.redefinableParameters.lookupParameter(e)===void 0)throw Error(`Unknown configuration parameter: ${e}`);this.overwriteConfig(e,t),this.hash=void 0}overwriteConfig(e,t){let n=u(e);if(this.assertParameterExists(n),t===void 0){delete this.overwrites[n];return}this.overwrites[n]=this.castConfigArgument(n,t),this.hash=void 0}castConfigArgument(e,t){let n=this.getParameter(e).type;if(n===`int`){if(typeof t==`number`)return Math.floor(t);if(typeof t==`string`)return parseInt(t,10);if(typeof t==`boolean`)return t?1:0}else if(n===`bool`){if(typeof t==`boolean`)return t;if(typeof t==`string`)return t.toLowerCase()===`true`;if(typeof t==`number`)return t!==0}else if(n===`string[]`){if(t===void 0||t==null)return[];if(Array.isArray(t))return t.map(String);if(typeof t==`string`)return t.split(`,`).map(e=>e.trim())}else return String(t);throw Error(`Cannot cast value of type ${typeof t} to ${n}`)}assertParameterExists(e){if(this.allParameters.lookupParameter(e)===void 0)throw Error(`Unknown configuration parameter: ${e}`)}getParameter(e){let t=this.redefinableParameters.lookupParameter(e);if(t===void 0)throw Error(`Unknown configuration parameter: ${e}`);return t}getHash(){if(this.hash===void 0){let e=t(`sha256`);for(let[t,n]of Object.entries(this.baseConfiguration))e.update(t),e.update(String(n));for(let[t,n]of Object.entries(this.overwrites))e.update(t),e.update(String(n));this.hash=e.digest(`hex`)}return this.hash}copy(){let t=JSON.parse(JSON.stringify(this.overwrites));return new e(this.allParameters,this.redefinableParameters,this.baseConfiguration,t)}};function D(e){return new Proxy(e,{get(t,n){return e.get(n.toString())},set(t,n,r){return e.set(n.toString(),r),!0}})}const O={order:1,title:`Collector Connectivity`},k={order:1,title:`Teamscale Server`},A={order:2,title:`Upload to Teamscale`,hints:"NOTE: We generally recommend to set these parameters per app during the instrumentation process, that is, on the instrumenter side, for example, by setting `--config-id` or specifying single options via `--collector-option`. The following parameters are supposed to take effect if the application is instrumented with the `--coverage-target-from-collector` flag."},j={order:3,title:`Coverage Dumping`},M={order:4,title:`Upload to Artifactory`},N={order:5,title:`Logging Behavior`};function P(){let e=new f;function t(t,n,r,i){e.addParameter(t,n,r,i)}return t(`-k`,`--keep-coverage-files`,`bool`,{help:`Whether to keep the coverage files on disk after a successful upload to Teamscale.`,default:!1,group:j}),t(`-t`,`--dump-after-mins`,`int`,{help:`Dump the coverage information every N minutes.`,default:120,group:j}),t(void 0,`--artifactory-server-url`,`string`,{help:`Upload the coverage to the given Artifactory server URL. The URL may include a subpath on the artifactory server, e.g. https://artifactory.acme.com/my-repo/my/subpath`,group:M}),t(void 0,`--artifactory-user`,`string`,{help:`The user for uploading coverage to Artifactory. Only needed when not using the --artifactory-access-token option`,group:M}),t(void 0,`--artifactory-password`,`string`,{help:`The password for uploading coverage to Artifactory. Only needed when not using the --artifactory-access-token option`,group:M}),t(void 0,`--artifactory-access-token`,`string`,{help:`The access_token for uploading coverage to Artifactory.`,group:M}),t(void 0,`--artifactory-path-suffix`,`string`,{help:`(optional): The path within the storage location between the default path and the uploaded artifact.`,group:M}),t(void 0,`--teamscale-project`,`string`,{help:`The project ID to upload coverage to.`,group:A}),t(void 0,`--teamscale-partition`,`string`,{help:`The partition to upload coverage to.`,group:A}),t(void 0,`--teamscale-repository`,`string`,{help:`The repository to upload coverage for. Optional: Only needed when uploading via revision to a project that has more than one connector.`,group:A}),t(void 0,`--teamscale-message`,`string`,{help:`The commit message shown within Teamscale for the coverage upload.`,default:`JavaScript coverage upload`,group:A}),e}function F(){let e=P();function t(t,n,r,i){e.addParameter(t,n,r,i)}return t(`-p`,`--port`,`int`,{help:`The port to receive coverage information on.`,default:54678,group:O,disableEnvironmentVariableOverride:!0}),t(`-l`,`--log-to-file`,`string`,{help:`Log file`,default:`logs/collector-combined.log`,group:N,disableEnvironmentVariableOverride:!0}),t(`-e`,`--log-level`,`string`,{help:`Log level`,default:`info`,group:N,disableEnvironmentVariableOverride:!0}),t(`-j`,`--json-log`,`bool`,{help:`Additional JSON-like log file format.`,group:N,disableEnvironmentVariableOverride:!0}),t(`-c`,`--enable-control-port`,`int`,{help:`Enables the remote control API on the specified port (<=0 means "disabled").`,default:0,group:O}),t(`-s`,`--teamscale-server-url`,`string`,{help:`Upload the coverage to the given Teamscale server URL, for example, https://teamscale.dev.example.com:8080/production.`,group:k}),t(`-u`,`--teamscale-user`,`string`,{help:`The user for uploading coverage to Teamscale.`,group:k}),t(`-a`,`--teamscale-access-token`,`string`,{help:`The API key to use for uploading to Teamscale.`,group:k}),t(void 0,`--http-proxy`,`string`,{help:`(optional): The HTTP/HTTPS proxy address that should be used in the format: http://host:port/ or http://username:password@host:port/.`,group:O}),t(`-f`,`--dump-folder`,`string`,{help:`Target folder for coverage files.`,default:`./coverage`,group:j}),e.addArgumentCheck(e=>{if(e.teamscaleServerUrl&&(!e.teamscaleUser||!e.teamscaleAccessToken))return`The Teamscale user name and access token must be given if the Teamscale server URL is given.`}),e}function I(){let e=P();function t(t,n,r,i){e.addParameter(t,n,r,i)}function n(e,n,r){t(void 0,e,n,r)}return n(`--dump-to-folder`,`string`,{help:`Coverage should be dumped to a folder on the server that the collector is running on.
+Specifies the name of the subfolder within the collector's dump folder (--dump-folder of the collector) where coverage files should be placed.`,group:j}),e}function L(e){if(typeof e==`string`){if(/^[a-zA-Z0-9_-]+:([0-9]+|HEAD|head)$/.test(e))return!0;if(/^[0-9]+$/.test(e))return!1;if(/^[a-zA-Z0-9]{7,40}$/.test(e))return!0}return!1}export{c as CONFIG_GROUP_APP,f as ConfigurationParameters,E as ConfigurationWithOverwrites,o as Contract,i as IllegalArgumentException,r as IllegalStateException,n as ImplementMeException,a as InvalidConfigurationException,P as buildPredefinableParameters,I as buildReconfigurableCollectorParameters,F as buildStaticCollectorParameters,C as checkArguments,L as isValidCommitInfo,d as longParameterToEnvironmentVariableName,D as makeConfigProxy,u as parameterNameToParameterId,T as parameterUnion,p as parseArguments,v as parseConfigFile,y as printHelp,w as processCommandLine,s as removePrefix};
+//# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,21 +1,35 @@
 {
   "name": "@cqse/commons",
-  "version": "1.0.0-beta.7",
+  "version": "1.0.5",
   "description": "A collection of generic functionality for TypeScript projects.",
   "author": "CQSE GmbH",
-  "main": "lib/index.js",
+  "main": "lib/index.cjs",
+  "module": "lib/index.mjs",
+  "types": "lib/index.d.cts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./lib/index.d.cts",
+        "default": "./lib/index.cjs"
+      },
+      "import": {
+        "types": "./lib/index.d.mts",
+        "default": "./lib/index.mjs"
+      }
+    }
+  },
   "license": "Apache-2.0",
   "homepage": "https://docs.teamscale.com/howto/setting-up-profiler-tga/javascript/",
   "files": [
-    "dist/**/*",
-    "lib/**/*"
+    "lib/*.mjs",
+    "lib/*.cjs"
   ],
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "tsc",
-    "clean": "rimraf lib tsconfig.tsbuildinfo",
+    "build": "pnpm tsc --noEmit && pnpm tsdown",
+    "clean": "rimraf lib",
     "test": "node --import tsx --test test/**/*.test.ts"
   }
 }

package/lib/CollectorConfig.d.ts

@@ -1,34 +0,0 @@
-import { ConfigurationParameters } from './ConfigParser';
-export type PredefinableOptions = {
-    keepCoverageFiles: boolean;
-    dumpAfterMins: number;
-    artifactoryServerUrl?: string;
-    artifactoryUser?: string;
-    artifactoryPassword?: string;
-    artifactoryAccessToken?: string;
-    artifactoryPathSuffix?: string;
-};
-export type StaticCollectorOptions = PredefinableOptions & {
-    port: number;
-    dumpFolder: string;
-    httpProxy?: string;
-    logLevel: string;
-    logToFile: string;
-    jsonLog: boolean;
-    enableControlPort?: number;
-    teamscaleServerUrl?: string;
-    teamscaleUser?: string;
-    teamscaleAccessToken?: string;
-};
-export type ReconfigurableCollectorOptions = PredefinableOptions & {
-    teamscaleProject?: string;
-    teamscalePartition?: string;
-    teamscaleRepository?: string;
-    teamscaleMessage?: string;
-    dumpToFolder?: string;
-};
-export type CollectorOptions = StaticCollectorOptions & ReconfigurableCollectorOptions;
-export declare function buildPredefinableParameters(): ConfigurationParameters;
-export declare function buildStaticCollectorParameters(): ConfigurationParameters;
-export declare function buildReconfigurableCollectorParameters(): ConfigurationParameters;
-//# sourceMappingURL=CollectorConfig.d.ts.map

package/lib/CollectorConfig.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CollectorConfig.d.ts","sourceRoot":"","sources":["../src/CollectorConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,uBAAuB,EACvB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,mBAAmB,GAAG;IACjC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAA;AAMD,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,GAAG;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AASF,MAAM,MAAM,8BAA8B,GAAG,mBAAmB,GAAG;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAMF,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,8BAA8B,CAAC;AA8CvF,wBAAgB,2BAA2B,IAAI,uBAAuB,CA6DrE;AAQD,wBAAgB,8BAA8B,IAAI,uBAAuB,CAkDxE;AAKD,wBAAgB,sCAAsC,IAAI,uBAAuB,CAoBhF"}

package/lib/CollectorConfig.js

@@ -1,152 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildPredefinableParameters = buildPredefinableParameters;
-exports.buildStaticCollectorParameters = buildStaticCollectorParameters;
-exports.buildReconfigurableCollectorParameters = buildReconfigurableCollectorParameters;
-const ConfigParser_1 = require("./ConfigParser");
-const CONFIG_GROUP_COLLECTOR_CONNECTIVITY = {
-    order: 1,
-    title: 'Collector Connectivity'
-};
-const CONFIG_GROUP_TEAMSCALE_SERVER = {
-    order: 1,
-    title: 'Teamscale Server'
-};
-const CONFIG_GROUP_TEAMSCALE_UPLOAD = {
-    order: 2,
-    title: 'Upload to Teamscale',
-    hints: 'NOTE: We generally recommend to set these parameters per app during ' +
-        'the instrumentation process, that is, on the instrumenter side, for example, ' +
-        'by setting `--config-id` or specifying single options via `--collector-option`. ' +
-        'The following parameters are supposed to take effect if the application ' +
-        'is instrumented with the `--coverage-target-from-collector` flag.'
-};
-const CONFIG_GROUP_COVERAGE_DUMP = {
-    order: 3,
-    title: 'Coverage Dumping'
-};
-const CONFIG_GROUP_ARTIFACTORY_UPLOAD = {
-    order: 4,
-    title: 'Upload to Artifactory'
-};
-const CONFIG_GROUP_LOGGING = {
-    order: 5,
-    title: 'Logging Behavior'
-};
-function buildPredefinableParameters() {
-    const parameters = new ConfigParser_1.ConfigurationParameters();
-    function add(shortParameter, longParameter, type, options) {
-        parameters.addParameter(shortParameter, longParameter, type, options);
-    }
-    add('-k', '--keep-coverage-files', 'bool', {
-        help: 'Whether to keep the coverage files on disk after a successful upload to Teamscale.',
-        default: false,
-        group: CONFIG_GROUP_COVERAGE_DUMP
-    });
-    add('-t', '--dump-after-mins', 'int', {
-        help: 'Dump the coverage information every N minutes.',
-        default: 120,
-        group: CONFIG_GROUP_COVERAGE_DUMP
-    });
-    add(undefined, '--artifactory-server-url', 'string', {
-        help: 'Upload the coverage to the given Artifactory server URL. The URL may include a subpath on the artifactory server, e.g. https://artifactory.acme.com/my-repo/my/subpath',
-        group: CONFIG_GROUP_ARTIFACTORY_UPLOAD
-    });
-    add(undefined, '--artifactory-user', 'string', {
-        help: 'The user for uploading coverage to Artifactory. Only needed when not using the --artifactory-access-token option',
-        group: CONFIG_GROUP_ARTIFACTORY_UPLOAD
-    });
-    add(undefined, '--artifactory-password', 'string', {
-        help: 'The password for uploading coverage to Artifactory. Only needed when not using the --artifactory-access-token option',
-        group: CONFIG_GROUP_ARTIFACTORY_UPLOAD
-    });
-    add(undefined, '--artifactory-access-token', 'string', {
-        help: 'The access_token for uploading coverage to Artifactory.',
-        group: CONFIG_GROUP_ARTIFACTORY_UPLOAD
-    });
-    add(undefined, '--artifactory-path-suffix', 'string', {
-        help: '(optional): The path within the storage location between the default path and the uploaded artifact.',
-        group: CONFIG_GROUP_ARTIFACTORY_UPLOAD
-    });
-    add(undefined, '--teamscale-project', 'string', {
-        help: 'The project ID to upload coverage to.',
-        group: CONFIG_GROUP_TEAMSCALE_UPLOAD
-    });
-    add(undefined, '--teamscale-partition', 'string', {
-        help: 'The partition to upload coverage to.',
-        group: CONFIG_GROUP_TEAMSCALE_UPLOAD
-    });
-    add(undefined, '--teamscale-repository', 'string', {
-        help: 'The repository to upload coverage for. Optional: Only needed when uploading via revision to a project that has more than one connector.',
-        group: CONFIG_GROUP_TEAMSCALE_UPLOAD
-    });
-    add(undefined, '--teamscale-message', 'string', {
-        help: 'The commit message shown within Teamscale for the coverage upload.',
-        default: 'JavaScript coverage upload',
-        group: CONFIG_GROUP_TEAMSCALE_UPLOAD
-    });
-    return parameters;
-}
-function buildStaticCollectorParameters() {
-    const parameters = buildPredefinableParameters();
-    function add(shortParameter, longParameter, type, options) {
-        parameters.addParameter(shortParameter, longParameter, type, options);
-    }
-    add('-p', '--port', 'int', { help: 'The port to receive coverage information on.',
-        default: 54678, group: CONFIG_GROUP_COLLECTOR_CONNECTIVITY, disableEnvironmentVariableOverride: true });
-    add('-l', '--log-to-file', 'string', { help: 'Log file', default: 'logs/collector-combined.log', group: CONFIG_GROUP_LOGGING,
-        disableEnvironmentVariableOverride: true });
-    add('-e', '--log-level', 'string', { help: 'Log level',
-        default: 'info', group: CONFIG_GROUP_LOGGING, disableEnvironmentVariableOverride: true });
-    add('-j', '--json-log', 'bool', { help: 'Additional JSON-like log file format.',
-        group: CONFIG_GROUP_LOGGING, disableEnvironmentVariableOverride: true });
-    add('-c', '--enable-control-port', 'int', {
-        help: 'Enables the remote control API on the specified port (<=0 means "disabled").',
-        default: 0, group: CONFIG_GROUP_COLLECTOR_CONNECTIVITY
-    });
-    add('-s', '--teamscale-server-url', 'string', {
-        help: 'Upload the coverage to the given Teamscale server URL, for example, https://teamscale.dev.example.com:8080/production.',
-        group: CONFIG_GROUP_TEAMSCALE_SERVER
-    });
-    add('-u', '--teamscale-user', 'string', {
-        help: 'The user for uploading coverage to Teamscale.',
-        group: CONFIG_GROUP_TEAMSCALE_SERVER
-    });
-    add('-a', '--teamscale-access-token', 'string', {
-        help: 'The API key to use for uploading to Teamscale.',
-        group: CONFIG_GROUP_TEAMSCALE_SERVER
-    });
-    add(undefined, '--http-proxy', 'string', {
-        help: '(optional): The HTTP/HTTPS proxy address that should be used in the format: http://host:port/ or http://username:password@host:port/.',
-        group: CONFIG_GROUP_COLLECTOR_CONNECTIVITY,
-    });
-    add('-f', '--dump-folder', 'string', {
-        help: 'Target folder for coverage files.',
-        default: './coverage',
-        group: CONFIG_GROUP_COVERAGE_DUMP
-    });
-    parameters.addArgumentCheck((options) => {
-        if (options.teamscaleServerUrl) {
-            if (!options.teamscaleUser || !options.teamscaleAccessToken) {
-                return 'The Teamscale user name and access token must be given if the Teamscale server URL is given.';
-            }
-        }
-    });
-    return parameters;
-}
-function buildReconfigurableCollectorParameters() {
-    const parameters = buildPredefinableParameters();
-    function addShort(shortParameter, longParameter, type, options) {
-        parameters.addParameter(shortParameter, longParameter, type, options);
-    }
-    function add(longArgument, type, options) {
-        addShort(undefined, longArgument, type, options);
-    }
-    add('--dump-to-folder', 'string', {
-        help: 'Coverage should be dumped to a folder on the server that the collector is running on.\n' +
-            'Specifies the name of the subfolder within the collector\'s dump folder (--dump-folder of the collector) where coverage files should be placed.',
-        group: CONFIG_GROUP_COVERAGE_DUMP
-    });
-    return parameters;
-}
-//# sourceMappingURL=CollectorConfig.js.map

package/lib/CollectorConfig.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CollectorConfig.js","sourceRoot":"","sources":["../src/CollectorConfig.ts"],"names":[],"mappings":"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"}

package/lib/ConfigParser.d.ts

@@ -1,61 +0,0 @@
-export type ConfigParameterType = 'string' | 'int' | 'bool' | 'string[]';
-export type ConfigValueType = string | number | boolean | string[];
-export type Options = Record<string, ConfigValueType>;
-export type VersionAndHelpOptions = {
-    version: boolean;
-    help: boolean;
-};
-export type ConfigParsingResult = {
-    options: Options;
-    unnamedArguments: string[];
-};
-export type AppInfos = {
-    name: string;
-    version: string;
-    about: string;
-};
-export type ParameterGroup = {
-    order: number;
-    title: string;
-    hints?: string;
-};
-export declare const CONFIG_GROUP_APP: ParameterGroup;
-export type ParameterDescriptor = {
-    parameterId: string;
-    shortParameter?: string;
-    longParameter: string;
-    environmentVariableName: string;
-    disableEnvironmentVariableOverride?: boolean;
-    type: ConfigParameterType;
-    default?: ConfigValueType;
-    help: string;
-    internal: boolean;
-    group?: ParameterGroup;
-};
-export type ParameterDefinitionOptions = Partial<ParameterDescriptor>;
-export declare function parameterNameToParameterId(parameterName: string): string;
-export declare function longParameterToEnvironmentVariableName(longParameter: string): string;
-export declare class ConfigurationParameters {
-    private readonly parameters;
-    private readonly shortToLongParameterMap;
-    private readonly sequentialParameters;
-    private readonly argumentChecks;
-    constructor();
-    addParameter(shortParameter: string | undefined, longParameter: string, type: ConfigParameterType, options?: ParameterDefinitionOptions): void;
-    addArgumentCheck(check: (options: Record<string, unknown>) => string | undefined): void;
-    addRequiredArgumentFor(parameterId: string): void;
-    describeParameter(parameterId: string, descriptor: ParameterDescriptor): void;
-    lookupParameter(parameterId: string): ParameterDescriptor | undefined;
-    getParameters(): ParameterDescriptor[];
-    getArgumentChecks(): Array<(options: Record<string, unknown>) => string | undefined>;
-    getSequentialParameters(): string[];
-    clone(): ConfigurationParameters;
-    addAllOf(toAdd: ConfigurationParameters): void;
-}
-export declare function parseArguments<OptionsType extends Record<string, unknown>>(args: string[], parameters: ConfigurationParameters): Partial<OptionsType>;
-export declare function parseConfigFile(fileContent: string, parameters: ConfigurationParameters): ConfigParsingResult;
-export declare function printHelp(parameters: ConfigurationParameters, aboutText?: string, printParamterId?: boolean): void;
-export declare function checkArguments(configParameters: ConfigurationParameters, options: Options, errorReceiver?: (error: string) => void): boolean;
-export declare function processCommandLine<O>(parameters: ConfigurationParameters, appInfos: AppInfos, args?: string[], beforeCheckCallback?: (options: O) => void): O;
-export declare function parameterUnion(parameters1: ConfigurationParameters, parameters2: ConfigurationParameters): ConfigurationParameters;
-//# sourceMappingURL=ConfigParser.d.ts.map

package/lib/ConfigParser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ConfigParser.d.ts","sourceRoot":"","sources":["../src/ConfigParser.ts"],"names":[],"mappings":"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"}