shelving 1.91.2 → 1.92.0

package/db/Query.js

@@ -1,94 +0,0 @@
-import { Statement } from "../constraint/Statement.js";
-import { countArray, getFirstItem, getLastItem, getOptionalFirstItem, getOptionalLastItem, isArrayLength } from "../util/array.js";
-import { runSequence } from "../util/sequence.js";
-/** Reference to a set of items in a sync or async provider. */
-class BaseQuery extends Statement {
-    // Override to include the collection name.
-    toString() {
-        return `${this.collection}?{${super.toString()}`;
-    }
-    /** Subscribe to this item. */
-    subscribe(onNext, onError) {
-        return runSequence(this, onNext, onError);
-    }
-    // Implement AsyncIterable
-    [Symbol.asyncIterator]() {
-        return this.provider.getQuerySequence(this.collection, this)[Symbol.asyncIterator]();
-    }
-}
-/** Reference to a set of items in a provider. */
-export class Query extends BaseQuery {
-    constructor(provider, collection, filters, sorts, limit) {
-        super(filters, sorts, limit);
-        this.provider = provider;
-        this.collection = collection;
-    }
-    get value() {
-        return this.provider.getQuery(this.collection, this);
-    }
-    get count() {
-        return this.value.length;
-    }
-    get exists() {
-        return !!this.max(1).value.length;
-    }
-    get firstValue() {
-        return getOptionalFirstItem(this.max(1).value);
-    }
-    get firstData() {
-        return getFirstItem(this.max(1).value);
-    }
-    get lastValue() {
-        return getOptionalLastItem(this.value);
-    }
-    get lastData() {
-        return getLastItem(this.value);
-    }
-    set(data) {
-        return this.provider.setQuery(this.collection, this, data);
-    }
-    update(updates) {
-        return this.provider.updateQuery(this.collection, this, updates);
-    }
-    delete() {
-        return this.provider.deleteQuery(this.collection, this);
-    }
-}
-/** Reference to a set of items in a provider. */
-export class AsyncQuery extends BaseQuery {
-    constructor(provider, collection, filters, sorts, limit) {
-        super(filters, sorts, limit);
-        this.provider = provider;
-        this.collection = collection;
-    }
-    get value() {
-        return this.provider.getQuery(this.collection, this);
-    }
-    get count() {
-        return this.value.then(countArray);
-    }
-    get exists() {
-        return this.max(1).value.then(isArrayLength);
-    }
-    get firstValue() {
-        return this.max(1).value.then(getOptionalFirstItem);
-    }
-    get firstData() {
-        return this.max(1).value.then(getFirstItem);
-    }
-    get lastValue() {
-        return this.value.then(getOptionalLastItem);
-    }
-    get lastData() {
-        return this.value.then(getLastItem);
-    }
-    set(data) {
-        return this.provider.setQuery(this.collection, this, data);
-    }
-    update(updates) {
-        return this.provider.updateQuery(this.collection, this, updates);
-    }
-    delete() {
-        return this.provider.deleteQuery(this.collection, this);
-    }
-}

package/update/ArrayUpdate.d.ts

@@ -1,17 +0,0 @@
-import type { ImmutableArray } from "../util/array.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>> {
-    /** Return an array update with an item marked for addition. */
-    static add<X>(...adds: X[]): ArrayUpdate<X>;
-    /** Return an array update with an item marked for deletion. */
-    static delete<X>(...deletes: X[]): ArrayUpdate<X>;
-    readonly adds: ImmutableArray<T>;
-    readonly deletes: ImmutableArray<T>;
-    constructor(adds?: ImmutableArray<T>, deletes?: ImmutableArray<T>);
-    /** Return an array update with an additional item marked for addition. */
-    add(...adds: T[]): this;
-    /** Return an array update with an additional item marked for deletion. */
-    delete(...deletes: T[]): this;
-    transform(arr?: ImmutableArray<T>): ImmutableArray<T>;
-}

package/update/ArrayUpdate.js

@@ -1,31 +0,0 @@
-import { omitArrayItems, withArrayItems } from "../util/array.js";
-import { cloneObjectWith } from "../util/object.js";
-import { Update } from "./Update.js";
-/** Update that can be applied to an array to add/remove items. */
-export class ArrayUpdate extends Update {
-    /** Return an array update with an item marked for addition. */
-    static add(...adds) {
-        return new ArrayUpdate(adds);
-    }
-    /** Return an array update with an item marked for deletion. */
-    static delete(...deletes) {
-        return new ArrayUpdate([], deletes);
-    }
-    constructor(adds = [], deletes = []) {
-        super();
-        this.adds = adds;
-        this.deletes = deletes;
-    }
-    /** Return an array update with an additional item marked for addition. */
-    add(...adds) {
-        return cloneObjectWith(this, "deletes", withArrayItems(this.adds, ...adds));
-    }
-    /** Return an array update with an additional item marked for deletion. */
-    delete(...deletes) {
-        return cloneObjectWith(this, "deletes", withArrayItems(this.deletes, ...deletes));
-    }
-    // Implement `Transformable`
-    transform(arr = []) {
-        return omitArrayItems(withArrayItems(arr, ...this.adds), ...this.deletes);
-    }
-}

package/update/DataUpdate.d.ts

@@ -1,37 +0,0 @@
-import type { Data, DataKey, DataProp } from "../util/data.js";
-import type { Nullish } from "../util/null.js";
-import type { Transformable } from "../util/transform.js";
-import { Update } from "./Update.js";
-/**
- * Set of named updates for the props of a data object.
- * - Similar to `Transformers` but only allows `Update` instances.
- * - If a prop contains a new value, the prop is set to that new value.
- * - If a prop contains an `Update` instance, the existing value is updated.
- */
-export type Updates<T extends Data = Data> = {
-    readonly [K in keyof T]?: T[K] | Update<T[K]> | undefined;
-};
-/**
- * Update that can be applied to a data object to update its props.
- */
-export declare class DataUpdate<T extends Data = Data> extends Update<T> implements Iterable<DataProp<Updates<T>>>, Transformable<T, T> {
-    /** Return a data update with multiple props updated. */
-    static update<X extends Data>(updates: Updates<X>): DataUpdate<X>;
-    /** Return a data update with a specific prop set. */
-    static setProp<X extends Data, K extends DataKey<X>>(key: Nullish<K>, value: X[K]): DataUpdate<X>;
-    /** Return a data update with a specific prop updated. */
-    static updateProp<X extends Data, K extends DataKey<X>>(key: Nullish<K>, value: X[K] | Update<X[K]>): DataUpdate<X>;
-    readonly updates: Updates<T>;
-    constructor(props: Updates<T>);
-    /** Return a data update with multiple props updated. */
-    update(updates: Updates<T>): this;
-    /** Return a data update with a specific prop set. */
-    setProp<K extends DataKey<T>>(key: Nullish<K>, value: T[K]): this;
-    /** Return a data update with a specific prop updated. */
-    updateProp<K extends DataKey<T>>(key: Nullish<K>, value: T[K] | Update<T[K]>): this;
-    transform(data: T): T;
-    transform(data?: T | Partial<T>): Partial<T>;
-    [Symbol.iterator](): Iterator<DataProp<{
-        readonly [K in keyof T]: T[K] | Update<T[K]>;
-    }>, void>;
-}

package/update/DataUpdate.js

@@ -1,44 +0,0 @@
-import { isNullish } from "../util/null.js";
-import { cloneObjectWith } from "../util/object.js";
-import { transformObject } from "../util/transform.js";
-import { Update } from "./Update.js";
-/**
- * Update that can be applied to a data object to update its props.
- */
-export class DataUpdate extends Update {
-    /** Return a data update with multiple props updated. */
-    static update(updates) {
-        return new DataUpdate(updates);
-    }
-    /** Return a data update with a specific prop set. */
-    static setProp(key, value) {
-        return DataUpdate.updateProp(key, value);
-    }
-    /** Return a data update with a specific prop updated. */
-    static updateProp(key, value) {
-        return new DataUpdate(!isNullish(key) ? { [key]: value } : {});
-    }
-    constructor(props) {
-        super();
-        this.updates = props;
-    }
-    /** Return a data update with multiple props updated. */
-    update(updates) {
-        return cloneObjectWith(this, "updates", { ...this.updates, ...updates });
-    }
-    /** Return a data update with a specific prop set. */
-    setProp(key, value) {
-        return this.updateProp(key, value);
-    }
-    /** Return a data update with a specific prop updated. */
-    updateProp(key, value) {
-        return isNullish(key) ? this : cloneObjectWith(this, "updates", { ...this.updates, [key]: value });
-    }
-    transform(data = {}) {
-        return transformObject(data, this.updates);
-    }
-    // Implement `Iterable`
-    [Symbol.iterator]() {
-        return Object.entries(this.updates).values();
-    }
-}

package/update/Delete.d.ts

@@ -1,10 +0,0 @@
-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;
-}
-/** Update that deletes any value. */
-export declare const DELETE: Delete;

package/update/Delete.js

@@ -1,12 +0,0 @@
-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;
-    }
-}
-/** Update that deletes any value. */
-export const DELETE = new Delete();

package/update/DictionaryUpdate.d.ts

@@ -1,31 +0,0 @@
-import type { Delete } from "./Delete.js";
-import type { DictionaryItem, ImmutableDictionary } from "../util/dictionary.js";
-import type { Nullish } from "../util/null.js";
-import { Update } from "./Update.js";
-/** Update that can be applied to a dictionary object to add/remove/update its entries. */
-export declare class DictionaryUpdate<T> extends Update<ImmutableDictionary<T>> implements Iterable<DictionaryItem<T | Update<T> | Delete>> {
-    /** Return a dictionary update with multiple items set. */
-    static set<X>(items: ImmutableDictionary<X>): DictionaryUpdate<X>;
-    /** Return a dictionary update with multiple items updated. */
-    static update<X>(updates: ImmutableDictionary<X | Update<X> | Delete>): DictionaryUpdate<X>;
-    /** Return a dictionary update with a specific item set. */
-    static setItem<X>(key: Nullish<string>, value: X): DictionaryUpdate<X>;
-    /** Return a dictionary update with a specific item updated. */
-    static updateItem<X>(key: Nullish<string>, value: X | Update<X> | Delete): DictionaryUpdate<X>;
-    /** Return a dictionary update with a specific item marked for deletion. */
-    static deleteItem<X>(key: Nullish<string>): DictionaryUpdate<X>;
-    readonly updates: ImmutableDictionary<T | Update<T> | Delete>;
-    constructor(updates?: ImmutableDictionary<T | Update<T> | Delete>);
-    /** Return a dictionary update with multiple items updated. */
-    set(items: ImmutableDictionary<T>): DictionaryUpdate<T>;
-    /** Return a dictionary update with multiple items updated. */
-    update(updates: ImmutableDictionary<T | Update<T> | Delete>): DictionaryUpdate<T>;
-    /** Return a dictionary update with a specific item set. */
-    setItem(key: Nullish<string>, value: T): this;
-    /** Return a dictionary update with a specific item updated. */
-    updateItem(key: Nullish<string>, value: T | Update<T> | Delete): this;
-    /** Return a dictionary update with a specific item deleted. */
-    deleteItem(key: Nullish<string>): this;
-    transform(input?: ImmutableDictionary<T>): ImmutableDictionary<T>;
-    [Symbol.iterator](): Iterator<DictionaryItem<T | Update<T> | Delete>, void>;
-}

package/update/DictionaryUpdate.js

@@ -1,62 +0,0 @@
-import { getDictionaryItems } from "../util/dictionary.js";
-import { isNullish } from "../util/null.js";
-import { cloneObjectWith } from "../util/object.js";
-import { transformObject } from "../util/transform.js";
-import { DELETE } from "./Delete.js";
-import { Update } from "./Update.js";
-/** Update that can be applied to a dictionary object to add/remove/update its entries. */
-export class DictionaryUpdate extends Update {
-    /** Return a dictionary update with multiple items set. */
-    static set(items) {
-        return new DictionaryUpdate(items);
-    }
-    /** Return a dictionary update with multiple items updated. */
-    static update(updates) {
-        return new DictionaryUpdate(updates);
-    }
-    /** Return a dictionary update with a specific item set. */
-    static setItem(key, value) {
-        return DictionaryUpdate.updateItem(key, value);
-    }
-    /** Return a dictionary update with a specific item updated. */
-    static updateItem(key, value) {
-        return new DictionaryUpdate(isNullish(key) ? {} : { [key]: value });
-    }
-    /** Return a dictionary update with a specific item marked for deletion. */
-    static deleteItem(key) {
-        return DictionaryUpdate.updateItem(key, DELETE);
-    }
-    constructor(updates = {}) {
-        super();
-        this.updates = updates;
-    }
-    /** Return a dictionary update with multiple items updated. */
-    set(items) {
-        return cloneObjectWith(this, "updates", { ...this.updates, ...items });
-    }
-    /** Return a dictionary update with multiple items updated. */
-    update(updates) {
-        return cloneObjectWith(this, "updates", { ...this.updates, ...updates });
-    }
-    /** Return a dictionary update with a specific item set. */
-    setItem(key, value) {
-        return this.updateItem(key, value);
-    }
-    /** Return a dictionary update with a specific item updated. */
-    updateItem(key, value) {
-        return isNullish(key) ? this : cloneObjectWith(this, "updates", { ...this.updates, [key]: value });
-    }
-    /** Return a dictionary update with a specific item deleted. */
-    deleteItem(key) {
-        return this.updateItem(key, DELETE);
-    }
-    // Implement `Transformable`
-    transform(input = {}) {
-        return transformObject(input, this.updates);
-    }
-    // Implement `Iterable`
-    *[Symbol.iterator]() {
-        for (const item of getDictionaryItems(this.updates))
-            yield item;
-    }
-}

package/update/Increment.d.ts

@@ -1,18 +0,0 @@
-import { Update } from "./Update.js";
-/**
- * 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> {
-    readonly amount: number;
-    constructor(amount: number);
-    transform(existing?: unknown): number;
-}
-/** Update that increments a value by one. */
-export declare const INCREMENT: Increment;
-/** Update that increments a value by a specific amount. */
-export declare const INCREMENT_BY: (amount: number) => Increment;
-/** Update that decrements a value by one. */
-export declare const DECREMENT: Increment;
-/** Update that decrements a value by a specific amount. */
-export declare const DECREMENT_BY: (amount: number) => Increment;

package/update/Increment.js

@@ -1,22 +0,0 @@
-import { Update } from "./Update.js";
-/**
- * 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 {
-    constructor(amount) {
-        super();
-        this.amount = amount;
-    }
-    transform(existing) {
-        return typeof existing === "number" ? existing + this.amount : this.amount;
-    }
-}
-/** Update that increments a value by one. */
-export const INCREMENT = new Increment(1);
-/** Update that increments a value by a specific amount. */
-export const INCREMENT_BY = (amount) => new Increment(amount);
-/** Update that decrements a value by one. */
-export const DECREMENT = new Increment(-1);
-/** Update that decrements a value by a specific amount. */
-export const DECREMENT_BY = (amount) => new Increment(0 - amount);

package/update/Update.d.ts

@@ -1,8 +0,0 @@
-import type { Transformable } from "../util/transform.js";
-/**
- * An object that represents an update of an existing value.
- * - Implements `Transformable` for applying that update with its `transform()` method.
- */
-export declare abstract class Update<T> implements Transformable<T, T> {
-    abstract transform(value?: unknown): T;
-}

package/update/Update.js

@@ -1,6 +0,0 @@
-/**
- * An object that represents an update of an existing value.
- * - Implements `Transformable` for applying that update with its `transform()` method.
- */
-export class Update {
-}

package/update/hydrations.d.ts

@@ -1,3 +0,0 @@
-import type { Hydrations } from "../util/hydrate.js";
-/** Set of hydrations for all update classes. */
-export declare const UPDATE_HYDRATIONS: Hydrations;

package/update/hydrations.js

@@ -1,13 +0,0 @@
-import { ArrayUpdate } from "./ArrayUpdate.js";
-import { DataUpdate } from "./DataUpdate.js";
-import { Delete } from "./Delete.js";
-import { DictionaryUpdate } from "./DictionaryUpdate.js";
-import { Increment } from "./Increment.js";
-/** Set of hydrations for all update classes. */
-export const UPDATE_HYDRATIONS = {
-    Increment,
-    Delete,
-    ArrayUpdate,
-    DictionaryUpdate,
-    DataUpdate,
-};

package/update/index.d.ts

@@ -1,7 +0,0 @@
-export * from "./Update.js";
-export * from "./Delete.js";
-export * from "./Increment.js";
-export * from "./ArrayUpdate.js";
-export * from "./DataUpdate.js";
-export * from "./DictionaryUpdate.js";
-export * from "./hydrations.js";

package/update/index.js

@@ -1,7 +0,0 @@
-export * from "./Update.js";
-export * from "./Delete.js";
-export * from "./Increment.js";
-export * from "./ArrayUpdate.js";
-export * from "./DataUpdate.js";
-export * from "./DictionaryUpdate.js";
-export * from "./hydrations.js";