@basemaps/cli-config 8.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Crown copyright (c), Toitū Te Whenua Land Information New Zealand on behalf of the New Zealand Government.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @basemaps/cli-config
+
+CLI for Basemap config
+
+## Usage -- Bundle
+
+Bundle config files into config bundle json from a given config path. This is mainly use for [linz/basemaps-config](https://github.com/linz/basemaps-config) CICD process to bundle all the individual config json files into a single JSON bundle.
+
+```bash
+./build/bin.js bundle --config config/ --assets assets/asset.tar --output config.json
+```
+
+## Usage -- Bundle Assets
+
+Create cotar file for the config assets. Creates a cotar file from a directory. This is mainly use for [linz/basemaps-config](https://github.com/linz/basemaps-config) CICD process to create cotar file.
+
+```bash
+./build/bin.js bundle-assets --assets assets/ --output output/
+```
+
+## Usage -- Import
+
+Import all configs from a bundled config.json into dynamo db from a given config path. This is mainly use for [linz/basemaps-config](https://github.com/linz/basemaps-config) repository ci/cd process to deploy the config changes into DynamoDB.
+
+```bash
+./build/bin.js import --config config.json --commit
+```
+
+## Usage -- Create Config
+
+Create a Basemaps configuration from a path to imagery. This is mainly use for [linz/basemaps-config](https://github.com/linz/basemaps-config) repository ci/cd process to deploy the config changes into DynamoDB.
+
+```bash
+./build/bin.js create-config --path path/ --target target/
+```

package/build/__tests__/util.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/util.test.js

@@ -0,0 +1,15 @@
+import assert from 'node:assert';
+import { describe, it } from 'node:test';
+import { nameImageryTitle } from '../util.js';
+describe('util', () => {
+    it('nameImageryTitle', () => {
+        assert.equal(nameImageryTitle('Palmerston-north urban 2016-17 12.125m'), 'palmerston-north_urban_2016-17_12-125m');
+        assert.equal(nameImageryTitle('Palmerston-north urban 2016-17 12-125'), 'palmerston-north_urban_2016-17_12-125');
+        assert.equal(nameImageryTitle('Palmerston-north / urban 2016-17 12.125'), 'palmerston-north_urban_2016-17_12-125');
+        assert.equal(nameImageryTitle('Palmerston.north / urban 2016-17 12.125'), 'palmerston-north_urban_2016-17_12-125');
+        assert.equal(nameImageryTitle('Manawatū urban 2016-17 12.125m'), 'manawatu_urban_2016-17_12-125m');
+        assert.equal(nameImageryTitle('ĀāĒēĪīŌōŪū urban 2016-17 12.125m'), 'aaeeiioouu_urban_2016-17_12-125m');
+        assert.equal(nameImageryTitle('Marlborough / Wellington 0.75m SNC50451 (2004-2005)'), 'marlborough_wellington_0-75m_snc50451_2004-2005');
+    });
+});
+//# sourceMappingURL=util.test.js.map

package/build/__tests__/util.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.test.js","sourceRoot":"","sources":["../../src/__tests__/util.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;IACpB,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,wCAAwC,CAAC,EAAE,wCAAwC,CAAC,CAAC;QACnH,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,uCAAuC,CAAC,EAAE,uCAAuC,CAAC,CAAC;QACjH,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,yCAAyC,CAAC,EAAE,uCAAuC,CAAC,CAAC;QACnH,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,yCAAyC,CAAC,EAAE,uCAAuC,CAAC,CAAC;QACnH,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,gCAAgC,CAAC,EAAE,gCAAgC,CAAC,CAAC;QACnG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,kCAAkC,CAAC,EAAE,kCAAkC,CAAC,CAAC;QACvG,MAAM,CAAC,KAAK,CACV,gBAAgB,CAAC,qDAAqD,CAAC,EACvE,iDAAiD,CAClD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/bin.d.ts

@@ -0,0 +1 @@
+export {};

package/build/bin.js

@@ -0,0 +1,11 @@
+Error.stackTraceLimit = 100;
+import { LogConfig } from '@basemaps/shared';
+import { run } from 'cmd-ts';
+import { ConfigCli } from './index.js';
+run(ConfigCli, process.argv.slice(2)).catch((err) => {
+    const logger = LogConfig.get();
+    logger.fatal({ err }, 'Command:Failed');
+    // Give the logger some time to flush before exiting
+    setTimeout(() => process.exit(1), 25);
+});
+//# sourceMappingURL=bin.js.map

package/build/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"AAAA,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAExC,oDAAoD;IACpD,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC"}

package/build/cli/action.bundle.assets.d.ts

@@ -0,0 +1,17 @@
+import { Readable } from 'stream';
+export declare function hashFile(stream: Readable): Promise<string>;
+export declare const BundleAssetsCommand: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
+    parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<{
+        assets: string;
+        output: string;
+        verbose: boolean;
+        extraVerbose: boolean;
+    }>>;
+} & import("cmd-ts/dist/cjs/helpdoc.js").PrintHelp & import("cmd-ts/dist/cjs/helpdoc.js").ProvidesHelp & import("cmd-ts/dist/cjs/helpdoc.js").Named & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned> & import("cmd-ts/dist/cjs/argparser.js").Register & import("cmd-ts/dist/cjs/runner.js").Handling<{
+    assets: string;
+    output: string;
+    verbose: boolean;
+    extraVerbose: boolean;
+}, Promise<void>> & {
+    run(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<Promise<void>>>;
+} & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned & import("cmd-ts/dist/cjs/helpdoc.js").Descriptive & import("cmd-ts/dist/cjs/helpdoc.js").Aliased>;

package/build/cli/action.bundle.assets.js

@@ -0,0 +1,97 @@
+import { base58 } from '@basemaps/config';
+import { fsa, getLogger, logArguments, SourceMemory } from '@basemaps/shared';
+import { CliInfo } from '@basemaps/shared/build/cli/info.js';
+import { CotarIndexBuilder, TarReader } from '@cotar/builder';
+import { CotarIndex } from '@cotar/core';
+import { TarBuilder } from '@cotar/tar';
+import { Metrics } from '@linzjs/metrics';
+import { command, option, string } from 'cmd-ts';
+import { createHash } from 'crypto';
+import { createReadStream, promises as fs } from 'fs';
+const Packing = 25; // Packing factor for the hash map
+const MaxSearch = 50; // Max search factor
+export async function hashFile(stream) {
+    return new Promise((resolve, reject) => {
+        const hash = createHash('sha256');
+        stream.on('data', (chunk) => hash.update(chunk));
+        stream.on('end', () => resolve(base58.encode(hash.digest())));
+        stream.on('error', (err) => reject(err));
+    });
+}
+export const BundleAssetsCommand = command({
+    name: 'bundle-assets',
+    version: CliInfo.version,
+    description: 'Cli tool to create cotar file for the config assets. Creates a cotar file from a directory.',
+    args: {
+        ...logArguments,
+        assets: option({
+            type: string,
+            long: 'assets',
+            description: 'Paths to the input assets files, must contain assets/sprites/ and assets/fonts.',
+        }),
+        output: option({
+            type: string,
+            long: 'output',
+            description: 'Paths of the output co tar file.',
+        }),
+    },
+    async handler(args) {
+        const metrics = new Metrics();
+        const logger = getLogger(this, args, 'cli-config');
+        if (!args.output.endsWith('.tar.co'))
+            throw new Error(`Invalid output, needs to be .tar.co :"${args.output}"`);
+        metrics.start('assets:bundle');
+        logger.info({ input: args.assets }, 'BundleAssets:Start');
+        const tarFile = await buildTar(fsa.toUrl(args.assets), args.output, logger);
+        const cotarFile = await buildTarCo(tarFile, args.output, logger);
+        const cotarHash = await hashFile(createReadStream(cotarFile));
+        await fs.rename(cotarFile, cotarFile.replace('.tar.co', `-${cotarHash}.tar.co`));
+        logger.info({ output: cotarFile, hash: cotarHash }, 'BundleAssets:Finish');
+        metrics.end('assets:bundle');
+    },
+});
+async function buildTar(input, output, logger) {
+    const startTime = Date.now();
+    const outputTar = output.split('.co')[0];
+    const tarBuilder = new TarBuilder(outputTar);
+    const files = await fsa.toArray(fsa.list(input));
+    // Ensure files are put into the same order
+    files.sort((a, b) => a.href.localeCompare(b.href));
+    logger.info({ output: outputTar, files: files.length }, 'Tar:Create');
+    for (const file of files) {
+        const filePath = file.href.replace(input.href, '');
+        if (filePath.startsWith('/'))
+            filePath.slice(1); // Remove the leading '/'
+        await tarBuilder.write(decodeURI(filePath), await fsa.read(file));
+    }
+    await tarBuilder.close();
+    logger.info({ output: outputTar, stats: tarBuilder.stats, duration: Date.now() - startTime }, 'Tar:Create:Done');
+    return outputTar;
+}
+async function buildTarCo(input, output, logger) {
+    logger.info({ output }, 'Cotar:Create');
+    const indexFile = input + '.index';
+    const startTime = Date.now();
+    const buf = await toTarIndex(input, indexFile, logger);
+    logger.info({ output }, 'Cotar:Create:WriteTar');
+    await fs.copyFile(input, output);
+    await fs.appendFile(output, buf);
+    const duration = Date.now() - startTime;
+    logger.info({ output, duration }, 'Cotar:Created');
+    return output;
+}
+async function toTarIndex(filename, indexFileName, logger) {
+    const fd = await fs.open(filename, 'r');
+    logger.info({ index: indexFileName }, 'Cotar.Index:Start');
+    const startTime = Date.now();
+    const { buffer, count } = await CotarIndexBuilder.create(fd, {
+        packingFactor: 1 + Packing / 100,
+        maxSearch: MaxSearch,
+    });
+    logger.info({ count, size: buffer.length, duration: Date.now() - startTime }, 'Cotar.Index:Created');
+    const index = await CotarIndex.create(new SourceMemory('index', buffer));
+    await TarReader.validate(fd, index);
+    await fd.close();
+    return buffer;
+}
+//# sourceMappingURL=action.bundle.assets.js.map

package/build/cli/action.bundle.assets.js.map

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

package/build/cli/action.bundle.d.ts

@@ -0,0 +1,21 @@
+export declare const DefaultConfig = "config/";
+export declare const DefaultOutput = "config/config.json";
+export declare const BundleCommand: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
+    parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<{
+        config: string;
+        output: string;
+        assets: string | undefined;
+        cache: string | undefined;
+        verbose: boolean;
+        extraVerbose: boolean;
+    }>>;
+} & import("cmd-ts/dist/cjs/helpdoc.js").PrintHelp & import("cmd-ts/dist/cjs/helpdoc.js").ProvidesHelp & import("cmd-ts/dist/cjs/helpdoc.js").Named & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned> & import("cmd-ts/dist/cjs/argparser.js").Register & import("cmd-ts/dist/cjs/runner.js").Handling<{
+    config: string;
+    output: string;
+    assets: string | undefined;
+    cache: string | undefined;
+    verbose: boolean;
+    extraVerbose: boolean;
+}, Promise<void>> & {
+    run(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<Promise<void>>>;
+} & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned & import("cmd-ts/dist/cjs/helpdoc.js").Descriptive & import("cmd-ts/dist/cjs/helpdoc.js").Aliased>;

package/build/cli/action.bundle.js

@@ -0,0 +1,58 @@
+import { ConfigJson } from '@basemaps/config-loader';
+import { fsa, getLogger, logArguments } from '@basemaps/shared';
+import { CliInfo } from '@basemaps/shared/build/cli/info.js';
+import { Metrics } from '@linzjs/metrics';
+import { command, option, optional, string } from 'cmd-ts';
+import pLimit from 'p-limit';
+export const DefaultConfig = 'config/';
+export const DefaultOutput = 'config/config.json';
+export const BundleCommand = command({
+    name: 'bundle',
+    version: CliInfo.version,
+    description: 'Given a path of config files and bundle them into one config json. Bundles a config json from config files.',
+    args: {
+        ...logArguments,
+        config: option({
+            type: string,
+            long: 'config',
+            description: 'Path of config files.',
+            defaultValue: () => DefaultConfig,
+            defaultValueIsSerializable: true,
+        }),
+        output: option({
+            type: string,
+            long: 'output',
+            description: 'Output of the bundle file.',
+            defaultValue: () => DefaultOutput,
+            defaultValueIsSerializable: true,
+        }),
+        assets: option({
+            type: optional(string),
+            long: 'assets',
+            description: 'Add assets location into the config bundle file.',
+        }),
+        cache: option({
+            type: optional(string),
+            long: 'cache',
+            description: 'Location of the config cache to reduce number of requests needed to source file.',
+        }),
+    },
+    async handler(args) {
+        const metrics = new Metrics();
+        const logger = getLogger(this, args, 'cli-config');
+        const configUrl = fsa.toUrl(args.config);
+        const outputUrl = fsa.toUrl(args.output);
+        const cacheLocation = args.cache ? fsa.toUrl(args.cache) : undefined;
+        metrics.start('config:bundle');
+        logger.info({ configUrl }, 'BundleConfig:Start');
+        const q = pLimit(25);
+        const mem = await ConfigJson.fromUrl(configUrl, q, logger, cacheLocation);
+        if (args.assets != null)
+            mem.assets = args.assets;
+        const configJson = mem.toJson();
+        await fsa.write(outputUrl, JSON.stringify(configJson));
+        logger.info({ outputUrl }, 'BundleConfig:Finish');
+        metrics.end('config:bundle');
+    },
+});
+//# sourceMappingURL=action.bundle.js.map

package/build/cli/action.bundle.js.map

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

package/build/cli/action.create.config.d.ts

@@ -0,0 +1,19 @@
+export declare const CreateConfigCommand: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
+    parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<{
+        target: URL | undefined;
+        concurrency: number;
+        host: URL | undefined;
+        path: URL;
+        verbose: boolean;
+        extraVerbose: boolean;
+    }>>;
+} & import("cmd-ts/dist/cjs/helpdoc.js").PrintHelp & import("cmd-ts/dist/cjs/helpdoc.js").ProvidesHelp & import("cmd-ts/dist/cjs/helpdoc.js").Named & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned> & import("cmd-ts/dist/cjs/argparser.js").Register & import("cmd-ts/dist/cjs/runner.js").Handling<{
+    target: URL | undefined;
+    concurrency: number;
+    host: URL | undefined;
+    path: URL;
+    verbose: boolean;
+    extraVerbose: boolean;
+}, Promise<void>> & {
+    run(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<Promise<void>>>;
+} & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned & import("cmd-ts/dist/cjs/helpdoc.js").Descriptive & import("cmd-ts/dist/cjs/helpdoc.js").Aliased>;

package/build/cli/action.create.config.js

@@ -0,0 +1,79 @@
+import { base58, ConfigProviderMemory } from '@basemaps/config';
+import { initImageryFromTiffUrl } from '@basemaps/config-loader';
+import { getLogger, isArgo, logArguments, Url, UrlFolder } from '@basemaps/shared';
+import { fsa, getPreviewUrl, urlToString } from '@basemaps/shared';
+import { CliInfo } from '@basemaps/shared/build/cli/info.js';
+import { Metrics } from '@linzjs/metrics';
+import { command, number, option, optional, positional } from 'cmd-ts';
+import pLimit from 'p-limit';
+import { promisify } from 'util';
+import { gzip } from 'zlib';
+const gzipPromise = promisify(gzip);
+export const CreateConfigCommand = command({
+    name: 'create-config',
+    version: CliInfo.version,
+    description: 'Create a Basemaps configuration from a path to imagery',
+    args: {
+        ...logArguments,
+        target: option({
+            type: optional(UrlFolder),
+            long: 'target',
+            description: 'Where to write the config json, Defaults to imagery path',
+        }),
+        concurrency: option({
+            type: number,
+            long: 'concurrency',
+            description: 'How many COGs to initialise at once',
+            defaultValue: () => 25,
+            defaultValueIsSerializable: true,
+        }),
+        host: option({
+            type: optional(Url),
+            long: 'host',
+            description: 'Which host to use as the base for for preview generation links',
+            defaultValue: () => new URL('https://basemaps.linz.govt.nz'),
+            defaultValueIsSerializable: true,
+        }),
+        path: positional({ type: UrlFolder, displayName: 'path', description: 'Path to imagery' }),
+    },
+    async handler(args) {
+        const metrics = new Metrics();
+        const logger = getLogger(this, args, 'cli-config');
+        const provider = new ConfigProviderMemory();
+        const q = pLimit(args.concurrency);
+        metrics.start('imagery:load');
+        const im = await initImageryFromTiffUrl(args.path, q, undefined, logger);
+        const ts = ConfigProviderMemory.imageryToTileSet(im);
+        provider.put(im);
+        metrics.end('imagery:load');
+        logger.info({ files: im.files.length, titles: im.title }, 'ImageryConfig:Loaded');
+        const config = provider.toJson();
+        const outputPath = new URL(`basemaps-config-${config.hash}.json.gz`, args.target ?? args.path);
+        logger.info({ output: outputPath, hash: config.hash }, 'ImageryConfig:Write');
+        await fsa.write(outputPath, await gzipPromise(JSON.stringify(config)));
+        const configPath = base58.encode(Buffer.from(outputPath.href));
+        // previews default to webp, so find the first output that supports web to make our life easier
+        const output = ts.outputs?.find((f) => f.format == null || f.format.includes('webp'));
+        const p = getPreviewUrl({ imagery: im, config: configPath, pipeline: output?.name });
+        const url = new URL(`/${p.slug}?style=${p.name}&tileMatrix=${im.tileMatrix}&debug&config=${configPath}`, args.host);
+        const urlPreview = new URL(p.url, args.host);
+        logger.info({
+            imageryId: im.id,
+            configUrl: outputPath,
+            url,
+            urlPreview,
+            config: configPath,
+            title: im.title,
+            tileMatrix: im.tileMatrix,
+            projection: im.projection,
+        }, 'ImageryConfig:Done');
+        if (isArgo()) {
+            // Path to where the config is located
+            await fsa.write(fsa.toUrl('/tmp/cogify/config-path'), urlToString(outputPath));
+            // A URL to where the imagery can be viewed
+            await fsa.write(fsa.toUrl('/tmp/cogify/config-url'), urlToString(url));
+        }
+        logger.info({ metrics: metrics.metrics }, 'ImageryConfig:Metrics');
+    },
+});
+//# sourceMappingURL=action.create.config.js.map

package/build/cli/action.create.config.js.map

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

package/build/cli/action.import.d.ts

@@ -0,0 +1,19 @@
+export declare const ImportCommand: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
+    parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<{
+        config: string;
+        output: string;
+        target: string | undefined;
+        commit: boolean;
+        verbose: boolean;
+        extraVerbose: boolean;
+    }>>;
+} & import("cmd-ts/dist/cjs/helpdoc.js").PrintHelp & import("cmd-ts/dist/cjs/helpdoc.js").ProvidesHelp & import("cmd-ts/dist/cjs/helpdoc.js").Named & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned> & import("cmd-ts/dist/cjs/argparser.js").Register & import("cmd-ts/dist/cjs/runner.js").Handling<{
+    config: string;
+    output: string;
+    target: string | undefined;
+    commit: boolean;
+    verbose: boolean;
+    extraVerbose: boolean;
+}, Promise<void>> & {
+    run(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<Promise<void>>>;
+} & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned & import("cmd-ts/dist/cjs/helpdoc.js").Descriptive & import("cmd-ts/dist/cjs/helpdoc.js").Aliased>;