shelving 1.68.2 → 1.68.3

package/feedback/Feedback.js

@@ -1,5 +1,5 @@
 import { debug } from "../util/debug.js";
-import { toTitle } from "../util/string.js";
+import { getTitle } from "../util/string.js";
 /**
  * The `Feedback` class represents a feedback message that should be shown to the user.
  * - Basic `Feedback` is neither good nor bad, `SuccessFeedback` indicates good news, and `ErrorFeedback` indicates bad news.
@@ -27,7 +27,7 @@ export class Feedback {
             if (v instanceof Feedback)
                 messages[k] = v.feedback;
             else
-                messages[k] = toTitle(v);
+                messages[k] = getTitle(v);
         }
         return messages;
     }

package/firestore/client/FirestoreClientProvider.d.ts

@@ -2,9 +2,9 @@ import type { Firestore } from "firebase/firestore";
 import type { DocumentReference, QueryReference } from "../../db/Reference.js";
 import type { Data, Entities, OptionalEntity } from "../../util/data.js";
 import type { Unsubscribe } from "../../observe/Observable.js";
+import { Observer } from "../../observe/Observer.js";
 import { AsynchronousProvider, Provider } from "../../provider/Provider.js";
 import { DataUpdate } from "../../update/DataUpdate.js";
-import { Observer } from "../../observe/Observer.js";
 /**
  * Firestore client database provider.
  * - Works with the Firebase JS SDK.

package/firestore/client/FirestoreClientProvider.js

@@ -1,11 +1,13 @@
 import { orderBy as firestoreOrderBy, where as firestoreWhere, limit as firestoreLimit, increment as firestoreIncrement, arrayUnion as firestoreArrayUnion, arrayRemove as firestoreArrayRemove, deleteField as firestoreDeleteField, collection as firestoreCollection, doc as firestoreDocument, query as firestoreQuery, onSnapshot, addDoc, setDoc, updateDoc, deleteDoc, getDoc, getDocs, } from "firebase/firestore";
+import { dispatchError, dispatchNext } from "../../observe/Observer.js";
 import { UnsupportedError } from "../../error/UnsupportedError.js";
 import { Provider } from "../../provider/Provider.js";
 import { ArrayUpdate } from "../../update/ArrayUpdate.js";
 import { DataUpdate } from "../../update/DataUpdate.js";
 import { Increment } from "../../update/Increment.js";
 import { ObjectUpdate } from "../../update/ObjectUpdate.js";
-import { dispatchError, dispatchNext } from "../../observe/Observer.js";
+import { Delete } from "../../update/Delete.js";
+import { Update } from "../../update/Update.js";
 // Constants.
 // const ID = "__name__"; // DH: `__name__` is the entire path of the document. `__id__` is just ID.
 const ID = "__id__"; // Internal way Firestore Queries can reference the ID of the current document.
@@ -60,7 +62,9 @@ function getOptionalEntity(snapshot) {
 /** Convert `Update` instances into corresponding Firestore `FieldValue` instances. */
 function* yieldFieldValues(updates, prefix = "") {
     for (const [key, update] of updates) {
-        if (update === undefined)
+        if (!(update instanceof Update))
+            yield [`${prefix}${key}`, update];
+        else if (update instanceof Delete)
             yield [`${prefix}${key}`, firestoreDeleteField()];
         else if (update instanceof Increment)
             yield [`${prefix}${key}`, firestoreIncrement(update.amount)];
@@ -75,7 +79,7 @@ function* yieldFieldValues(updates, prefix = "") {
                 yield [`${prefix}${key}`, firestoreArrayRemove(...update.deletes)];
         }
         else
-            yield [`${prefix}${key}`, update];
+            yield [`${prefix}${key}`, update.transform()];
     }
 }
 /**

package/firestore/lite/FirestoreLiteProvider.js

@@ -5,6 +5,8 @@ import { ArrayUpdate } from "../../update/ArrayUpdate.js";
 import { DataUpdate } from "../../update/DataUpdate.js";
 import { Increment } from "../../update/Increment.js";
 import { ObjectUpdate } from "../../update/ObjectUpdate.js";
+import { Update } from "../../update/Update.js";
+import { Delete } from "../../update/Delete.js";
 // Constants.
 // const ID = "__name__"; // DH: `__name__` is the entire path of the document. `__id__` is just ID.
 const ID = "__id__"; // Internal way Firestore Queries can reference the ID of the current document.
@@ -59,7 +61,9 @@ function getOptionalData(snapshot) {
 /** Convert `Update` instances into corresponding Firestore `FieldValue` instances. */
 function* yieldFieldValues(updates, prefix = "") {
     for (const [key, update] of updates) {
-        if (update === undefined)
+        if (!(update instanceof Update))
+            yield [`${prefix}${key}`, update];
+        else if (update instanceof Delete)
             yield [`${prefix}${key}`, firestoreDeleteField()];
         else if (update instanceof Increment)
             yield [`${prefix}${key}`, firestoreIncrement(update.amount)];
@@ -74,7 +78,7 @@ function* yieldFieldValues(updates, prefix = "") {
                 yield [`${prefix}${key}`, firestoreArrayRemove(...update.deletes)];
         }
         else
-            yield [`${prefix}${key}`, update];
+            yield [`${prefix}${key}`, update.transform()];
     }
 }
 /**

package/firestore/server/FirestoreServerProvider.d.ts

@@ -2,9 +2,9 @@ import { Firestore } from "@google-cloud/firestore";
 import type { DocumentReference, QueryReference } from "../../db/Reference.js";
 import type { Data, Entities, OptionalEntity } from "../../util/data.js";
 import type { Unsubscribe } from "../../observe/Observable.js";
+import { Observer } from "../../observe/Observer.js";
 import { AsynchronousProvider, Provider } from "../../provider/Provider.js";
 import { DataUpdate } from "../../update/DataUpdate.js";
-import { Observer } from "../../observe/Observer.js";
 /**
  * Firestore server database provider.
  * - Works with the Firebase Admin SDK for Node.JS

package/firestore/server/FirestoreServerProvider.js

@@ -1,11 +1,13 @@
 import { Firestore, FieldValue } from "@google-cloud/firestore";
+import { dispatchError, dispatchNext } from "../../observe/Observer.js";
 import { UnsupportedError } from "../../error/UnsupportedError.js";
 import { Provider } from "../../provider/Provider.js";
 import { ArrayUpdate } from "../../update/ArrayUpdate.js";
 import { DataUpdate } from "../../update/DataUpdate.js";
 import { Increment } from "../../update/Increment.js";
 import { ObjectUpdate } from "../../update/ObjectUpdate.js";
-import { dispatchError, dispatchNext } from "../../observe/Observer.js";
+import { Delete } from "../../update/Delete.js";
+import { Update } from "../../update/Update.js";
 // Constants.
 // const ID = "__name__"; // DH: `__name__` is the entire path of the document. `__id__` is just ID.
 const ID = "__id__"; // Internal way Firestore Queries can reference the ID of the current document.
@@ -60,7 +62,9 @@ function getOptionalEntity(snapshot) {
 /** Convert `Update` instances into corresponding Firestore `FieldValue` instances. */
 function* yieldFieldValues(updates, prefix = "") {
     for (const [key, update] of updates) {
-        if (update === undefined)
+        if (!(update instanceof Update))
+            yield [`${prefix}${key}`, update];
+        else if (update instanceof Delete)
             yield [`${prefix}${key}`, FieldValue.delete()];
         else if (update instanceof Increment)
             yield [`${prefix}${key}`, FieldValue.increment(update.amount)];
@@ -75,7 +79,7 @@ function* yieldFieldValues(updates, prefix = "") {
                 yield [`${prefix}${key}`, FieldValue.arrayRemove(...update.deletes)];
         }
         else
-            yield [`${prefix}${key}`, update];
+            yield [`${prefix}${key}`, update.transform()];
     }
 }
 /**

package/package.json

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

package/provider/ThroughProvider.d.ts

@@ -31,5 +31,7 @@ export interface SynchronousThroughProvider extends SynchronousProvider {
 export interface AsynchronousThroughProvider extends AsynchronousProvider {
     new (source: AsynchronousProvider): AsynchronousProvider;
 }
-/** Find a specific source provider in a database's provider stack. */
-export declare function findSourceProvider<P extends Provider>(provider: Provider, type: Class<P>): P | undefined;
+/** Find a possible source provider in a database's provider stack (if it exists). */
+export declare function getOptionalSourceProvider<P extends Provider>(provider: Provider, type: Class<P>): P | undefined;
+/** Find a source provider in a database's provider stack. */
+export declare function getSourceProvider<P extends Provider>(provider: Provider, type: Class<P>): P;

package/provider/ThroughProvider.js

@@ -1,3 +1,4 @@
+import { AssertionError } from "../error/AssertionError.js";
 import { Provider } from "./Provider.js";
 /**
  * Pass all reads and writes through to a source provider.
@@ -41,10 +42,17 @@ export class ThroughProvider extends Provider {
         return this.source.deleteQuery(ref);
     }
 }
-/** Find a specific source provider in a database's provider stack. */
-export function findSourceProvider(provider, type) {
+/** Find a possible source provider in a database's provider stack (if it exists). */
+export function getOptionalSourceProvider(provider, type) {
     if (provider instanceof type)
         return provider;
     if (provider instanceof ThroughProvider)
-        return findSourceProvider(provider.source, type);
+        return getSourceProvider(provider.source, type);
+}
+/** Find a source provider in a database's provider stack. */
+export function getSourceProvider(provider, type) {
+    const source = getOptionalSourceProvider(provider, type);
+    if (!source)
+        throw new AssertionError(`Source provider ${type.name} not found`, provider);
+    return source;
 }

package/provider/ValidationProvider.js

@@ -1,6 +1,5 @@
 import { callAsync } from "../util/async.js";
 import { validate } from "../util/validate.js";
-import { validateUpdate } from "../update/util.js";
 import { Feedback } from "../feedback/Feedback.js";
 import { ValidationError } from "../error/ValidationError.js";
 import { InvalidFeedback } from "../feedback/InvalidFeedback.js";
@@ -21,7 +20,7 @@ export class ValidationProvider extends ThroughProvider {
         return super.setDocument(ref, validate(value, ref.validator));
     }
     updateDocument(ref, update) {
-        return super.updateDocument(ref, validateUpdate(update, ref.validator));
+        return super.updateDocument(ref, update.validate(ref.validator));
     }
     getQuery(ref) {
         return callAsync(_validateEntities, super.getQuery(ref), ref);
@@ -33,7 +32,7 @@ export class ValidationProvider extends ThroughProvider {
         return super.setQuery(ref, validate(value, ref.validator));
     }
     updateQuery(ref, update) {
-        return super.updateQuery(ref, validateUpdate(update, ref.validator));
+        return super.updateQuery(ref, update.validate(ref.validator));
     }
 }
 /** Validate an entity for a document reference. */

package/react/useDocument.js

@@ -1,7 +1,7 @@
 import { reduceMapItem } from "../util/map.js";
 import { getDocumentData } from "../db/Reference.js";
 import { CacheProvider } from "../provider/CacheProvider.js";
-import { findSourceProvider } from "../provider/ThroughProvider.js";
+import { getOptionalSourceProvider } from "../provider/ThroughProvider.js";
 import { State } from "../state/State.js";
 import { BooleanState } from "../state/BooleanState.js";
 import { ConditionError } from "../error/ConditionError.js";
@@ -12,7 +12,7 @@ import { useCache } from "./useCache.js";
 export class DocumentState extends State {
     constructor(ref) {
         var _a;
-        const table = (_a = findSourceProvider(ref.db.provider, CacheProvider)) === null || _a === void 0 ? void 0 : _a.memory.getTable(ref);
+        const table = (_a = getOptionalSourceProvider(ref.db.provider, CacheProvider)) === null || _a === void 0 ? void 0 : _a.memory.getTable(ref);
         const time = table ? table.getDocumentTime(ref.id) : null;
         const isCached = typeof time === "number";
         super(table && isCached ? table.getDocument(ref.id) : NOVALUE);
@@ -63,7 +63,7 @@ export class DocumentState extends State {
     /** Subscribe this state to any `CacheProvider` that exists in the provider chain. */
     connectCache() {
         var _a;
-        const table = (_a = findSourceProvider(this.ref.db.provider, CacheProvider)) === null || _a === void 0 ? void 0 : _a.memory.getTable(this.ref);
+        const table = (_a = getOptionalSourceProvider(this.ref.db.provider, CacheProvider)) === null || _a === void 0 ? void 0 : _a.memory.getTable(this.ref);
         table && this.connect(() => table.subscribeCachedDocument(this.ref.id, this));
     }
     // Override to subscribe to the cache when an observer is added.

package/react/useQuery.js

@@ -1,7 +1,7 @@
 import { reduceMapItem } from "../util/map.js";
 import { getQueryFirstData, getQueryFirstValue } from "../db/Reference.js";
 import { CacheProvider } from "../provider/CacheProvider.js";
-import { findSourceProvider } from "../provider/ThroughProvider.js";
+import { getOptionalSourceProvider } from "../provider/ThroughProvider.js";
 import { State } from "../state/State.js";
 import { ConditionError } from "../error/ConditionError.js";
 import { BooleanState } from "../state/BooleanState.js";
@@ -12,7 +12,7 @@ import { useCache } from "./useCache.js";
 export class QueryState extends State {
     constructor(ref) {
         var _a, _b;
-        const table = (_a = findSourceProvider(ref.db.provider, CacheProvider)) === null || _a === void 0 ? void 0 : _a.memory.getTable(ref);
+        const table = (_a = getOptionalSourceProvider(ref.db.provider, CacheProvider)) === null || _a === void 0 ? void 0 : _a.memory.getTable(ref);
         const time = table ? table.getQueryTime(ref) : null;
         const isCached = typeof time === "number";
         super(table && isCached ? table.getQuery(ref) : NOVALUE);
@@ -96,7 +96,7 @@ export class QueryState extends State {
     /** Subscribe this state to any `CacheProvider` that exists in the provider chain. */
     connectCache() {
         var _a;
-        const table = (_a = findSourceProvider(this.ref.db.provider, CacheProvider)) === null || _a === void 0 ? void 0 : _a.memory.getTable(this.ref);
+        const table = (_a = getOptionalSourceProvider(this.ref.db.provider, CacheProvider)) === null || _a === void 0 ? void 0 : _a.memory.getTable(this.ref);
         return table && this.connect(() => table.subscribeCachedQuery(this.ref, this));
     }
     // Override to subscribe to the cache when an observer is added.

package/schema/AllowSchema.js

@@ -1,7 +1,7 @@
 import { InvalidFeedback } from "../feedback/InvalidFeedback.js";
-import { toString } from "../util/string.js";
+import { getString } from "../util/string.js";
 import { isItem } from "../util/array.js";
-import { toNumber } from "../util/number.js";
+import { getOptionalNumber } from "../util/number.js";
 import { isKey } from "../util/object.js";
 import { Schema } from "./Schema.js";
 /** Validate a value against a specific set of allowed values. */
@@ -27,13 +27,13 @@ export class AllowSchema extends Schema {
 /** Define a valid string from an allowed set of strings. */
 export class AllowStringSchema extends AllowSchema {
     validate(unsafeValue = this.value) {
-        return validateAllowed(toString(unsafeValue), this.allow);
+        return validateAllowed(getString(unsafeValue), this.allow);
     }
 }
 /** Define a valid number from an allowed set of numbers. */
 export class AllowNumberSchema extends AllowSchema {
     validate(unsafeValue = this.value) {
-        return validateAllowed(toNumber(unsafeValue), this.allow);
+        return validateAllowed(getOptionalNumber(unsafeValue), this.allow);
     }
 }
 /** Valid string from an allowed set of strings. */

package/schema/ArraySchema.js

@@ -1,6 +1,6 @@
 import { InvalidFeedback } from "../feedback/InvalidFeedback.js";
-import { getArray, uniqueArray } from "../util/array.js";
-import { validateItems } from "../util/validate.js";
+import { uniqueArray } from "../util/array.js";
+import { validateArray } from "../util/validate.js";
 import { Schema } from "./Schema.js";
 /**
  * Define a valid array.
@@ -41,7 +41,7 @@ export class ArraySchema extends Schema {
     validate(unsafeValue = this.value) {
         if (!(unsafeValue instanceof Array))
             throw new InvalidFeedback("Must be array", { value: unsafeValue });
-        const safeArray = getArray(validateItems(unsafeValue, this.items));
+        const safeArray = validateArray(unsafeValue, this.items);
         const dedupedArray = this.unique ? uniqueArray(safeArray) : safeArray;
         if (typeof this.min === "number" && dedupedArray.length < this.min)
             throw new InvalidFeedback(dedupedArray.length ? `Minimum ${this.min} items` : "Required", { value: dedupedArray });

package/schema/DateSchema.js

@@ -1,4 +1,4 @@
-import { toDate, getYmd } from "../util/date.js";
+import { getOptionalDate, getYmd } from "../util/date.js";
 import { InvalidFeedback } from "../feedback/InvalidFeedback.js";
 import { Schema } from "./Schema.js";
 import { OPTIONAL } from "./OptionalSchema.js";
@@ -11,13 +11,13 @@ export class DateSchema extends Schema {
         this.max = max;
     }
     validate(unsafeValue = this.value) {
-        const date = toDate(unsafeValue);
+        const date = getOptionalDate(unsafeValue);
         if (!date)
             throw new InvalidFeedback(unsafeValue ? "Invalid date" : "Required", { value: unsafeValue });
-        const minDate = toDate(this.min);
+        const minDate = getOptionalDate(this.min);
         if (minDate && date.getTime() < minDate.getTime())
             throw new InvalidFeedback(`Minimum ${minDate.toLocaleDateString()}`, { value: date });
-        const maxDate = toDate(this.max);
+        const maxDate = getOptionalDate(this.max);
         if (maxDate && date.getTime() > maxDate.getTime())
             throw new InvalidFeedback(`Maximum ${maxDate.toLocaleDateString()}`, { value: date });
         return getYmd(date);

package/schema/NumberSchema.js

@@ -1,4 +1,4 @@
-import { toNumber, roundStep } from "../util/number.js";
+import { getOptionalNumber, roundStep } from "../util/number.js";
 import { InvalidFeedback } from "../feedback/InvalidFeedback.js";
 import { Schema } from "./Schema.js";
 import { OPTIONAL } from "./OptionalSchema.js";
@@ -12,7 +12,7 @@ export class NumberSchema extends Schema {
         this.step = step;
     }
     validate(unsafeValue = this.value) {
-        const unsafeNumber = toNumber(unsafeValue);
+        const unsafeNumber = getOptionalNumber(unsafeValue);
         if (typeof unsafeNumber !== "number")
             throw new InvalidFeedback("Must be number", { value: unsafeValue });
         const safeNumber = typeof this.step === "number" ? roundStep(unsafeNumber, this.step) : unsafeNumber;

package/schema/SlugSchema.js

@@ -1,4 +1,4 @@
-import { toSlug } from "../util/string.js";
+import { getSlug } from "../util/string.js";
 import { OPTIONAL } from "./OptionalSchema.js";
 import { StringSchema } from "./StringSchema.js";
 /**
@@ -16,7 +16,7 @@ export class SlugSchema extends StringSchema {
         this.max = 32;
     }
     sanitize(unsafeString) {
-        return toSlug(unsafeString);
+        return getSlug(unsafeString);
     }
 }
 /** Valid slug, e.g. `this-is-a-slug` */

package/schema/ThroughSchema.d.ts

@@ -7,5 +7,7 @@ export declare abstract class ThroughSchema<T> extends Schema<T> {
     });
     validate(unsafeValue: unknown): T;
 }
-/** Find a specific source schema in a schema. */
-export declare function findSourceSchema<X extends Schema>(schema: Schema, type: Class<X>): X;
+/** Find a possible source schema in a schema (if it exists). */
+export declare function getOptionalSourceSchema<X extends Schema>(schema: Schema, type: Class<X>): X | undefined;
+/** Find a source schema in a schema. */
+export declare function getSourceSchema<X extends Schema>(schema: Schema, type: Class<X>): X;

package/schema/ThroughSchema.js

@@ -9,11 +9,17 @@ export class ThroughSchema extends Schema {
         return this.source.validate(unsafeValue);
     }
 }
-/** Find a specific source schema in a schema. */
-export function findSourceSchema(schema, type) {
+/** Find a possible source schema in a schema (if it exists). */
+export function getOptionalSourceSchema(schema, type) {
     if (schema instanceof type)
         return schema;
     if (schema instanceof ThroughSchema)
-        return findSourceSchema(schema.source, type);
-    throw new AssertionError(`Source schema "${type.name}" not found`, schema);
+        return getSourceSchema(schema.source, type);
+}
+/** Find a source schema in a schema. */
+export function getSourceSchema(schema, type) {
+    const source = getOptionalSourceSchema(schema, type);
+    if (!source)
+        throw new AssertionError(`Source schema "${type.name}" not found`, schema);
+    return source;
 }

package/update/ArrayUpdate.d.ts

@@ -1,4 +1,5 @@
 import { ImmutableArray } from "../util/array.js";
+import { Validator } from "../util/validate.js";
 import { Update } from "./Update.js";
 /** Update that can be applied to an array to add/remove items. */
 export declare class ArrayUpdate<T> extends Update<ImmutableArray<T>> {
@@ -9,8 +10,8 @@ export declare class ArrayUpdate<T> extends Update<ImmutableArray<T>> {
     readonly adds: ImmutableArray<T>;
     readonly deletes: ImmutableArray<T>;
     constructor(adds?: ImmutableArray<T>, deletes?: ImmutableArray<T>);
-    /** Transform an array using this array update. */
     transform(arr?: ImmutableArray<T>): ImmutableArray<T>;
+    validate(validator: Validator<ImmutableArray<T>>): this;
     /** Return an array update with an additional item marked for addition. */
     with(...adds: T[]): this;
     /** Return an array update with an additional item marked for deletion. */

package/update/ArrayUpdate.js

@@ -1,4 +1,6 @@
+import { ArraySchema } from "../schema/ArraySchema.js";
 import { withItems, withoutItems } from "../util/array.js";
+import { validateArray } from "../util/validate.js";
 import { Update } from "./Update.js";
 /** Update that can be applied to an array to add/remove items. */
 export class ArrayUpdate extends Update {
@@ -15,16 +17,33 @@ export class ArrayUpdate extends Update {
     static without(...deletes) {
         return new ArrayUpdate([], deletes);
     }
-    /** Transform an array using this array update. */
     transform(arr = []) {
         return withoutItems(withItems(arr, this.adds), this.deletes);
     }
+    validate(validator) {
+        if (!(validator instanceof ArraySchema))
+            return super.validate(validator);
+        return {
+            __proto__: Object.getPrototypeOf(this),
+            ...this,
+            adds: validateArray(this.adds, validator.items),
+            deletes: validateArray(this.deletes, validator.items),
+        };
+    }
     /** Return an array update with an additional item marked for addition. */
     with(...adds) {
-        return { __proto__: Object.getPrototypeOf(this), ...this, adds: [...this.adds, ...adds] };
+        return {
+            __proto__: Object.getPrototypeOf(this),
+            ...this,
+            adds: [...this.adds, ...adds],
+        };
     }
     /** Return an array update with an additional item marked for deletion. */
     without(...deletes) {
-        return { __proto__: Object.getPrototypeOf(this), ...this, deletes: [...this.deletes, ...deletes] };
+        return {
+            __proto__: Object.getPrototypeOf(this),
+            ...this,
+            deletes: [...this.deletes, ...deletes],
+        };
     }
 }

package/update/DataUpdate.d.ts

@@ -1,6 +1,7 @@
-import type { Data, Key, Prop } from "../util/data.js";
+import { Data, Key, Prop } from "../util/data.js";
 import { Nullish } from "../util/null.js";
 import { Transformable } from "../util/transform.js";
+import { Validator } from "../util/validate.js";
 import { Update } from "./Update.js";
 /**
  * Set of named transforms for the props of a data object.
@@ -18,8 +19,8 @@ export declare class DataUpdate<T extends Data> extends Update<T> implements Ite
     static with<X extends Data, K extends Key<X>>(key: Nullish<K>, value: X[K] | Update<X[K]>): DataUpdate<X>;
     readonly updates: PropUpdates<T>;
     constructor(props: PropUpdates<T>);
-    /** Transform a a data object using this update. */
     transform(data: T): T;
+    validate(validator: Validator<T>): this;
     /** Return a data update with a specific prop marked for update. */
     with<K extends Key<T>>(key: Nullish<K>, value: T[K] | Update<T[K]>): this;
     /** Iterate over the transforms in this object. */

package/update/DataUpdate.js

@@ -1,5 +1,10 @@
+import { Feedback } from "../feedback/Feedback.js";
+import { InvalidFeedback } from "../feedback/InvalidFeedback.js";
+import { DataSchema } from "../schema/DataSchema.js";
+import { getProps } from "../util/data.js";
 import { isNullish } from "../util/null.js";
 import { transformData } from "../util/transform.js";
+import { validate } from "../util/validate.js";
 import { Update } from "./Update.js";
 /** Update that can be applied to a data object to update its props. */
 export class DataUpdate extends Update {
@@ -11,18 +16,53 @@ export class DataUpdate extends Update {
     static with(key, value) {
         return new DataUpdate(!isNullish(key) ? { [key]: value } : {});
     }
-    /** Transform a a data object using this update. */
     transform(data) {
         return transformData(data, this.updates);
     }
+    validate(validator) {
+        if (!(validator instanceof DataSchema))
+            return super.validate(validator);
+        return {
+            __proto__: Object.getPrototypeOf(this),
+            ...this,
+            updates: Object.fromEntries(_validateUpdates(this.updates, validator.props)),
+        };
+    }
     /** Return a data update with a specific prop marked for update. */
     with(key, value) {
         if (isNullish(key))
             return this;
-        return { __proto__: Object.getPrototypeOf(this), ...this, updates: { ...this.updates, [key]: value } };
+        return {
+            __proto__: Object.getPrototypeOf(this),
+            ...this,
+            updates: { ...this.updates, [key]: value },
+        };
     }
     /** Iterate over the transforms in this object. */
     [Symbol.iterator]() {
         return Object.entries(this.updates).values();
     }
 }
+/** Validate a set of transforms against a set of validators. */
+function* _validateUpdates(unsafeUpdates, validators) {
+    let invalid = false;
+    const details = {};
+    for (const [k, validator] of getProps(validators)) {
+        const unsafeUpdate = unsafeUpdates[k];
+        if (unsafeUpdate !== undefined) {
+            try {
+                yield [k, unsafeUpdate instanceof Update ? unsafeUpdate.validate(validator) : validate(unsafeUpdate, validator)];
+            }
+            catch (thrown) {
+                if (thrown instanceof Feedback) {
+                    invalid = true;
+                    details[k] = thrown;
+                }
+                else
+                    throw thrown;
+            }
+        }
+    }
+    if (invalid)
+        throw new InvalidFeedback("Invalid updates", details);
+}

package/update/Delete.d.ts

@@ -0,0 +1,11 @@
+import { Update } from "./Update.js";
+/**
+ * Delete update: an object that deletes a value.
+ * - Hint: you can use negative numbers to decrement the number too!
+ */
+export declare class Delete extends Update<undefined> {
+    transform(): undefined;
+    validate(): this;
+}
+/** Update that deletes any value. */
+export declare const DELETE: Delete;

package/update/Delete.js

@@ -0,0 +1,15 @@
+import { Update } from "./Update.js";
+/**
+ * Delete update: an object that deletes a value.
+ * - Hint: you can use negative numbers to decrement the number too!
+ */
+export class Delete extends Update {
+    transform() {
+        return undefined;
+    }
+    validate() {
+        return this;
+    }
+}
+/** Update that deletes any value. */
+export const DELETE = new Delete();

package/update/Increment.d.ts

@@ -1,6 +1,6 @@
 import { Update } from "./Update.js";
 /**
- * Increment transform: an object that increments/decrements a value.
+ * Increment update: an object that increments/decrements a value.
  * - Hint: you can use negative numbers to decrement the number too!
  */
 export declare class Increment extends Update<number> {
@@ -8,11 +8,11 @@ export declare class Increment extends Update<number> {
     constructor(amount: number);
     transform(existing?: unknown): number;
 }
-/** Transform that increments a value by one. */
+/** Update that increments a value by one. */
 export declare const INCREMENT: Increment;
-/** Transform that increments a value by a specific amount. */
+/** Update that increments a value by a specific amount. */
 export declare const INCREMENT_BY: (amount: number) => Increment;
-/** Transform that decrements a value by one. */
+/** Update that decrements a value by one. */
 export declare const DECREMENT: Increment;
-/** Transform that decrements a value by a specific amount. */
+/** Update that decrements a value by a specific amount. */
 export declare const DECREMENT_BY: (amount: number) => Increment;

package/update/Increment.js

@@ -1,6 +1,6 @@
 import { Update } from "./Update.js";
 /**
- * Increment transform: an object that increments/decrements a value.
+ * Increment update: an object that increments/decrements a value.
  * - Hint: you can use negative numbers to decrement the number too!
  */
 export class Increment extends Update {
@@ -12,11 +12,11 @@ export class Increment extends Update {
         return typeof existing === "number" ? existing + this.amount : this.amount;
     }
 }
-/** Transform that increments a value by one. */
+/** Update that increments a value by one. */
 export const INCREMENT = new Increment(1);
-/** Transform that increments a value by a specific amount. */
+/** Update that increments a value by a specific amount. */
 export const INCREMENT_BY = (amount) => new Increment(amount);
-/** Transform that decrements a value by one. */
+/** Update that decrements a value by one. */
 export const DECREMENT = new Increment(-1);
-/** Transform that decrements a value by a specific amount. */
+/** Update that decrements a value by a specific amount. */
 export const DECREMENT_BY = (amount) => new Increment(0 - amount);