@ember-data/store 5.4.0-alpha.30 → 5.4.0-alpha.31

package/unstable-preview-types/-private/managers/notification-manager.d.ts

@@ -0,0 +1,96 @@
+import type { StableDocumentIdentifier, StableRecordIdentifier } from '@warp-drive/core-types/identifier';
+import type Store from '../store-service';
+export type UnsubscribeToken = object;
+export type CacheOperation = 'added' | 'removed' | 'updated' | 'state';
+export type NotificationType = 'attributes' | 'relationships' | 'identity' | 'errors' | 'meta' | 'state';
+export interface NotificationCallback {
+    (identifier: StableRecordIdentifier, notificationType: 'attributes' | 'relationships', key?: string): void;
+    (identifier: StableRecordIdentifier, notificationType: 'errors' | 'meta' | 'identity' | 'state'): void;
+    (identifier: StableRecordIdentifier, notificationType: NotificationType, key?: string): void;
+}
+export interface ResourceOperationCallback {
+    (identifier: StableRecordIdentifier, notificationType: CacheOperation): void;
+}
+export interface DocumentOperationCallback {
+    (identifier: StableDocumentIdentifier, notificationType: CacheOperation): void;
+}
+/**
+ * The NotificationManager provides the ability to subscribe to
+ * changes to Cache state.
+ *
+ * This Feature is what allows EmberData to create subscriptions that
+ * work with any framework or change-notification system.
+ *
+ * @class NotificationManager
+ * @public
+ */
+export default class NotificationManager {
+    store: Store;
+    isDestroyed: boolean;
+    _buffered: Map<StableDocumentIdentifier | StableRecordIdentifier, [string, string | undefined][]>;
+    _cache: Map<StableDocumentIdentifier | StableRecordIdentifier | 'resource' | 'document', Map<UnsubscribeToken, NotificationCallback | ResourceOperationCallback | DocumentOperationCallback>>;
+    _tokens: Map<UnsubscribeToken, StableDocumentIdentifier | StableRecordIdentifier | 'resource' | 'document'>;
+    _hasFlush: boolean;
+    _onFlushCB?: () => void;
+    constructor(store: Store);
+    /**
+     * Subscribe to changes for a given resource identifier, resource addition/removal, or document addition/removal.
+     *
+     * ```ts
+     * export type CacheOperation = 'added' | 'removed' | 'updated' | 'state';
+     *
+     * export interface NotificationCallback {
+     *   (identifier: StableRecordIdentifier, notificationType: 'attributes' | 'relationships', key?: string): void;
+     *   (identifier: StableRecordIdentifier, notificationType: 'errors' | 'meta' | 'identity' | 'state'): void;
+     *   (identifier: StableRecordIdentifier, notificationType: NotificationType, key?: string): void;
+     * }
+     * export interface ResourceOperationCallback {
+     *   // resource updates
+     *   (identifier: StableRecordIdentifier, notificationType: CacheOperation): void;
+     * }
+     * export interface DocumentOperationCallback {
+     *   // document updates
+     *   (identifier: StableDocumentIdentifier, notificationType: CacheOperation): void;
+     * }
+     * ```
+     *
+     * @method subscribe
+     * @public
+     * @param {StableDocumentIdentifier | StableRecordIdentifier | 'resource' | 'document'} identifier
+     * @param {NotificationCallback | ResourceOperationCallback | DocumentOperationCallback} callback
+     * @return {UnsubscribeToken} an opaque token to be used with unsubscribe
+     */
+    subscribe(identifier: StableRecordIdentifier, callback: NotificationCallback): UnsubscribeToken;
+    subscribe(identifier: 'resource', callback: ResourceOperationCallback): UnsubscribeToken;
+    subscribe(identifier: StableDocumentIdentifier, callback: DocumentOperationCallback): UnsubscribeToken;
+    subscribe(identifier: 'document', callback: DocumentOperationCallback): UnsubscribeToken;
+    /**
+     * remove a previous subscription
+     *
+     * @method unsubscribe
+     * @public
+     * @param {UnsubscribeToken} token
+     */
+    unsubscribe(token: UnsubscribeToken): void;
+    /**
+     * Custom Caches and Application Code should not call this method directly.
+     *
+     * @method notify
+     * @param identifier
+     * @param value
+     * @param key
+     * @return {Boolean} whether a notification was delivered to any subscribers
+     * @private
+     */
+    notify(identifier: StableRecordIdentifier, value: 'attributes' | 'relationships', key?: string): boolean;
+    notify(identifier: StableRecordIdentifier, value: 'errors' | 'meta' | 'identity' | 'state'): boolean;
+    notify(identifier: StableRecordIdentifier | StableDocumentIdentifier, value: CacheOperation): boolean;
+    _onNextFlush(cb: () => void): void;
+    _scheduleNotify(): void;
+    _flush(): void;
+    _flushNotification(identifier: StableRecordIdentifier, value: 'attributes' | 'relationships', key?: string): boolean;
+    _flushNotification(identifier: StableRecordIdentifier, value: 'errors' | 'meta' | 'identity' | 'state'): boolean;
+    _flushNotification(identifier: StableRecordIdentifier | StableDocumentIdentifier, value: CacheOperation): boolean;
+    destroy(): void;
+}
+//# sourceMappingURL=notification-manager.d.ts.map

package/unstable-preview-types/-private/managers/notification-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-manager.d.ts","sourceRoot":"","sources":["../../../src/-private/managers/notification-manager.ts"],"names":[],"mappings":"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"}

package/unstable-preview-types/-private/managers/record-array-manager.d.ts

@@ -0,0 +1,95 @@
+import type { StableRecordIdentifier } from '@warp-drive/core-types/identifier';
+import type { ImmutableRequestInfo } from '@warp-drive/core-types/request';
+import type { CollectionResourceDocument } from '@warp-drive/core-types/spec/raw';
+import IdentifierArray, { Collection } from '../record-arrays/identifier-array';
+import type Store from '../store-service';
+import type { UnsubscribeToken } from './notification-manager';
+/**
+ * This is a clever optimization.
+ *
+ * clever optimizations rarely stand the test of time, so if you're
+ * ever curious or think something better is possible please benchmark
+ * and discuss. The benchmark for this at the time of writing is in
+ * `scripts/benchmark-push.js`
+ *
+ * This approach turns out to be 150x faster in Chrome and node than
+ * simply using push or concat. It's highly susceptible to the specifics
+ * of the batch size, and may require tuning.
+ *
+ * Clever optimizations should always come with a `why`. This optimization
+ * exists for two reasons.
+ *
+ * 1) array.push(...objects) and Array.prototype.push.apply(arr, objects)
+ *   are susceptible to stack overflows. The size of objects at which this
+ *   occurs varies by environment, browser, and current stack depth and memory
+ *   pressure; however, it occurs in all browsers in fairly pristine conditions
+ *   somewhere around 125k to 200k elements. Since EmberData regularly encounters
+ *   arrays larger than this in size, we cannot use push.
+ *
+ * 2) `array.concat` or simply setting the array to a new reference is often an
+ *   easier approach; however, native Proxy to an array cannot swap it's target array
+ *   and attempts at juggling multiple array sources have proven to be victim to a number
+ *   of browser implementation bugs. Should these bugs be addressed then we could
+ *   simplify to using `concat`, however, do note this is currently 150x faster
+ *   than concat, and due to the overloaded signature of concat will likely always
+ *   be faster.
+ *
+ * Sincerely,
+ *   - runspired (Chris Thoburn) 08/21/2022
+ *
+ * @function fastPush
+ * @internal
+ * @param target the array to push into
+ * @param source the items to push into target
+ */
+export declare function fastPush<T>(target: T[], source: T[]): void;
+type ChangeSet = Map<StableRecordIdentifier, 'add' | 'del'>;
+/**
+  @class RecordArrayManager
+  @internal
+*/
+declare class RecordArrayManager {
+    store: Store;
+    isDestroying: boolean;
+    isDestroyed: boolean;
+    _set: Map<IdentifierArray, Set<StableRecordIdentifier>>;
+    _live: Map<string, IdentifierArray>;
+    _managed: Set<IdentifierArray>;
+    _pending: Map<IdentifierArray, ChangeSet>;
+    _identifiers: Map<StableRecordIdentifier, Set<Collection>>;
+    _staged: Map<string, ChangeSet>;
+    _subscription: UnsubscribeToken;
+    _keyedArrays: Map<string, Collection>;
+    _visibilitySet: Map<StableRecordIdentifier, boolean>;
+    constructor(options: {
+        store: Store;
+    });
+    _syncArray(array: IdentifierArray): void;
+    /**
+      Get the `RecordArray` for a modelName, which contains all loaded records of
+      given modelName.
+  
+      @method liveArrayFor
+      @internal
+      @param {String} modelName
+      @return {RecordArray}
+    */
+    liveArrayFor(type: string): IdentifierArray;
+    createArray(config: {
+        type?: string;
+        query?: ImmutableRequestInfo | Record<string, unknown>;
+        identifiers?: StableRecordIdentifier[];
+        doc?: CollectionResourceDocument;
+    }): Collection;
+    dirtyArray(array: IdentifierArray, delta: number): void;
+    _getPendingFor(identifier: StableRecordIdentifier, includeManaged: boolean, isRemove?: boolean): Map<IdentifierArray, ChangeSet> | void;
+    populateManagedArray(array: Collection, identifiers: StableRecordIdentifier[], payload: CollectionResourceDocument): void;
+    identifierAdded(identifier: StableRecordIdentifier): void;
+    identifierRemoved(identifier: StableRecordIdentifier): void;
+    identifierChanged(identifier: StableRecordIdentifier): void;
+    clear(isClear?: boolean): void;
+    destroy(): void;
+}
+export declare function disassociateIdentifier(ArraysCache: Map<StableRecordIdentifier, Set<Collection>>, array: Collection, identifier: StableRecordIdentifier): void;
+export default RecordArrayManager;
+//# sourceMappingURL=record-array-manager.d.ts.map

package/unstable-preview-types/-private/managers/record-array-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-array-manager.d.ts","sourceRoot":"","sources":["../../../src/-private/managers/record-array-manager.ts"],"names":[],"mappings":"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"}

package/unstable-preview-types/-private/network/request-cache.d.ts

@@ -0,0 +1,107 @@
+import type { StableRecordIdentifier } from '@warp-drive/core-types/identifier';
+import type { FindRecordOptions } from '../../-types/q/store';
+import type Store from '../store-service';
+declare const Touching: unique symbol;
+export declare const RequestPromise: unique symbol;
+export interface Operation {
+    op: string;
+    options: FindRecordOptions | undefined;
+    recordIdentifier: StableRecordIdentifier;
+}
+export interface FindRecordQuery extends Operation {
+    op: 'findRecord';
+}
+export interface SaveRecordMutation extends Operation {
+    op: 'saveRecord';
+}
+export interface Request {
+    data: Operation[];
+    options?: Record<string, unknown>;
+}
+export type RequestStates = 'pending' | 'fulfilled' | 'rejected';
+export interface RequestState {
+    state: RequestStates;
+    type: 'query' | 'mutation';
+    request: Request;
+    response?: Response;
+}
+export interface Response {
+    data: unknown;
+}
+interface InternalRequest extends RequestState {
+    [Touching]: StableRecordIdentifier[];
+    [RequestPromise]?: Promise<unknown>;
+}
+export type RequestSubscription = (requestState: RequestState) => void;
+/**
+ * The RequestStateService is used to track the state of requests
+ * for fetching or updating known resource identifies that are inflight.
+ *
+ * @class RequestStateService
+ * @public
+ */
+export default class RequestStateService {
+    _pending: Map<StableRecordIdentifier, InternalRequest[]>;
+    _done: Map<StableRecordIdentifier, InternalRequest[]>;
+    _subscriptions: Map<StableRecordIdentifier, RequestSubscription[]>;
+    _toFlush: InternalRequest[];
+    _store: Store;
+    constructor(store: Store);
+    _clearEntries(identifier: StableRecordIdentifier): void;
+    _enqueue<T>(promise: Promise<T>, queryRequest: Request): Promise<T>;
+    _triggerSubscriptions(req: InternalRequest): void;
+    _flush(): void;
+    _flushRequest(req: InternalRequest): void;
+    _dequeue(identifier: StableRecordIdentifier, request: InternalRequest): void;
+    _addDone(request: InternalRequest): void;
+    /**
+     * Subscribe to requests for a given resource identity.
+     *
+     * The callback will receive the current state of the request.
+     *
+     * ```ts
+     * interface RequestState {
+     *   state: 'pending' | 'fulfilled' | 'rejected';
+     *   type: 'query' | 'mutation';
+     *   request: Request;
+     *   response?: { data: unknown };
+     * }
+     * ```
+     *
+     * Note: It should be considered dangerous to use this API for more than simple
+     * state derivation or debugging. The `request` and `response` properties are poorly
+     * spec'd and may change unexpectedly when shifting what Handlers are in use or how
+     * requests are issued from the Store.
+     *
+     * We expect to revisit this API in the near future as we continue to refine the
+     * RequestManager ergonomics, as a simpler but more powerful direct integration
+     * with the RequestManager for these purposes is likely to be a better long-term
+     * design.
+     *
+     * @method subscribeForRecord
+     * @public
+     * @param {StableRecordIdentifier} identifier
+     * @param {(state: RequestState) => void} callback
+     */
+    subscribeForRecord(identifier: StableRecordIdentifier, callback: RequestSubscription): void;
+    /**
+     * Retrieve all active requests for a given resource identity.
+     *
+     * @method getPendingRequestsForRecord
+     * @public
+     * @param {StableRecordIdentifier} identifier
+     * @return {RequestState[]} an array of request states for any pending requests for the given identifier
+     */
+    getPendingRequestsForRecord(identifier: StableRecordIdentifier): RequestState[];
+    /**
+     * Retrieve the last completed request for a given resource identity.
+     *
+     * @method getLastRequestForRecord
+     * @public
+     * @param {StableRecordIdentifier} identifier
+     * @return {RequestState | null} the state of the most recent request for the given identifier
+     */
+    getLastRequestForRecord(identifier: StableRecordIdentifier): RequestState | null;
+}
+export {};
+//# sourceMappingURL=request-cache.d.ts.map

package/unstable-preview-types/-private/network/request-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-cache.d.ts","sourceRoot":"","sources":["../../../src/-private/network/request-cache.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,QAAA,MAAM,QAAQ,EAAE,OAAO,MAA2B,CAAC;AACnD,eAAO,MAAM,cAAc,EAAE,OAAO,MAA0B,CAAC;AAG/D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvC,gBAAgB,EAAE,sBAAsB,CAAC;CAC1C;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,EAAE,EAAE,YAAY,CAAC;CAClB;AAED,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,EAAE,EAAE,YAAY,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IAEvB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,eAAgB,SAAQ,YAAY;IAC5C,CAAC,QAAQ,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACrC,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CACrC;AAGD,MAAM,MAAM,mBAAmB,GAAG,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;AAMvE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACtC,QAAQ,EAAE,GAAG,CAAC,sBAAsB,EAAE,eAAe,EAAE,CAAC,CAAa;IACrE,KAAK,EAAE,GAAG,CAAC,sBAAsB,EAAE,eAAe,EAAE,CAAC,CAAa;IAClE,cAAc,EAAE,GAAG,CAAC,sBAAsB,EAAE,mBAAmB,EAAE,CAAC,CAAa;IAC/E,QAAQ,EAAE,eAAe,EAAE,CAAM;IACjC,MAAM,EAAE,KAAK,CAAC;gBAEF,KAAK,EAAE,KAAK;IAIxB,aAAa,CAAC,UAAU,EAAE,sBAAsB;IAIhD,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAiDnE,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAcjD,MAAM,IAAI,IAAI;IAOd,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IASzC,QAAQ,CAAC,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,eAAe;IAQrE,QAAQ,CAAC,OAAO,EAAE,eAAe;IAwBjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,kBAAkB,CAAC,UAAU,EAAE,sBAAsB,EAAE,QAAQ,EAAE,mBAAmB;IASpF;;;;;;;OAOG;IACH,2BAA2B,CAAC,UAAU,EAAE,sBAAsB,GAAG,YAAY,EAAE;IAI/E;;;;;;;OAOG;IACH,uBAAuB,CAAC,UAAU,EAAE,sBAAsB,GAAG,YAAY,GAAG,IAAI;CAOjF"}

package/unstable-preview-types/-private/record-arrays/identifier-array.d.ts

@@ -0,0 +1,135 @@
+import type { Signal } from '@ember-data/tracking/-private';
+import type { StableRecordIdentifier } from '@warp-drive/core-types/identifier';
+import type { TypedRecordInstance, TypeFromInstance } from '@warp-drive/core-types/record';
+import type { ImmutableRequestInfo } from '@warp-drive/core-types/request';
+import type { Links, PaginationLinks } from '@warp-drive/core-types/spec/raw';
+import type RecordArrayManager from '../managers/record-array-manager';
+import type Store from '../store-service';
+export declare const ARRAY_SIGNAL: unique symbol;
+export declare const SOURCE: unique symbol;
+export declare const MUTATE: unique symbol;
+export declare const NOTIFY: unique symbol;
+declare const IS_COLLECTION: unique symbol;
+export declare function notifyArray(arr: IdentifierArray): void;
+declare global {
+    interface ProxyConstructor {
+        new <TSource extends object, TTarget extends object>(target: TSource, handler: ProxyHandler<TSource>): TTarget;
+    }
+}
+export type IdentifierArrayCreateOptions<T = unknown> = {
+    identifiers: StableRecordIdentifier[];
+    type?: T extends TypedRecordInstance ? TypeFromInstance<T> : string;
+    store: Store;
+    allowMutation: boolean;
+    manager: RecordArrayManager;
+    links?: Links | PaginationLinks | null;
+    meta?: Record<string, unknown> | null;
+};
+/**
+  A record array is an array that contains records of a certain type (or modelName).
+  The record array materializes records as needed when they are retrieved for the first
+  time. You should not create record arrays yourself. Instead, an instance of
+  `RecordArray` or its subclasses will be returned by your application's store
+  in response to queries.
+
+  This class should not be imported and instantiated by consuming applications.
+
+  @class RecordArray
+  @public
+*/
+interface IdentifierArray<T = unknown> extends Omit<Array<T>, '[]'> {
+    [MUTATE]?(target: StableRecordIdentifier[], receiver: typeof Proxy<StableRecordIdentifier[], T[]>, prop: string, args: unknown[], _SIGNAL: Signal): unknown;
+}
+declare class IdentifierArray<T = unknown> {
+    DEPRECATED_CLASS_NAME: string;
+    /**
+      The flag to signal a `RecordArray` is currently loading data.
+      Example
+      ```javascript
+      let people = store.peekAll('person');
+      people.isUpdating; // false
+      people.update();
+      people.isUpdating; // true
+      ```
+      @property isUpdating
+      @public
+      @type Boolean
+    */
+    isUpdating: boolean;
+    isLoaded: boolean;
+    isDestroying: boolean;
+    isDestroyed: boolean;
+    _updatingPromise: Promise<IdentifierArray<T>> | null;
+    [IS_COLLECTION]: boolean;
+    [ARRAY_SIGNAL]: Signal;
+    [SOURCE]: StableRecordIdentifier[];
+    [NOTIFY](): void;
+    links: Links | PaginationLinks | null;
+    meta: Record<string, unknown> | null;
+    modelName?: T extends TypedRecordInstance ? TypeFromInstance<T> : string;
+    /**
+      The store that created this record array.
+  
+      @property store
+      @private
+      @type Store
+      */
+    store: Store;
+    _manager: RecordArrayManager;
+    destroy(clear: boolean): void;
+    get length(): number;
+    set length(value: number);
+    constructor(options: IdentifierArrayCreateOptions<T>);
+    /**
+      Used to get the latest version of all of the records in this array
+      from the adapter.
+  
+      Example
+  
+      ```javascript
+      let people = store.peekAll('person');
+      people.isUpdating; // false
+  
+      people.update().then(function() {
+        people.isUpdating; // false
+      });
+  
+      people.isUpdating; // true
+      ```
+  
+      @method update
+      @public
+    */
+    update(): Promise<IdentifierArray<T>>;
+    _update(): Promise<IdentifierArray<T>>;
+    /**
+      Saves all of the records in the `RecordArray`.
+  
+      Example
+  
+      ```javascript
+      let messages = store.peekAll('message');
+      messages.forEach(function(message) {
+        message.hasBeenSeen = true;
+      });
+      messages.save();
+      ```
+  
+      @method save
+      @public
+      @return {Promise<IdentifierArray>} promise
+    */
+    save(): Promise<IdentifierArray>;
+}
+export default IdentifierArray;
+export type CollectionCreateOptions = IdentifierArrayCreateOptions & {
+    query: ImmutableRequestInfo | Record<string, unknown> | null;
+    isLoaded: boolean;
+};
+export declare class Collection<T = unknown> extends IdentifierArray<T> {
+    query: ImmutableRequestInfo | Record<string, unknown> | null;
+    constructor(options: CollectionCreateOptions);
+    _update(): Promise<Collection<T>>;
+    destroy(clear: boolean): void;
+}
+//# sourceMappingURL=identifier-array.d.ts.map

package/unstable-preview-types/-private/record-arrays/identifier-array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier-array.d.ts","sourceRoot":"","sources":["../../../src/-private/record-arrays/identifier-array.ts"],"names":[],"mappings":"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"}