directus_api_manager 1.14.0

Communicate with a Directus server using its REST API.

1.14.0 - 2025/05/29

• Added new filter operators : containsCaseInsensitive, startsWithCaseInsensitive, endsWithCaseInsensitive, notStartsWithCaseInsensitive, notEndsWithCaseInsensitive
• added const keys for directus_user and directus_data properties to avoid hardcoded strings in request we will make with filters

1.13.0 - 2025/05/28

• Updated to latest dart version and dependencies
• Added strict return types when possible instead of dynamic
• Fixed warnings raised with newer dart version lints

1.12.2 - 2025/03/28

• Reflects previous change to abstract class IDirectusApiManager

1.12.1 - 2025/03/11

• Avoid error when the cache file is present but empty

1.12.0 - 2025/02/05

• Added new GeoFilter class for geospatial filtering
• Added new GeoJsonPolygon class with three constructors for creating geographical areas:
  • rectangle: Creates a rectangular area from top-left and bottom-right coordinates
  • polygon: Creates a custom polygon from a list of coordinates
  • squareFromCenter: Creates a square area from a center point and distance in meters
• Added GeoFilterOperator enum for geospatial operations
• Moved geospatial filtering functionality from PropertyFilter to dedicated GeoFilter class
• Updated documentation with examples for geospatial filtering

1.11.0 - 2025/02/04

• Simplified Websocket subscription creations and stops and added documentation
• Improved websocket keep alive and disconnects when network is lost
• Added more functions inside DirectusApiError to try to extract valuable information from failed api results
• Added a MemoryCacheEngine that can be used to store the cache in memory
• Added new parameters to provide extra caching invalidation : both manual and automatic.
• Automatically invalidate cached data linked to created, updated or deleted objects
• Added more cache documentation

1.10.0 - 2024/12/31

• Improved locking mechanism to avoid multiple refresh token requests at the same time
• Added somne locking to json cache file accesses to prevent multiple writes at the same time
• reduced the amount of read write into the file system for the json cache implementation
• Changed keys and file naming for the json cache files to avoid issues with the file system with filenames being too long
• Added the requested url within the cached meta data Possible breaking : if apps were using the json cache, the cache files will be renamed and previous cached files will be ignored. On next cache clean, they will be removed.

1.9.7 - 2024/12/20

• logoutDirectusUser should also clear the cachedCurrentUser variable

1.9.6 - 2024/12/20

• logoutDirectusUser now clears all the cache from the specified cache engine

1.9.5 - 2024/12/18

• Fix : Cache should only save response with status code 200 ... 299
• Automatically clear list caches when adding or removing items of the same type

1.9.4 - 2024/12/18

• Allow to add extra fields when a file is uploaded

1.9.3 - 2024/12/09

• Make the test 'Creating an invalid user should throw' pass after 1.9.0 implementation of optional email field.

1.9.2 - 2024/11/25

• Improved refresh token handling when reloading the app after a long time.

1.9.1 - 2024/11/14

• Added new properties that can be used on DirectusUser to get/set the user's status. An UserStatus enum is provided that matches possible values offered by the Directus team.

1.9.0 - 2024/11/04

• Added a new API for registering a new user (which is different from creating a user object in Directus). See https://docs.directus.io/reference/authentication.html#register
• Improved update return : now returns the server returned object and not the one sent to the server.
• User email field is now optional to better reflect what actually happens in Directus. When reading an user object, directus will return the fields the current user has access, if the user doesn't have access to the "email" field then the value will be null.
• Added more convenience init and properties on directus_item and directus_data

1.8.2 - 2024/10/08

Added an automatic cache invalidation when updating or deleting any specific item.

1.8.1 - 2024/10/08

Bug Fix: Updating the current user was not invalidating the current user caches (variable and cache engine)

1.8.0 - 2024/09/27

New feature: local cache and basic offline mode support 🔥

This version offers a ready to use cache engine based on json files. It is disabled by default, check the readme for more information on how to enable and use it in your projects.

1.7.7 - 2024/08/21

This version adds a new feature:

• adds the "DirectusGeometryType" class to manage the geometry type of Postgres databases.
• Currently it can load any geometry type from a JSON object
• Currently it exposes convenience constructor and properties for the Point type used in regular geometry (x,y) or in map context (longitude, latitude)
• Add addSubscription and removeSubscription to make the use of websocket more easy

1.7.6 - 2024/07/09

This version adds a new feature:

• expose the DirectusData class
• expose the baseUrl variable

1.7.5 - 2024/03/19

This version adds a new feature:

• allow to specify the fields that can be updated if there is difference with the fields that can be seen.

1.7.4 - 2024/03/14

This version adds a new feature:

• allow to force item update even if the object has no change

1.7.3 - 2024/02/21

This version adds a new feature:

• add One Time Password login capability

1.7.1 - 2023/09/03

Bug Fix :

• the multi delete items function was not building the request url correctly.

1.7.0 - 2023/06/29

This version add some new features :

• add web socket support
• expose the refresh token

1.6.2 - 2023/06/24

This version add some new features :

• the directus file can be upload to the specify storage

• the Directus Data has a new getter bool hasChangedIn({required String forKey}) which allow to know if the property has been changed.

Bug Fix :

• the multi delete file function was not able to delete files.

1.6.1 - 2023/05/31

This version expose the access token. The goal was to get benefit of the authorization features of Directus in order to get files.

Changed

• DirectusAPIMAnager.accessToken is now readable
• DirectusAPIMAnager.shouldRefreshToken is now readable
• DirectusAPIMAnager.tryAndRefreshToken() can now be trigger by your app

1.6.0 - 2023/05/31

This version add the DirectusFile class as an extension of DirectusData. This allow us to manage file like other collections.

Breaking change

• DirectusFile class extend DirectusData.
• DirectusFile constructor has been changed to respect DirectusData constructor.
• DirectusFile.fromJSON(Map<String, dynamic> jsonData) is deprecated and replace by DirectusFile default constructor
• DirectusFile has a new constructor to quickly create an object based on his id.
• DirectusFile(this.id, {this.title})has been replaced by DirectusFile.fromId(String id, {String? title})

Additional Changed

• DirectusFile class as some getters and setters for the default fields of the directus_files table

1.0.0

• Initial version.