@basemaps/cli-raster 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,70 @@
+# @basemaps/cli-raster
+
+CLI to retile imagery into a [Cloud Optimised Geotiffs (COG)](https://www.cogeo.org/) aligned to a [TileMatrix](https://www.ogc.org/standard/tms/)
+
+## Why ? 
+
+LINZ gets most of it's imagery delivered as tiles in [NZTM2000](https://www.linz.govt.nz/guidance/geodetic-system/coordinate-systems-used-new-zealand/projections/new-zealand-transverse-mercator-2000-nztm2000) the imagery is tiled as rectangles against a tile grid such as the [1:5k](https://data.linz.govt.nz/layer/104691-nz-15k-tile-index/) or [1:1k](https://data.linz.govt.nz/layer/104692-nz-11k-tile-index/).
+
+These grids are not designed for use in XYZ tiles services in [WebMercator/EPSG:3857](https://epsg.io/3857), If the tiles were converted directly to WebMercator there would be significant overlap between multiple source imagery tiffs and a output WebMercator tile. This would cause large overheads for basemaps to render tiles as it would need to fetch data from all of the tiffs inside of the output tile.
+
+![NZTM Tile Index vs WebMercator](./static/nztm-tile-index.png)
+Above is an example of a web mercator zoom 11 tile (Red outline) and the number `1:5k` tiles required to render (Shaded black) it
+
+This package contains the logic to process input imagery into a output Tile Matrix to create optimised COGs for web mapping purposes.
+
+The output COGS perfectly align to a output tile, greatly increasing XYZ tile service performance.
+
+### Process
+
+To convert imagery to optimized COG, a output tile cover is created, this covers the source imagery in tiles from the output tile matrix.
+
+```
+cogify cover --tile-matrix WebMercatorQuad s3://linz-imagery/.../porirua_2020_0.1m --target ./output
+```
+
+The metadata for the optimized COGS is written into the output folder where the COG creation step can use [GDAL](https://github.com/gdal/gdal) to create the output tiff.
+
+
+```
+cogify create ./output/WebMercatorQuad/porirua_2020_0.1m/01GY8W69EJEMAKKXNHYMRF7DCY/14-16150-10245.json
+```
+
+The output COG can be validated to ensure it matches the tile exactly.
+
+```
+cogify validate  --tile-matrix WebMercatorQuad ./output/WebMercatorQuad/porirua_2020_0.1m/01GY8W69EJEMAKKXNHYMRF7DCY/14-16150-10245.tiff
+```
+
+## Usage
+
+
+Install `cogify` using `npm`
+```
+npm install -g @basemaps/cli-raster
+```
+
+
+```
+$ cogify --help
+
+- cover - Create a covering configuration from a collection from source imagery
+- create - Create a COG from a covering configuration
+```
+
+
+### Covering
+
+Create a tile covering for WebMeractorQuad from source imagery located in s3 and outputs the resulting configuration files into `./output/:projection/:imageryName/:id/collection.json`
+
+```
+cogify cover --tile-matrix WebMercatorQuad s3://linz-imagery/new-zealand/north-island_2023_0.5m/rgb/2193/ --target ./output
+```
+
+### Create
+
+Create the first COG from the list
+```
+cogify create ./output/3857/north-island_2023_0.5m/:id/14-16150-10245.json
+```
+

package/build/bin.d.ts

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

package/build/bin.js

@@ -0,0 +1,16 @@
+Error.stackTraceLimit = 100;
+import { Fqdn, fsa, LogConfig } from '@basemaps/shared';
+import { run } from 'cmd-ts';
+import { CogifyCli } from './cogify/cli.js';
+// Force Fully qualified domain names to reduce DNS lookups
+Fqdn.isForcedFqdn = true;
+// remove the source caching / chunking as it is not needed for cogify, cogify only reads tiffs once so caching the result is not helpful
+fsa.middleware = fsa.middleware.filter((f) => f.name !== 'source:chunk');
+fsa.middleware = fsa.middleware.filter((f) => f.name !== 'source:cache');
+run(CogifyCli, 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;AAE5B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,2DAA2D;AAC3D,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;AAEzB,yIAAyI;AACzI,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;AACzE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;AAEzE,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/cogify/__test__/covering.test.d.ts

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

package/build/cogify/__test__/covering.test.js

@@ -0,0 +1,64 @@
+import assert from 'node:assert';
+import { describe, it } from 'node:test';
+import { GoogleTms, QuadKey } from '@basemaps/geo';
+import { gsdToMeter } from '../cli/cli.cover.js';
+import { addChildren, addSurrounding } from '../covering/covering.js';
+describe('getChildren', () => {
+    it('should get children', () => {
+        assert.deepEqual(addChildren({ z: 0, x: 0, y: 0 }), [
+            { z: 1, x: 0, y: 0 },
+            { z: 1, x: 1, y: 0 },
+            { z: 1, x: 0, y: 1 },
+            { z: 1, x: 1, y: 1 },
+        ]);
+    });
+    ['', '3', '310', '013', '3100123', '3103123231312301'].map((qk) => {
+        it('should match QuadKey: ' + qk, () => {
+            const tileChildren = addChildren(QuadKey.toTile(qk));
+            const qkChildren = QuadKey.children(qk).map((qk) => QuadKey.toTile(qk));
+            assert.deepEqual(tileChildren, qkChildren);
+        });
+    });
+});
+describe('SurroundingTiles', () => {
+    it('should not have surrounding tiles at z0', () => {
+        const todo = addSurrounding({ z: 0, x: 0, y: 0 }, GoogleTms);
+        assert.deepEqual(todo, []);
+    });
+    it('should add all surrounding tiles', () => {
+        assert.deepEqual(addSurrounding({ z: 2, x: 1, y: 1 }, GoogleTms), [
+            { z: 2, x: 1, y: 0 },
+            { z: 2, x: 2, y: 1 },
+            { z: 2, x: 1, y: 2 },
+            { z: 2, x: 0, y: 1 },
+        ]);
+    });
+    it('should wrap at matrix extent', () => {
+        // Top left tile
+        assert.deepEqual(addSurrounding({ z: 2, x: 0, y: 0 }, GoogleTms), [
+            { z: 2, x: 0, y: 3 }, // North - Wrapping North to South
+            { z: 2, x: 1, y: 0 }, // East
+            { z: 2, x: 0, y: 1 }, // South
+            { z: 2, x: 3, y: 0 }, // West - Wrapping West to East
+        ]);
+        // Bottom right tile
+        assert.deepEqual(addSurrounding({ z: 2, x: 3, y: 3 }, GoogleTms), [
+            { z: 2, x: 3, y: 2 }, // North
+            { z: 2, x: 0, y: 3 }, // East -- Wrapping East to West
+            { z: 2, x: 3, y: 0 }, // South -- Wrapping South to NOrth
+            { z: 2, x: 2, y: 3 }, // West
+        ]);
+    });
+    describe('gsdToMeter', () => {
+        it('Should convert gsd to correct meter', () => {
+            assert.equal(gsdToMeter(1), 1);
+            assert.equal(gsdToMeter(305.223), 305);
+            assert.equal(gsdToMeter(8.01), 8);
+            assert.equal(gsdToMeter(0.1), 0.1);
+            assert.equal(gsdToMeter(0.1001), 0.1);
+            assert.equal(gsdToMeter(0.2005), 0.201);
+            assert.equal(gsdToMeter(0.0005), 0.001);
+        });
+    });
+});
+//# sourceMappingURL=covering.test.js.map

package/build/cogify/__test__/covering.test.js.map

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

package/build/cogify/__test__/extract.test.d.ts

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

package/build/cogify/__test__/extract.test.js

@@ -0,0 +1,34 @@
+import { strictEqual, throws } from 'node:assert';
+import { describe, it } from 'node:test';
+import { extractMapCodeAndVersion } from '../topo/extract.js';
+describe('extractMapCodeAndVersion', () => {
+    const FakeDomain = 's3://topographic/fake-domain';
+    const validFiles = [
+        { input: `${FakeDomain}/MB07_GeoTifv1-00.tif`, expected: { mapCode: 'MB07', version: 'v1-00' } },
+        { input: `${FakeDomain}/MB07_GRIDLESS_GeoTifv1-00.tif`, expected: { mapCode: 'MB07', version: 'v1-00' } },
+        { input: `${FakeDomain}/MB07_TIFFv1-00.tif`, expected: { mapCode: 'MB07', version: 'v1-00' } },
+        { input: `${FakeDomain}/MB07_TIFF_600v1-00.tif`, expected: { mapCode: 'MB07', version: 'v1-00' } },
+        {
+            input: `${FakeDomain}/AX32ptsAX31AY31AY32_GeoTifv1-00.tif`,
+            expected: { mapCode: 'AX32ptsAX31AY31AY32', version: 'v1-00' },
+        },
+        {
+            input: `${FakeDomain}/AZ36ptsAZ35BA35BA36_GeoTifv1-00.tif`,
+            expected: { mapCode: 'AZ36ptsAZ35BA35BA36', version: 'v1-00' },
+        },
+    ];
+    const invalidFiles = [`${FakeDomain}/MB07_GeoTif1-00.tif`, `${FakeDomain}/MB07_TIFF_600v1.tif`];
+    it('should parse the correct MapSheet Names', () => {
+        for (const file of validFiles) {
+            const output = extractMapCodeAndVersion(new URL(file.input));
+            strictEqual(output.mapCode, file.expected.mapCode, 'Map code does not match');
+            strictEqual(output.version, file.expected.version, 'Version does not match');
+        }
+    });
+    it('should not able to parse a version from file', () => {
+        for (const file of invalidFiles) {
+            throws(() => extractMapCodeAndVersion(new URL(file)), new Error(`Version not found in the file name: "${file}"`));
+        }
+    });
+});
+//# sourceMappingURL=extract.test.js.map

package/build/cogify/__test__/extract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.test.js","sourceRoot":"","sources":["../../../src/cogify/__test__/extract.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,MAAM,UAAU,GAAG,8BAA8B,CAAC;IAClD,MAAM,UAAU,GAAG;QACjB,EAAE,KAAK,EAAE,GAAG,UAAU,uBAAuB,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QAChG,EAAE,KAAK,EAAE,GAAG,UAAU,gCAAgC,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QACzG,EAAE,KAAK,EAAE,GAAG,UAAU,qBAAqB,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QAC9F,EAAE,KAAK,EAAE,GAAG,UAAU,yBAAyB,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QAClG;YACE,KAAK,EAAE,GAAG,UAAU,sCAAsC;YAC1D,QAAQ,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,OAAO,EAAE;SAC/D;QACD;YACE,KAAK,EAAE,GAAG,UAAU,sCAAsC;YAC1D,QAAQ,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,OAAO,EAAE;SAC/D;KACF,CAAC;IACF,MAAM,YAAY,GAAG,CAAC,GAAG,UAAU,sBAAsB,EAAE,GAAG,UAAU,sBAAsB,CAAC,CAAC;IAEhG,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7D,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;YAC9E,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,EAAE,CAAC,wBAAwB,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,KAAK,CAAC,wCAAwC,IAAI,GAAG,CAAC,CAAC,CAAC;QACpH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/cogify/cli/__test__/cli.cover.test.d.ts

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

package/build/cogify/cli/__test__/cli.cover.test.js

@@ -0,0 +1,48 @@
+import assert from 'node:assert';
+import { beforeEach, describe, it } from 'node:test';
+import { fsa, FsMemory, LogConfig } from '@basemaps/shared';
+import { TestTiff } from '@basemaps/test';
+import { BasemapsCogifyCoverCommand } from '../cli.cover.js';
+describe('cli.cover', () => {
+    const fsMemory = new FsMemory();
+    beforeEach(async () => {
+        LogConfig.get().level = 'silent';
+        fsa.register('memory://', fsMemory);
+        fsMemory.files.clear();
+        await fsa.write(new URL('memory://source/google.tiff'), fsa.readStream(TestTiff.Google));
+    });
+    const baseArgs = {
+        paths: [new URL('memory://source/')],
+        target: new URL('memory://target/'),
+        preset: 'webp',
+        tileMatrix: 'WebMercatorQuad',
+        cutline: undefined,
+        cutlineBlend: 20,
+        baseZoomOffset: undefined,
+        verbose: false,
+        extraVerbose: false,
+        requireStacCollection: false,
+        background: undefined,
+    };
+    it('should generate a covering', async () => {
+        const ret = await BasemapsCogifyCoverCommand.handler({ ...baseArgs }).catch((e) => String(e));
+        assert.equal(ret, undefined); // no errors returned
+        const files = [...fsMemory.files.keys()];
+        const collectionJsonPath = files.find((f) => f.endsWith('collection.json') && f.startsWith('memory://target/'));
+        assert.ok(collectionJsonPath);
+        const collectionJson = JSON.parse(String(fsMemory.files.get(collectionJsonPath)?.buffer ?? '{}'));
+        assert.equal(collectionJson['description'], 'Missing source STAC');
+    });
+    it('should error if no collection.json is found', async () => {
+        const ret = await BasemapsCogifyCoverCommand.handler({
+            ...baseArgs,
+            paths: [new URL('memory://source/')],
+            target: new URL('memory://target/'),
+            preset: 'webp',
+            requireStacCollection: true,
+            tileMatrix: 'WebMercatorQuad',
+        }).catch((e) => String(e));
+        assert.equal(ret, 'Error: No collection.json found with imagery: memory://source/');
+    });
+});
+//# sourceMappingURL=cli.cover.test.js.map

package/build/cogify/cli/__test__/cli.cover.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cover.test.js","sourceRoot":"","sources":["../../../../src/cogify/cli/__test__/cli.cover.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE7D,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAEhC,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,GAAG,QAAQ,CAAC;QACjC,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACpC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAEvB,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,6BAA6B,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG;QACf,KAAK,EAAE,CAAC,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACpC,MAAM,EAAE,IAAI,GAAG,CAAC,kBAAkB,CAAC;QACnC,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,iBAAiB;QAC7B,OAAO,EAAE,SAAS;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,SAAS;QACzB,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,KAAK;QACnB,qBAAqB,EAAE,KAAK;QAC5B,UAAU,EAAE,SAAS;KACtB,CAAC;IAEF,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,GAAG,GAAG,MAAM,0BAA0B,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9F,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,qBAAqB;QAEnD,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,kBAAkB,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAChH,MAAM,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC;QAE9B,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC,CAAmB,CAAC;QACpH,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,qBAAqB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,GAAG,GAAG,MAAM,0BAA0B,CAAC,OAAO,CAAC;YACnD,GAAG,QAAQ;YACX,KAAK,EAAE,CAAC,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;YACpC,MAAM,EAAE,IAAI,GAAG,CAAC,kBAAkB,CAAC;YACnC,MAAM,EAAE,MAAM;YACd,qBAAqB,EAAE,IAAI;YAC3B,UAAU,EAAE,iBAAiB;SAC9B,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAE3B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,gEAAgE,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/cogify/cli/__test__/cli.topo.test.d.ts

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

package/build/cogify/cli/__test__/cli.topo.test.js

@@ -0,0 +1,53 @@
+import assert from 'node:assert';
+import { beforeEach, describe, it } from 'node:test';
+import { fsa, FsMemory, LogConfig } from '@basemaps/shared';
+import { TestTiff } from '@basemaps/test';
+import { TopoStacCreationCommand } from '../cli.topo.js';
+describe('cli.topo', () => {
+    const fsMemory = new FsMemory();
+    beforeEach(async () => {
+        LogConfig.get().level = 'silent';
+        fsa.register('memory://', fsMemory);
+        fsMemory.files.clear();
+        await fsa.write(new URL('memory://source/CJ10_GRIDLESS_GeoTifv1-00.tif'), fsa.readStream(TestTiff.Nztm2000));
+        await fsa.write(new URL('memory://source/CJ10_GRIDLESS_GeoTifv1-01.tif'), fsa.readStream(TestTiff.Nztm2000));
+    });
+    const baseArgs = {
+        paths: [new URL('memory://source/')],
+        target: new URL('memory://target/'),
+        mapSeries: 'topo50',
+        latestOnly: false,
+        title: undefined,
+        output: undefined,
+        // extra logging arguments
+        verbose: false,
+        extraVerbose: false,
+    };
+    it('should generate a covering', async () => {
+        const ret = await TopoStacCreationCommand.handler({ ...baseArgs }).catch((e) => String(e));
+        assert.equal(ret, undefined); // no errors returned
+        const files = [...fsMemory.files.keys()];
+        files.sort();
+        assert.deepEqual(files, [
+            'memory://source/CJ10_GRIDLESS_GeoTifv1-00.tif',
+            'memory://source/CJ10_GRIDLESS_GeoTifv1-01.tif',
+            'memory://target/topo50/gridless_600dpi/2193/CJ10_v1-00.json',
+            'memory://target/topo50/gridless_600dpi/2193/CJ10_v1-01.json',
+            'memory://target/topo50/gridless_600dpi/2193/collection.json',
+            'memory://target/topo50_latest/gridless_600dpi/2193/CJ10.json',
+            'memory://target/topo50_latest/gridless_600dpi/2193/collection.json',
+        ]);
+        const collectionJson = await fsa.readJson(new URL('memory://target/topo50/gridless_600dpi/2193/collection.json'));
+        assert.equal(collectionJson['description'], 'Topographic maps of New Zealand');
+        assert.equal(collectionJson['linz:slug'], 'topo50-new-zealand-mainland');
+        assert.equal(collectionJson['linz:region'], 'new-zealand');
+        const latestItemUrl = new URL('memory://target/topo50_latest/gridless_600dpi/2193/CJ10.json');
+        const latestVersion = await fsa.readJson(latestItemUrl);
+        // Latest file should be derived_from the source file
+        const derived = latestVersion.links.filter((f) => f.rel === 'derived_from');
+        assert.equal(derived.length, 1);
+        const derivedFile = new URL(derived[0].href, latestItemUrl);
+        assert.equal(derivedFile.href, 'memory://target/topo50/gridless_600dpi/2193/CJ10_v1-01.json');
+    });
+});
+//# sourceMappingURL=cli.topo.test.js.map

package/build/cogify/cli/__test__/cli.topo.test.js.map

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

package/build/cogify/cli/cli.cog.d.ts

@@ -0,0 +1,55 @@
+import { TileMatrixSet } from '@basemaps/geo';
+import { LogType } from '@basemaps/shared';
+import { StacCollection } from 'stac-ts';
+import { CutlineOptimizer } from '../covering/cutline.js';
+import { CogifyCreationOptions, CogifyStacItem } from '../stac.js';
+export interface CogItem {
+    url: URL;
+    item: CogifyStacItem;
+    collection: StacCollection;
+}
+export declare const BasemapsCogifyCreateCommand: 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<{
+        path: URL[];
+        force: boolean;
+        concurrency: number;
+        docker: boolean;
+        fromFile: URL[] | 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<{
+    path: URL[];
+    force: boolean;
+    concurrency: number;
+    docker: boolean;
+    fromFile: URL[] | 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>;
+export interface CogCreationContext {
+    /** TileId for the file name */
+    tileId: string;
+    /** COG Creation options */
+    options: CogifyCreationOptions;
+    /** Location to store all the temporary files */
+    tempFolder: URL;
+    /** List of source tiffs paths needed for the cog */
+    sourceFiles: URL[];
+    /** Optional cutline to cut the imagery too */
+    cutline: CutlineOptimizer;
+    /** Optional Source imagery size for topo raster trim pixel */
+    size?: {
+        width: number;
+        height: number;
+    };
+    /** Optional logger */
+    logger?: LogType;
+}
+/**
+ * Very basic checking for the output tiff to ensure it was uploaded ok
+ * Just open it as a COG and ensure the metadata looks about  right
+ */
+export declare function validateOutputTiff(url: URL, tileMatrix: TileMatrixSet | undefined, logger: LogType): Promise<void>;