🎉

Author: robb-j

.editorconfig

@@ -0,0 +1,15 @@
+#
+# Editor config, for sharing IDE preferences ~ https://editorconfig.org/
+#
+
+root = true
+
+[*]
+charset = utf-8
+indent_style = tab
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+
+[*.{yml,md}]
+indent_style = space

.github/workflows/pages.yml

@@ -0,0 +1,49 @@
+name: pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+      actions: read
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - uses: actions/setup-node@v4
+        with:
+          cache: "npm"
+          cache-dependency-path: "website/package-lock.json"
+
+      - run: npm ci
+        working-directory: ./website
+
+      - name: Build website
+        run: npx eleventy # --pathprefix=/maps.openlab.dev/
+        working-directory: ./website
+        env:
+          NODE_ENV: production
+
+      - name: Upload pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: website/_site
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,11 @@
+#
+# Files to ignore from git source control
+#
+
+.DS_Store
+*.env
+node_modules
+coverage
+dist
+tiles
+_site

.node-version

@@ -0,0 +1 @@
+lts-jod

README.md

@@ -0,0 +1,6 @@
+# maps.openlab.dev
+
+This repository houses the [maps.openlab.dev](https://maps.openlab.dev) website
+along with a containerised cli that is responsible for fetching and storing the tiles.
+
+<!-- ... -->

cli/config.json

@@ -0,0 +1,13 @@
+{
+	"targets": [
+		{
+			"name": "ncl.pmtiles",
+			"bbox": [-2.072468, 54.730692, -1.112537, 55.248329]
+		}
+	],
+	"s3": {
+		"objectMetadata": {
+			"x-amz-acl": "public-read"
+		}
+	}
+}

cli/config.ts

@@ -0,0 +1,66 @@
+import { getConfiguration, Structure } from "gruber";
+import pkg from "./package.json" with { type: "json" };
+
+const config = getConfiguration();
+
+const UNSET = "gruber://unset";
+
+const struct = config.object({
+	env: config.string({ variable: "NODE_ENV", fallback: "development" }),
+
+	meta: config.object({
+		name: config.string({ variable: "APP_NAME", fallback: pkg.name }),
+		version: config.string({ variable: "APP_VERSION", fallback: pkg.version }),
+	}),
+
+	targets: config.array(
+		config.object({
+			name: Structure.string(),
+			bbox: Structure.array(Structure.number()),
+		}),
+	),
+
+	protomaps: config.object({
+		metadata: config.url({
+			variable: "PROTOMAPS_METADATA_URL",
+			fallback: "https://build-metadata.protomaps.dev/builds.json",
+		}),
+		builds: config.url({
+			variable: "PROTOMAPS_BUILDS_URL",
+			fallback: "https://build.protomaps.com",
+		}),
+	}),
+
+	s3: config.object({
+		prefix: config.string({ variable: "S3_PREFIX", fallback: "" }),
+		accessKey: config.string({ variable: "S3_ACCESS_KEY", fallback: UNSET }),
+		secretKey: config.string({ variable: "S3_SECRET_KEY", fallback: UNSET }),
+		bucketName: config.string({ variable: "S3_BUCKET_NAME", fallback: UNSET }),
+		endpoint: config.url({ variable: "S3_ENDPOINT", fallback: UNSET }),
+		objectMetadata: Structure.any(),
+	}),
+});
+
+export async function loadConfiguration(path: string | URL) {
+	const value = await config.load(path, struct);
+	if (value.env === "production") {
+		if (value.s3.accessKey === UNSET) throw new Error("s3.accessKey not set");
+		if (value.s3.secretKey === UNSET) throw new Error("s3.secretKey not set");
+		if (value.s3.bucketName === UNSET) throw new Error("s3.bucketName not set");
+		if (value.s3.endpoint.toString() === UNSET) {
+			throw new Error("s3.endpoint not set");
+		}
+	}
+	for (const target of value.targets) {
+		if (target.bbox.length !== 4) throw new Error("bbox must have 4 elements");
+	}
+	return value;
+}
+
+export function outputConfiguration() {
+	console.log(config.getUsage(struct, appConfig));
+}
+
+export const appConfig = await loadConfiguration(
+	new URL("./config.json", import.meta.url),
+);

cli/lib.ts

@@ -0,0 +1,4 @@
+import cp from "node:child_process";
+import { promisify } from "node:util";
+
+export const exec = promisify(cp.exec);

cli/main.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env node --experimental-strip-types --env-file=.env
+
+// import "gruber/polyfill.js"; TODO: waiting on gruber fix
+import "urlpattern-polyfill";
+
+import process from "node:process";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+
+import { outputConfiguration } from "./config.ts";
+import { runTool } from "./run.ts";
+
+const cli = yargs()
+	.demandCommand(1, "A command is required")
+	.recommendCommands()
+	.help();
+
+cli.command(
+	"config",
+	"Output config and usage",
+	(yargs) => yargs,
+	() => outputConfiguration(),
+);
+
+cli.command(
+	"run",
+	"Run the tool",
+	(yargs) => yargs.option("dryRun", { type: "boolean", default: false }),
+	(args) => runTool(args),
+);
+
+cli.parse(hideBin(process.argv));

cli/package.json

@@ -0,0 +1,18 @@
+{
+	"name": "@openlab/protomaps-cli",
+	"version": "0.0.0",
+	"type": "module",
+	"scripts": {
+		"dev": "node --experimental-strip-types --env-file=.env main.ts",
+		"debug": "node --experimental-strip-types --env-file=.env --inspect-wait main.ts",
+		"build": "tsc"
+	},
+	"dependencies": {
+		"gruber": "^0.9.0-beta.1",
+		"minio": "^8.0.5",
+		"yargs": "^18.0.0"
+	},
+	"devDependencies": {
+		"@types/yargs": "^17.0.33"
+	}
+}