shelving 1.128.0 → 1.128.1

package/db/ItemStore.js

@@ -1,8 +1,8 @@
+import { RequiredError } from "../error/RequiredError.js";
 import { BooleanStore } from "../store/BooleanStore.js";
 import { OptionalDataStore } from "../store/DataStore.js";
 import { NONE } from "../util/constants.js";
 import { getItem } from "../util/item.js";
-import { getRequired } from "../util/optional.js";
 import { runSequence } from "../util/sequence.js";
 /** Store a single item. */
 export class ItemStore extends OptionalDataStore {
@@ -12,7 +12,10 @@ export class ItemStore extends OptionalDataStore {
     busy = new BooleanStore();
     /** Get the data of this store (throws `RequiredError` if item doesn't exist). */
     get data() {
-        return getRequired(this.value);
+        const item = this.value;
+        if (!item)
+            throw new RequiredError(`Item must exist in "${this.collection}"`, this.id);
+        return item;
     }
     /** Set the data of this store. */
     set data(data) {

package/db/QueryStore.d.ts

@@ -15,6 +15,10 @@ export declare class QueryStore<T extends Database, K extends DataKey<T>> extend
     /** Can more items be loaded after the current result. */
     get hasMore(): boolean;
     private _hasMore;
+    /** Get the first item in this store. */
+    get first(): Item<T[K]>;
+    /** Get the last item in this store. */
+    get last(): Item<T[K]>;
     constructor(collection: K, query: ItemQuery<T[K]>, provider: AbstractProvider<T>, memory?: MemoryProvider<T>);
     /** Refresh this store from the source provider. */
     refresh(provider?: AbstractProvider<T>): void;

package/db/QueryStore.js

@@ -1,3 +1,5 @@
+import { collection, query } from "firebase/firestore";
+import { RequiredError } from "../error/RequiredError.js";
 import { ArrayStore } from "../store/ArrayStore.js";
 import { BooleanStore } from "../store/BooleanStore.js";
 import { NONE } from "../util/constants.js";
@@ -15,6 +17,20 @@ export class QueryStore extends ArrayStore {
         return this._hasMore;
     }
     _hasMore = false;
+    /** Get the first item in this store. */
+    get first() {
+        const first = this.optionalFirst;
+        if (!first)
+            throw new RequiredError(`First item must exist in "${collection}"`, query);
+        return first;
+    }
+    /** Get the last item in this store. */
+    get last() {
+        const last = this.optionalLast;
+        if (!last)
+            throw new RequiredError(`Last item must exist in "${collection}"`, query);
+        return last;
+    }
     constructor(collection, query, provider, memory) {
         const time = memory?.getQueryTime(collection, query);
         const items = memory?.getQuery(collection, query) || [];

package/package.json

@@ -11,7 +11,7 @@
 		"state-management",
 		"query-builder"
 	],
-	"version": "1.128.0",
+	"version": "1.128.1",
 	"repository": "https://github.com/dhoulb/shelving",
 	"author": "Dave Houlbrooke <dave@shax.com>",
 	"license": "0BSD",