refactor!: implement lazy iterators for several APIs (#4459)

Implement lazy iterators for:
- secrets
- views
- jobs
- functions
- materialized views

docs/src/js/classes/Connection.md

@@ -611,30 +611,42 @@ Return true if the connection has not been closed
 ### listJobs()
 
 ```ts
-abstract listJobs(): Promise<JobInfo[]>
+abstract listJobs(options?): Listing<JobInfo>
 ```
 
-List server-side jobs across the database's tables.
+Iterate lazily over server-side jobs across the database's tables.
+Use `for await...of`. Options control page size and the starting token.
+See [Listing](Listing.md) for pagination state and error behavior.
+
+#### Parameters
+
+* **options?**: [`ListingOptions`](../interfaces/ListingOptions.md)
 
 #### Returns
 
-`Promise`&lt;[`JobInfo`](../interfaces/JobInfo.md)[]&gt;
+[`Listing`](Listing.md)&lt;[`JobInfo`](../interfaces/JobInfo.md)&gt;
 
 ***
 
 ### listMaterializedViews()
 
 ```ts
-abstract listMaterializedViews(): Promise<string[]>
+abstract listMaterializedViews(options?): Listing<string>
 ```
 
 The names of the materialized views in this database.
 
-Found by reading every table's schema, so this costs an open per table.
+Iterate lazily with `for await...of`. Local listings inspect table schemas
+one page at a time. Options control page size and the starting token.
+See [Listing](Listing.md) for pagination state and error behavior.
+
+#### Parameters
+
+* **options?**: [`ListingOptions`](../interfaces/ListingOptions.md)
 
 #### Returns
 
-`Promise`&lt;`string`[]&gt;
+[`Listing`](Listing.md)&lt;`string`&gt;
 
 ***
 
@@ -735,20 +747,24 @@ A page of table names and an
 ### listViews()
 
 ```ts
-abstract listViews(namespacePath?): Promise<string[]>
+abstract listViews(namespacePath?, options?): Listing<string>
 ```
 
 The names of the views in one namespace.
 
 Names only; a definition comes from [describeView](Connection.md#describeview).
+Iterate lazily with `for await...of`. See [Listing](Listing.md) for pagination
+state and error behavior; options control page size and the starting token.
 
 #### Parameters
 
 * **namespacePath?**: `string`[]
 
+* **options?**: [`ListingOptions`](../interfaces/ListingOptions.md)
+
 #### Returns
 
-`Promise`&lt;`string`[]&gt;
+[`Listing`](Listing.md)&lt;`string`&gt;
 
 ***
 

docs/src/js/classes/Listing.md

@@ -0,0 +1,91 @@
+[**@lancedb/lancedb**](../README.md) • **Docs**
+
+***
+
+[@lancedb/lancedb](../globals.md) / Listing
+
+# Class: Listing<T>
+
+A lazy async iterator over database resources with pagination state.
+Requests occur during iteration; request errors terminate the iterator.
+
+## Example
+
+```ts
+for await (const name of connection.listViews([], { pageLimit: 20 })) {
+  console.log(name);
+}
+```
+
+## Type Parameters
+
+• **T**
+
+## Implements
+
+- `AsyncIterableIterator`<`T`>
+
+## Methods
+
+### \[asyncIterator\]()
+
+```ts
+asyncIterator: AsyncIterableIterator<T>
+```
+
+#### Returns
+
+`AsyncIterableIterator`&lt;`T`&gt;
+
+#### Implementation of
+
+`AsyncIterableIterator.[asyncIterator]`
+
+***
+
+### next()
+
+```ts
+next(): Promise<IteratorResult<T, any>>
+```
+
+Fetch the next item, requesting another page only when needed.
+
+#### Returns
+
+`Promise`&lt;`IteratorResult`&lt;`T`, `any`&gt;&gt;
+
+#### Implementation of
+
+`AsyncIterableIterator.next`
+
+***
+
+### numPageResults()
+
+```ts
+numPageResults(): number
+```
+
+Number of cached items available without another request.
+
+#### Returns
+
+`number`
+
+***
+
+### pageToken()
+
+```ts
+pageToken(): undefined | string
+```
+
+Token for the next request. Initially this is the supplied starting token.
+Returns undefined after fetching the final page, even with cached items.
+Drain the cache before saving a token to avoid skipping items on resumption.
+Failed requests terminate iteration and retain their token for a new iterator.
+
+#### Returns
+
+`undefined` \| `string`