isar 3.0.0-dev.15

Extremely fast, easy to use, and fully async NoSQL database for Flutter.

3.0.0-dev.15

Enhancements

• Improved the Inspector and re-enabled it

Fixes

• Fixed IsarLink.toString() and IsarLinks.toString()
• Isar generator threw an exception for unknown List types

3.0.0-dev.14

Enhancements

• Added ignore parameter to @Collection() and @Enum()
• Added fireImmediately to collection.watchLazy() and query.watchLazy()

Fixes

• Fixed incorrectly generated String list filters
• Fixed failing version migration

Breaking

• Renamed the initialReturn parameter to fireImmediately

3.0.0-dev.13

Enhancements

• Added stringIsEmpty() and stringIsNotEmpty() filters
• Added query.isEmpty(), query.isEmptySync(), query.isNotEmpty() and query.isNotEmptySync() operations
• Improved aggregation performance
• The Id type changed from int to num on web
• Isar.autoIncrement is now const

Fixes

• Removed incorrectly generated embedded filters
• Fixed remaining embedded filters
• Fixed schema migration

Breaking

• Due to incompatibilities, Android <= 6.0 now requires you to provide a directory to Isar.open()

3.0.0-dev.12

Enhancements

Small performance improvements across the board.

Breaking

Removed IsarEnum in favor of the @enumerated and @Enumerated() annotations. Check #583 for more details.

3.0.0-dev.10

Hotfix: Missing symbols on Android.

3.0.0-dev.9

This is the last big feature release before a stable 3.0 version. Unfortunately, this version does not work with the inspector yet. Stay tuned for the next release.

Enhancements

• Support for embedded objects using @Embedded()
• Support for enums using IsarEnum mixin
• Improved put() performance by about 50% (yes, that is insane)
• Added linksLengthEqualTo(), linksIsEmpty(), linksIsNotEmpty(), linksLengthGreaterThan(), linksLengthLessThan(), linksLengthBetween() and linkIsNull() filters
• Added listLengthEqualTo(), listIsEmpty(), listIsNotEmpty(), listLengthGreaterThan(), listLengthLessThan(), listLengthBetween() filters
• Added isNotNull() filters
• Added compactOnLaunch conditions to Isar.open() for automatic database compaction
• Added isar.copyToFile() which copies a compacted version of the database to a path
• Added isar.path to get the full path of the database file
• Added collection.schema to receive the layout of a collection
• Added check to verify that linked collections schemas are provided for opening an instance
• Added @collection and @embedded alternative to @Collection() and @Embedded()
• Apply default values from constructor during deserialization
• Added isar.verify() and col.verify() methods for checking database integrity in unit tests
• Added missing float and double queries and an epsilon parameter

Breaking

• Renamed isar.path to isar.directory
• Removed support for type converters

Fixes

• Fixed nested link queries
• Minor fixes for query edge cases
• Memory is now always initialized before it gets stored
• An exception is now thrown when a sync write txn is started while an async write txn is active. This prevents deadlock.
• Fixed download directory on Windows

3.0.0-dev.8

Enhancements

• Really cool new Inspector
• Much improved consistency of IsarLinks behavior
• IsarLinks now support all Set methods based on the Isar Id rather the identity() of objects
• A lot of new unit tests to make links bulletproof

Fixes

• Fixed issues with edge cases in IsarLink and IsarLinks
• Fixed link queries and filters

3.0.0-dev.7

Small hotfix: existing bool properties were rejected in schema migration.

3.0.0-dev.6

⚠️ BE CAREFUL ⚠️ This version of Isar uses an experimental binary format does not allow downgrading.

Enhancements

• Vastly improved Isar binary format space efficiency resulting in up to 20% smaller databases
• Slightly improved String index space efficiency saving two bytes per string
• On non-web platforms, IsarLink and IsarLinks will load automatically
• .putSync(), .putAllSync() etc. will now save links recursively by default
• Improved .putSync() and .putIndexedSync() performance
• Added isar.getSize() and isar.getSizeSync()
• Reintroduced option to disable the inspector
• Slightly improved default collection accessor naming
• Id property queries now always return a List<int> even if the id is nullable
• Added id, byte, short and float typedefs
• Uint8List properties now support multi-entry indexes

Breaking

• Removed @Id() and @Size32() annotations
• Changed the default index type for all Lists to IndexType.hash
• Renamed isar.getCollection() to isar.collection()
• The maximum size of objects is now 16MB
• It is no longer allowed to extend or implement another collection
• Unsupported properties will no longer be ignored by default

Fixes

• Fixed missing symbols on 32-bit Android 5 & 6 devices
• Fixed inconsistent null handling in json export
• Fixed default directory issue on Android
• Fixed different where clauses returning duplicate results
• Fixed hash index issue where multiple list values resulted in the same hash
• Fixed edge case where creating a new index failed

3.0.0-dev.5

Fixes

• Fixed dropped database on hot restart

3.0.0-dev.4

Fixes

• Allow more ffi versions
• Another Inspector fix

3.0.0-dev.3

Enhancements

• Made providing a path optional
• Added isar.path property
• The default Isar name is now default. On non-web targets, migration will happen automatically.
• The isar database file is now stored in the location dir/name.isar the lock file in dir/name.isar.lock. Migration will happen automatically.

Breaking

• Changed the schemas parameter from named to positional
• Isar will no longer create the provided directory. Make sure it exists before opening an Isar Instance.

Fixes

• Fixed an Isar Inspector issue with non-default instance names

3.0.0-dev.2

Enhancements

• Support for much more complex composite index queries
• Support for logical XOR and the .oneOf() query modifier
• Internal query methods not longer appear in auto complete results
• A lot more unit tests especially for where clauses

Breaking

• Fixed .or() instead of .and() being used implicitly when combining filters
• Renamed multi-entry where clauses from .yourListAnyEqualTo() to .yourListElementEqualTo() to avoid confusion

Fixes

• More link fixes
• Fixed composite query issues
• Fixed crash caused by empty and/or filter
• Fixed incorrect analyzer dependency

3.0.0-dev.1

Breaking

• collection.put() and collection.putAll() no longer allow saving links

Enhancements

• Vastly improved collection.count() and collection.countSync() performance
• Vastly improved collection.put() and collection.putAll() performance for objects containing links
• Added collection.getSize() and collection.getSizeSync()
• Added query.anyOf() and query.allOf() query modifiers
• Added query.isar getter to retrieve the isar instance of a query
• Support strict-casts: true

Breaking

• Removed isar parameter from Isar.txn(), Isar.writeTxn(), Isar.txnSync() and Isar.writeTxnSync()
• Removed query.repeat()
• Removed query.sortById() and query.distinctById() (these were generated by mistake)
• Removed saveLinks parameter from collection.put() and collection.putAll() (links are saved by default)
• Removed inspector parameter from Isar.open() it is now always active for debug builds
• IsarLinks no longer save new objects

Fixes

• Fixed error retrieving the id property in a query
• Links are now handled correctly in collection.put() and collection.putAll()

3.0.0-dev.0

Enhancements

• Added download option to Isar.initializeIsarCore() to download binaries automatically. This is useful for unit tests
• Added replace option for indexes
• Added verification for correct Isar binary version

Breaking

• Renamed Isar.initializeLibraries() to Isar.initializeIsarCore()
• Removed replaceOnConflict parameter from collection.put() and collection.putAll()

Fixes

• Fixed issues with binaries of the previous version
• Providing a path is now optional in isolates

2.5.0

Enhancements

• Support for Android x86 (32 bit emulator) and macOS arm64 (Apple Silicon)
• Greatly improved test coverage for sync methods
• col.clear() now resets the auto increment counter to 0
• Significantly reduced Isar Core binary size (about 1.4MB -> 800KB)

Minor Breaking

• Changed initializeLibraries(Map<String, String> libraries) to initializeLibraries(Map<IsarAbi, String> libraries)
• Changed min Dart SDK to 2.16.0

Fixes

• Fixed issue with IsarLink.saveSync()
• Fixed id queries
• Fixed error thrown by BroadcastChannel in Firefox
• Fixed Isar Inspector connection issue

2.4.0

Enhancements

• Support for querying links
• Support for filtering and sorting links
• Added methods to update and count links without loading them
• Added isLoaded property to links
• Added methods to count the number of objects in a collection
• Big internal improvements

Minor Breaking

• There are now different kinds of where clauses for dynamic queries
• isar.getCollection() no longer requires the name of the collection
• Isar.instanceNames now returns a Set instead of a List

Fixes

• Fixed iOS crash that frequently happened on older devices
• Fixed 32bit issue on Android
• Fixed link issues
• Fixed missing BroadcastChannel API for older Safari versions

2.2.1

Enhancements

• Reduced Isar web code size by 50%
• Made directory parameter of Isar.open() optional for web
• Made name parameter of Isar.getInstance() optional
• Added Isar.defaultName constant
• Enabled TypeConverters with supertypes
• Added message if TypeConverter nullability doesn't match
• Added more tests

Fixes

• Fixed issue with date queries
• Fixed FilterGroup.not constructor (thanks for the PR @jtzell)

2.2.0

Isar now has full web support 🎉. No changes to your code required, just run it.

Web passes all unit tests but is still considered beta for now.

Minor Breaking

• Added saveLinks parameter to .put() and .putAll() which defaults to false
• Changed default overrideChanges parameter of links.load() to true to avoid unintended behavior

Enhancements

• Full web support!
• Improved write performance
• Added deleteFromDisk option to isar.close()
• Added .reset() and .resetSync() methods to IsarLink and IsarLinks
• Improved links.save() performance
• Added many tests

Fixed

• Fixed value of null dates to be DateTime.fromMillisecondsSinceEpoch(0)
• Fixed problem with migration
• Fixed incorrect list values for new properties ([] instead of null)
• Improved handling of link edge-cases

2.1.4

• Removed path dependency
• Fixed incorrect return value of deleteByIndex()
• Fixed wrong auto increment ids in some cases (thanks @robban112)
• Fixed an issue with Isar.close() (thanks @msxenon)
• Fixed $ escaping in generated code (thanks @jtzell)
• Fixed broken link in pub.dev example page

2.1.0

isar_connect is now integrated into isar

Enhancements

• Added check for outdated generated files
• Added check for changed schema across isolates
• Added Isar.openSync()
• Added col.importJsonRawSync(), col.importJsonSync(), query.exportJsonRawSync(), query.exportJsonSync()
• Improved performance for queries
• Improved handling of ffi memory
• More tests

Fixed

• Fixed issue where imported json required existing ids
• Fixed issue with transaction handling (thanks @Peng-Qian for the awesome help)
• Fixed issue with @Ignore annotation not always working
• Fixed issue with getByIndex() not returning correct object id (thanks @jtzell)

2.0.0

Breaking

• The id for non-final objects is now assigned automatically after .put() and .putSync()
• double and List<double> indexes can no longer be at the beginning of a composite index
• List<double> indexes can no longer be hashed
• .greaterThan(), .lessThan() and .between() filters and are now excluding for double values (>= -> >)
• Changed the default index type for lists to IndexType.value
• IsarLink and IsarLinks will no longer be initialized by Isar and must not be nullable or late.
• Dart 2.14 or higher is required

Enhancements

• Added API docs for all public methods
• Added isar.clear(), isar.clearSync(), col.clear() and col.clearSync()
• Added col.filter() as shortcut for col.where().filter()
• Added include parameter to .greaterThan() and .lessThan() filters and where clauses
• Added includeLower and includeUpper parameters to .between() filters and where clauses
• Added Isar.autoIncrement to allow non-nullable auto-incrementing ids
• Isar.close() now returns whether the last instance was closed
• List values in composite indexes are now of type IndexType.hash automatically
• Allowed multiple indexes on the same property
• Removed exported packages from API docs
• Improved generated code
• Improved Isar Core error messages
• Minor performance improvements
• Automatic XCode configuration
• Updated analyzer to 3.0.0
• More tests

Fixed

• IsarLink and IsarLinks can now be final
• Fixed multi-entry index queries returning items multiple times in some cases
• Fixed .anyLessThan() and .anyGreaterThan() issues
• Fixed issues with backlinks
• Fixed issue where query only returned the first 99999 results
• Fixed issue with id where clauses
• Fixed default index type for lists and bytes
• Fixed issue where renaming indexes was not possible
• Fixed issue where wrong index name was used for .getByX() and .deleteByX()
• Fixed issue where composite indexes did not allow non-hashed Strings as last value
• Fixed issue where @Ignore() fields were not ignored

1.0.5

Enhancements

• Updated dependencies

Fixes:

• Included desktop binaries
• Fixed "Cannot allocate memory" error on older iOS devices
• Fixed stripped binaries for iOS release builds
• Fixed IsarInspector issues (thanks to RubenBez and rizzi37)

1.0.0+1

Added missing binaries

1.0.0

Switched from liblmdb to libmdbx for better performance, more stability and many internal improvements.

Breaking

The internal database format has been changed to improve performance. Old databases do not work anymore!

Fixes

• Fix issue with links being removed after object update
• Fix String index problems

Enhancements

• Support greaterThan, lessThan and between queries for String values
• Support for inheritance (enabled by default)
• Support for final properties and getters
• Support for freezed and other code generators
• Support getting / deleting objects by a key col.deleteByName('Anne')
• Support for list indexes (hash an element based)
• Generator now creates individual files instead of one big file
• Allow specifying the collection accessor name
• Unsupported properties are now ignored automatically
• Returns the assigned ids after .put() operations (objects are no longer mutated)
• Introduces replaceOnConflict option for .put() (instead of specifying it for index)
• many more...

Internal

• Improve generated code
• Many new unit tests

0.4.0

Breaking

• Remove .where...In() and ...In() extension methods
• Split .watch(lazy: bool) into .watch() and .watchLazy()
• Remove include option for filters

Fixes

• Generate id for JSON imports that don't have an id
• Enable sortBy and thenBy generation

Enhancements

• Add .optional() and .repeat() query modifiers
• Support property queries
• Support query aggregation
• Support dynamic queries (for custom query languages)
• Support multi package configuration with @ExternalCollection()
• Add caseSensitive option to .distinctBy()

Internal

• Change iOS linking
• Improve generated code
• Set up integration tests and improve unit tests
• Use CORE/0.4.0

0.2.0

• Link support
• Many improvements and fixes

0.1.0

• Support for links and backlinks

0.0.4

• Bugfixes and many improvements

0.0.2

Fix dependency issue

0.0.1

Initial release