Client api support - Getinstances/listinstanceids

[YunchuWang]

This pull request adds advanced querying and pagination capabilities for orchestration instances in the Durable Task JS SDK. It introduces new types and utilities for paginated queries, implements two new methods on the TaskHubGrpcClient for querying orchestration states and listing instance IDs, and exports these new APIs for public use.

New querying and pagination features:

• Added OrchestrationQuery, ListInstanceIdsOptions, and DEFAULT_PAGE_SIZE types to support flexible filtering and paging of orchestration instances.
• Introduced Page, AsyncPageable, and createAsyncPageable utilities to provide async iteration over paginated results.

Client API enhancements:

• Implemented getAllInstances method on TaskHubGrpcClient to query orchestration instances with flexible filters and return results as an AsyncPageable for both item and page-wise async iteration.
• Added listInstanceIds method for efficient, key-based pagination of instance IDs without fetching full instance metadata.
• Added a helper method to convert protobuf orchestration state objects to SDK OrchestrationState instances.

Public API exports:

• Exported the new query and pagination types and utilities from the package entry point for public use.
• Updated imports to include new types and conversion helpers in the client implementation.

[Copilot]

Pull request overview

This pull request adds comprehensive querying and pagination capabilities for orchestration instances in the Durable Task JavaScript SDK. The implementation introduces new types for flexible filtering and pagination, implements two new client methods for querying orchestration states and listing instance IDs, and exports these APIs for public use.

Changes:

• Added pagination infrastructure with Page, AsyncPageable, and createAsyncPageable utilities to support async iteration over paginated results
• Introduced OrchestrationQuery and ListInstanceIdsOptions interfaces for flexible filtering and pagination of orchestration instances
• Implemented getAllInstances and listInstanceIds methods on TaskHubGrpcClient with comprehensive E2E and unit tests

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
packages/durabletask-js/src/orchestration/page.ts	Implements Page class and AsyncPageable utilities for pagination support
packages/durabletask-js/src/orchestration/orchestration-query.ts	Defines query and filtering interfaces with default page size constant
packages/durabletask-js/src/client/client.ts	Adds getAllInstances and listInstanceIds methods with helper for proto-to-SDK state conversion
packages/durabletask-js/src/index.ts	Exports new query types and pagination utilities for public API
packages/durabletask-js/test/query-apis.spec.ts	Unit tests for pagination and query type validation
test/e2e-azuremanaged/query-apis.spec.ts	Comprehensive E2E tests covering various query scenarios and edge cases

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.