Add storage index create indexOnly flag

CHANGELOG.md

@@ -5,7 +5,12 @@ The format is based on [keep a changelog](http://keepachangelog.com) and this pr
 
 ## [Unreleased]
 ### Fixed
-- Fixed linter-found test issue.
+- Fix linter-found test issue.
+- Fix storage index listing results sometimes being returned with incorrect order. 
+
+### Changed
+- Add create_time and update_time to returned storage engine writes acks.
+- Add storage index create flag to read only from the index.
 
 ## [1.28.1] - 2023-08-23
 ### Added

api/api.proto

@@ -950,6 +950,10 @@ message StorageObjectAck {
  string version = 3;
  // The owner of the object.
  string user_id = 4;
+ // The UNIX time (for gRPC clients) or ISO string (for REST clients) when the object was created.
+ google.protobuf.Timestamp create_time = 5;
+ // The UNIX time (for gRPC clients) or ISO string (for REST clients) when the object was last updated.
+ google.protobuf.Timestamp update_time = 6;
 }
 
 // Batch of acknowledgements for the storage object write.

index.d.ts

@@ -2321,12 +2321,13 @@ declare namespace nkruntime {
  *
  * @param name - Name of the new index. Must be unique.
  * @param collection - Collection of storage engine to index objects from.
- * @param key - Opt. Key of storage objects to index. Set to null, undefined or emtpy string to index all objects of collection.
+ * @param key - Key of storage objects to index. Set to null, undefined or emtpy string to index all objects of collection.
  * @param fields - Array of fields of object to index. The values of these fields will be searchable in the index.
  * @param maxEntries - Maximum number of entries to keep in the index.
+ * @param indexOnly - Opt. The returned values are fetched from the index only instead of the db, which might return a partial value. Defaults to false.
  * @throws {TypeError, GoError}
  */
- registerStorageIndex(name: string, collection: string, key: string, fields: string[], maxEntries: number): void;
+ registerStorageIndex(name: string, collection: string, key: string | void, fields: string[], maxEntries: number, indexOnly: boolean): void;
 
  /**
  * Register purchase notification Google handler.

runtime/runtime.go

@@ -838,7 +838,7 @@ type Initializer interface {
  RegisterEventSessionEnd(fn func(ctx context.Context, logger Logger, evt *api.Event)) error
 
  // Register a new storage index.
- RegisterStorageIndex(name, collection, key string, fields []string, maxEntries int) error
+ RegisterStorageIndex(name, collection, key string, fields []string, maxEntries int, indexOnly bool) error
 
  // RegisterStorageIndexFilter can be used to define a filtering function for a given storage index.
  RegisterStorageIndexFilter(indexName string, fn func(ctx context.Context, logger Logger, db *sql.DB, nk NakamaModule, write *StorageWrite) bool) error