Skip to content

CHANGELOG.md

Latest commit

 

History

History
379 lines (231 loc) · 10.6 KB

CHANGELOG.md

File metadata and controls

379 lines (231 loc) · 10.6 KB

Change Log - @itwin/itwins-client

3.0.0

Major Changes

3.0.0 - 2026-04-21

Use strict graphics provider unions and plain string public identifiers

BREAKING CHANGE: RepositoryClass, RepositorySubClass, and GraphicsContentType are now plain string aliases instead of string unions.

BREAKING CHANGE: GraphicsProvider is now a discriminated union keyed by provider name, and GraphicsProviderOptions is now a union of the provider-specific option interfaces instead of a merged superset interface.

This also removes the remaining repository resource response literals that previously narrowed repository class values to a smaller fixed set.

Before:

type RepositoryClass =
  | "iModels"
  | "Storage"
  | "Forms"
  | "RealityData"
  | "GeographicInformationSystem";

type RepositorySubClass = "WebMapService" | "WebMapTileService" | "ArcGIS";

type GraphicsContentType =
  | "3DTILES"
  | "GLTF"
  | "IMAGERY"
  | "TERRAIN"
  | "KML"
  | "CZML"
  | "GEOJSON"
  | "OAPIF+GEOJSON";

interface GraphicsProviderOptions {
  tilingScheme?: string;
  bounds?: [number, number, number, number];
  credit?: string;
  mapType?: string;
  url?: string;
  session?: string;
  tileWidth?: number;
  tileHeight?: number;
  imageFormat?: string;
  [key: string]: unknown;
}

interface GraphicsProvider {
  name: string;
  options: GraphicsProviderOptions;
}

After:

type RepositoryClass = string;
type RepositorySubClass = string;
type GraphicsContentType = string;

type GraphicsProvider = UrlTemplateImageryProvider | Google2DImageryProvider;

type GraphicsProviderOptions =
  | UrlTemplateImageryProviderOptions
  | Google2DImageryProviderOptions;

Migration:

  • Existing calls that already pass string literals continue to work unchanged.
  • Code that relied on exhaustive autocomplete or literal-union narrowing for repository class, subClass, and graphics type values should now treat those values as API-provided strings.
  • Narrow GraphicsProvider by name before reading provider-specific option fields.
  • Code that extended GraphicsProviderOptions should switch to one of the concrete option interfaces or use composition instead of interface inheritance.

Minor Changes

2.6.0 - 2026-04-21

Add Global Repositories endpoint methods

Added new @beta methods for the Global Repositories Technical Preview APIs:

  • getGlobalRepositories
  • getGlobalRepository
  • getGlobalRepositoryResource
  • getGlobalRepositoryResources
  • getGlobalResourceGraphics

The implementation reuses the existing repository and repository-resource response types, and expands the shared graphics provider options model to cover the Google provider metadata returned by the global graphics endpoint.

Patch Changes

2.5.5 - 2026-04-21

Fixed audit issue with lodash by adding a package resolution

2.5.5 - 2026-04-21

Fixed audit issue coming from changesets cli

2.5.4

Patch Changes

2.5.4 - 2026-03-26

Fixed audit issue coming from changesets cli

2.5.3

Patch Changes

2.5.3 - 2026-03-19

Fixed audit issues with dev packages

2.5.2

Patch Changes

2.5.2 - 2026-02-16

Updated repository interface to make subclass optional and move properties into resource object for GetRepositoryResourceRepresentationResponse

2.5.1

Patch Changes

2.5.1 - 2026-02-12

Added browser support for redirects. Previously we only supported node enviroment

2.5.0

Minor Changes

2.5.0 - 2026-01-28

Added 3 New Methods To Itwins Client To Support Federated Architecture Support:

  • getRepositoryResourcesByUri() - Retrieve multiple resources with OData support

  • getRepositoryResourceByUri() - Retrieve single resource

  • getResourceGraphicsByUri() - Retrieve graphics metadata

Added support for redirects in the following methods :

  • getRepositoryResource()

  • getRepositoryResources()

  • getResourceGraphics()

  • All URI-based methods

2.4.0

Minor Changes

2.4.0 - 2026-01-09

Added new repo class "SensorData" to string union for repo classes

2.3.0

Minor Changes

2.3.0 - 2025-11-05

API Method: Added deleteRepositoryResource() method to iTwinsClient class for deleting repository resources

2.2.0

Minor Changes

2.2.0 - 2025-10-15

Enhanced type safety with conditional return types

Added conditional return types to methods that support both minimal and representation responses. Return types now automatically infer based on the resultMode parameter, providing better IntelliSense and compile-time type checking.

**Enhanced Methods:**

- getFavoritesITwins

- getRecentUsedITwins

- getITwins

- getITwin

- getRepositoryResource

- getRepositoryResources

- getITwinAccount

**Before:**

const result = await client.getITwin(token, "id", "representation");

// Type: BentleyAPIResponse<ITwinMinimalResponse | ITwinRepresentationResponse>

const result = await client.getITwin(token, "id", "representation");

// Type: BentleyAPIResponse<ITwinRepresentationResponse>

2.1.0

Minor Changes

2.1.0 - 2025-10-13

feat: update repository interface and capabilities, and fix esm module compatibility with nodeNext

- Modified the Repository interface to make 'id' and 'displayName' required fields.

- Added 'capabilities' field to the Repository interface to define supported operations.

- Updated NewRepositoryConfig to reflect changes in the Repository interface.

- Changed exports in itwins-client.ts to include .js extensions for compatibility.

- Updated TypeScript configuration to target ES2022 and enable synthetic default imports.

2.0.0

Major Changes

2.0.0 - 2025-10-03

  • Added new enum values ArcGIS and UrlTemplate to RepositorySubClass and removed MapServer. Created ts configs that only have one responsibility. Switched testing framework to vite. Fixed broken test. Upgraded package to use modern ts and eslint packages. Added the ability to debug tests. Added launch config and recommend plugins. (commit)
  • Complete API redesign with breaking changes

MAJOR CHANGES:

  • ITwinsAccessClient renamed to ITwinsClient
  • All method names updated (removed 'Async' suffix)
  • Enums converted to string union types
  • Response structure changes with new data wrappers
  • Type system improvements with ITwinMinimal/ITwinRepresentation split
  • New repository resources, exports, and image management APIs
  • HAL specification compliance with _links navigation

See MIGRATION-GUIDE-v1-to-v2.md for detailed migration instructions and examples. (commit)

Minor changes

  • feat: replace axios with fetch and refactor base client (commit)
  • Enhance repository creation with NewRepositoryConfig interface and update related methods. Can no longer try to create repos with auto generated values. (commit)

1.6.1

Patch Changes

1.6.1 - 2024-12-13

  • Added missing properties when accesing these methods:
    • queryAsync
    • queryFavoritesAsync
    • queryRecentsAsync
  • Missing properties:
    • includeInactive
    • status
    • subClass
    • parentId
    • iTwinAccountId

1.6.0

Minor Changes

1.6.0 - 2024-12-03

  • Updated methods so that subClass is no longer mandatory.
    • queryAsync
    • queryFavoritesAsync
    • queryRecentsAsync
  • Marked subClass as a depricated property.
  • Included subClass to be provided from the arg property.

1.5.0

Minor Changes

1.5.0 - 2024-07-22

  • Added three new properties to the iTwin interface.

    • ianaTimeZone
    • imageName
    • image

  • Added three new values to the iTwinSubClass enum.

    • Portfolio
    • Program
    • WorkPackage

1.4.0

Minor Changes

1.4.0 - 2024-05-29

  • Added getAccountAsync method on ITwinsAccessClient

1.3.0

Minor Changes

1.3.0 - 2024-04-19

  • Added Query Scope query argument, to allow for querying to be expanded outside of just the iTwins you are a member of (which only applies to Administrators).

1.2.1

Patch Changes

1.2.1 - 2023-11-15

  • Upgraded axios dependency due to vulnerabilities in earlier versions.

1.2.0

Minor Changes

1.2.0 - 2023-06-05

  • Added optional iTwin result mode parameter to enable fetching data in "representation" mode.

1.1.0

Minor Changes

1.1.0 - 2022-10-07

  • Added constructor parameter to iTwinsClient for custom url.

1.0.1

Patch Changes

1.0.1 - 2022-09-25

  • Updated code owners.
  • Updated GettingStarted with new environment variable names.

1.0.0

Major Changes

1.0.0 - 2022-09-23

  • Added POST, PATCH, and DELETE operations for iTwins and iTwin Repositories.
  • Added additional integration tests for the new operations.
  • Added usage examples for CRUD operations for iTwins and Repositories.

0.9.0

Major Changes

0.9.0 - 2022-09-20

  • Initial commit with only iTwin query operations.