developmentseed / developmentseed/titiler-covjson

Expand the resolver seam to STAC collections/items (and MosaicJSON)

Open
#69 0 comments 0 reactions 0 assignees View on GitHub
deferred
Dominant language
Python
Stars
1
Forks
1
Avg merge
2d 1h
Merged PRs (30d)
12

Description

Expand the factory's backing from a single dataset to a backing-agnostic resolver over STAC collections/items (and MosaicJSON). Foundational, deferred work; filed by the roadmap-realignment audit (it threads through Story 9 and the EPIC's "readers (COG, STAC, MosaicJSON)" acceptance criterion, but had no issue).

## Context

Today the resolver is single-dataset (`url=` / `DatasetParams`, 2-D, no `t`). [ADR-0001](https://github.com/developmentseed/titiler-covjson/blob/main/docs/adr/0001-covjson-http-api-direction.md) designed the resolver as a single backing-agnostic seam and **deliberately deferred** a multi-source backing, explicitly rejecting a premature `titiler-stacapi` coupling.

## Why it is foundational

Expanding the seam unlocks three capabilities at once:

- **A real `t` source** (STAC item datetimes) -> the Temporal endpoint surface (the temporal umbrella depends on this).
- **EDR `collectionId` addressing** (STAC collection IDs double as EDR `collectionId`s).
- **Multi-item CoverageCollection** (#24).

It also completes the EPIC's "readers (COG, STAC, MosaicJSON) works" acceptance criterion -- only COG is wired today.

## Options

STAC-first via `titiler-stacapi` is the recommended option; a time-dimensioned NetCDF/Zarr via xarray is an alternative (ADR-0001).

## Status

Foundational / deferred. No milestone. **Blocks** the temporal-surface umbrella (#68) and #24 (CoverageCollection).

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with docs/adr/0001-covjson-http-api-direction.md and trace the current single-dataset resolver using url= and DatasetParams. Define the scope against the stated STAC-first option and its temporal, collectionId, CoverageCollection, and MosaicJSON requirements; done means the resolver seam supports the agreed multi-source backing without premature coupling.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
backend-api-design
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.