MapColonies / shigola / 65bc333c9

57%

master: 44%

push

github

feat(server): flag a map to serve itself as a whole only (MAPCO-11493) (#20)

* feat(server): flag a map to serve itself as a whole only (MAPCO-11493)

A map publishes a collection for itself and one per layer, so a client can
ask for the whole map or for a single layer of it. Some deployments do not
want the layer tier published at all: the layers are an implementation
detail of the map, and every layer id is a separately cacheable, separately
requestable surface to support.

serve_layer_collections turns that tier off per map. The config key is a
pointer, and so is the atlas field behind it, because the alternative
silently inverts the default: a plain bool makes "unset" indistinguishable
from "explicitly false", which would hide every layer collection in every
config that has never heard of the key -- and, one level down, in every
atlas.Map built as a literal rather than through NewWebMercatorMap, of which
there are two dozen in this tree. nil means the same thing at both hops.

The gate sits in Service.collection and Service.collections, which is all
of it: every route taking a collection id resolves through the former, so
the listing, the collection document, its tilesets and its tiles all stop
answering for a hidden layer together. It is a not-found rather than an
error of its own, because to a client the collection does not exist, and
distinguishing the two would describe the config to anyone who can guess a
layer name.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* docs(ogc): describe serve_layer_collections (MAPCO-11493)

The collections section explains the two-tier model; the flag is the part of
it a map can decline, so it belongs next to the explanation rather than only
in the configuration reference.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* docs(ogc): separate whole-map and layer tiles in the caching section (MAPCO-11493)

The section said tile requests use the same cache keys `shigola... (continued)

12 of 12 new or added lines in 3 files covered. (100.0%)

5287 of 9747 relevant lines covered (54.24%)

130.79 hits per line