Skip to content

[Feature] REST API entity provider — Phase 1 (read-only, OpenAPI-typed, incremental cursor) #200

Description

@jtdossett

Summary

A read-only rest-api entity provider: OpenAPI-3-typed schema, cursor-based incremental reads via IncrementalReadableEntityProvider, opaque cursor semantics with the watermark subsystem owning the commit point.

Proposal source: docs/proposals/rest_api_entity_provider.md (2026-07-27)

Current state

Not started — no rest-api/OpenAPI references in packages/. The contracts it composes exist and match the spec.

Scope (Phase 1)

Local OpenAPI 3 document, one GET operation, explicit Spark schema, next_link/offset pagination, timestamp cursor, mock-server unit tests plus watermark integration tests. Phases 2–3 per the proposal as follow-ons.

Size: L (Phase 1 alone M/L)

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Medium priorityfeatureDeliverable featureprovidersEntity providers

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions