Iterator

Provides a way to access elements of a collection sequentially without exposing its underlying representation.

Why we need this / what value this brings

Lets calling code traverse a collection uniformly regardless of whether it's a list, tree, or paginated remote source.

When to use this

You need uniform, sequential traversal over a collection whose internal structure shouldn't leak to callers — most languages/frameworks give you this for free via built-in iteration protocols.

How to use or implement this

In Python/TypeScript this is almost always the language's built-in iterator protocol (__iter__/__next__, generators, async iterators) rather than a hand-rolled iterator class.

Research questions

• Cursor-based pagination over bookings/reviews lists is the practical form this takes at Localz — worth checking it's implemented as a proper (async) iterator/generator rather than manual offset math scattered across call sites.

---

Empty folder — drop notes, links, and findings here as you research.