@ember-data/store 5.5.0-alpha.9 → 5.5.0-beta.0

package/unstable-preview-types/-private/new-core-tmp/reactivity/signal.d.ts

@@ -0,0 +1,32 @@
+declare module '@ember-data/store/-private/new-core-tmp/reactivity/signal' {
+  import type { SignalStore, WarpDriveSignal } from '@ember-data/store/-private/new-core-tmp/reactivity/internal';
+  /**
+   * Creates a signal for the key/object pairing and subscribes to the signal.
+   *
+   * Use when you need to ensure a signal exists and is subscribed to.
+   *
+   * @internal
+   */
+  export function entangleSignal<T extends object>(signals: SignalStore, obj: T, key: string | symbol, initialValue: unknown): WarpDriveSignal;
+  /**
+   * define an enumerable signal property.
+   *
+   * Akin to Object.defineProperty.
+   *
+   * The signal will be lazily created when accessed and scoped to the
+   * instance of the object.
+   *
+   * @internal
+   */
+  export function defineSignal<T extends object>(obj: T, key: string, v?: unknown): void;
+  /**
+   * Define a non-enumerable signal property.
+   *
+   * @internal
+   */
+  export function defineNonEnumerableSignal<T extends object>(obj: T, key: string, v?: unknown): void;
+  export function memoized<T extends object, K extends keyof T & string>(target: T, key: K, descriptor: PropertyDescriptor): PropertyDescriptor;
+  export function gate<T extends object, K extends keyof T & string>(_target: T, key: K, desc: PropertyDescriptor): PropertyDescriptor;
+  export function defineGate<T extends object>(obj: T, key: string, desc: PropertyDescriptor): void;
+}
+//# sourceMappingURL=signal.d.ts.map

package/unstable-preview-types/-private/new-core-tmp/reactivity/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../../../src/-private/new-core-tmp/reactivity/signal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAW,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAUxE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,CAAC,EACN,GAAG,EAAE,MAAM,GAAG,MAAM,EACpB,YAAY,EAAE,OAAO,GACpB,eAAe,CAQjB;AAsBD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,QAE9E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,QAI3F;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EACnE,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,CAAC,EACN,UAAU,EAAE,kBAAkB,sBAoC/B;AAED,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,sBAqC9G;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,QAGzF"}

package/unstable-preview-types/-private/new-core-tmp/request-state.d.ts

@@ -0,0 +1,276 @@
+declare module '@ember-data/store/-private/new-core-tmp/request-state' {
+  import type { Future, ImmutableRequestInfo, ResponseInfo, StructuredErrorDocument } from '@ember-data/request';
+  import type { PendingPromise, RejectedPromise, ResolvedPromise } from '@ember-data/store/-private/new-core-tmp/promise-state';
+  /**
+   * Lazily consumes the stream of a request, providing a number of
+   * reactive properties that can be used to build UIs that respond
+   * to the progress of a request.
+   *
+   * @typedoc
+   */
+  export class RequestLoadingState {
+      _sizeHint: number;
+      _bytesLoaded: number;
+      _startTime: number;
+      _endTime: number;
+      _lastPacketTime: number;
+      _isPending: boolean;
+      _isStarted: boolean;
+      _isComplete: boolean;
+      _isCancelled: boolean;
+      _isErrored: boolean;
+      _error: Error | null;
+      _stream: TransformStream | null;
+      _future: Future<unknown>;
+      _triggered: boolean;
+      _trigger(): void;
+      promise: Promise<void> | null;
+      get isPending(): boolean;
+      get sizeHint(): number;
+      get stream(): ReadableStream | null;
+      get isStarted(): boolean;
+      get bytesLoaded(): number;
+      get startTime(): number;
+      get endTime(): number;
+      get lastPacketTime(): number;
+      get isComplete(): boolean;
+      get isCancelled(): boolean;
+      get isErrored(): boolean;
+      get error(): Error | null;
+      get elapsedTime(): number;
+      get completedRatio(): number;
+      get remainingRatio(): number;
+      get duration(): number;
+      get speed(): number;
+      constructor(future: Future<unknown>);
+      abort: () => void;
+  }
+  /**
+   * The state of a request in the "pending"
+   * state. This is the default initial state.
+   *
+   * Extends the {@link PendingPromise} interface.
+   *
+   * @typedoc
+   */
+  export interface PendingRequest extends PendingPromise {
+      /**
+       * Whether the request is cancelled.
+       *
+       * @typedoc
+       */
+      isCancelled: false;
+      loadingState: RequestLoadingState;
+      request: null;
+      response: null;
+  }
+  /**
+   * The state of a request in the "fulfilled" state.
+   * This is the state of a request that has resolved
+   * successfully.
+   *
+   * Extends the {@link ResolvedPromise} interface.
+   *
+   * @typedoc
+   */
+  export interface ResolvedRequest<T, RT> extends ResolvedPromise<RT> {
+      /**
+       * Whether the request is cancelled.
+       *
+       * @typedoc
+       */
+      isCancelled: false;
+      loadingState: RequestLoadingState;
+      request: ImmutableRequestInfo<T, RT> | null;
+      response: Response | ResponseInfo | null;
+  }
+  /**
+   * The state of a request in the "rejected" state.
+   * This is the state of a request that has rejected
+   * with an error.
+   *
+   * Extends the {@link RejectedPromise} interface.
+   *
+   * @typedoc
+   */
+  export interface RejectedRequest<T, RT, E extends StructuredErrorDocument = StructuredErrorDocument> extends RejectedPromise<E> {
+      /**
+       * Whether the request is cancelled.
+       *
+       * @typedoc
+       */
+      isCancelled: false;
+      loadingState: RequestLoadingState;
+      request: ImmutableRequestInfo<T, RT> | null;
+      response: Response | ResponseInfo | null;
+  }
+  /**
+   * The state of a request in the "cancelled" state.
+   * This is the state of a promise that has been
+   * cancelled.
+   *
+   * @typedoc
+   */
+  export interface CancelledRequest<T, RT, E extends StructuredErrorDocument = StructuredErrorDocument> {
+      /**
+       * The status of the request.
+       *
+       * @typedoc
+       */
+      status: 'cancelled';
+      /**
+       * Whether the request is pending.
+       *
+       * @typedoc
+       */
+      isPending: false;
+      /**
+       * Whether the request is pending.
+       *
+       * @typedoc
+       */
+      isLoading: false;
+      /**
+       * Whether the request has resolved
+       * successfully.
+       *
+       * @typedoc
+       */
+      isSuccess: false;
+      /**
+       * Whether the request has rejected
+       * with an error.
+       *
+       * @typedoc
+       */
+      isError: true;
+      /**
+       * Once the request has resolved, this will
+       * be the value the request resolved to.
+       *
+       * @typedoc
+       */
+      value: null;
+      /**
+       * Once the request has resolved, this will
+       * be the value the request resolved to.
+       *
+       * @deprecated use `value` instead
+       * @typedoc
+       */
+      result: null;
+      /**
+       * Once the request has rejected, this will
+       * be the error the request rejected with.
+       *
+       *
+       * @deprecated use `reason` instead
+       * @typedoc
+       */
+      error: E;
+      /**
+       * Once the request has rejected, this will
+       * be the error the request rejected with.
+       *
+       * @typedoc
+       */
+      reason: E;
+      /**
+       * Whether the request is cancelled.
+       *
+       * @typedoc
+       */
+      isCancelled: true;
+      loadingState: RequestLoadingState;
+      request: ImmutableRequestInfo<T, RT> | null;
+      response: Response | ResponseInfo | null;
+  }
+  /**
+   * RequestState extends the concept of PromiseState to provide a reactive
+   * wrapper for a request `Future` which allows you write declarative code
+   * around a Future's control flow.
+   *
+   * It is useful in both Template and JavaScript contexts, allowing you
+   * to quickly derive behaviors and data from pending, error and success
+   * states.
+   *
+   * The key difference between a Promise and a Future is that Futures provide
+   * access to a stream of their content, the identity of the request (if any)
+   * as well as the ability to attempt to abort the request.
+   *
+   * ```ts
+   * interface Future<T> extends Promise<T>> {
+   *   getStream(): Promise<ReadableStream>;
+   *   abort(): void;
+   *   lid: StableDocumentIdentifier | null;
+   * }
+   * ```
+   *
+   * These additional APIs allow us to craft even richer state experiences.
+   *
+   * To get the state of a request, use `getRequestState`.
+   *
+   * See also:
+   * - {@link PendingRequest}
+   * - {@link ResolvedRequest}
+   * - {@link RejectedRequest}
+   * - {@link CancelledRequest}
+   *
+   * @typedoc
+   */
+  export type RequestCacheRequestState<T = unknown, RT = unknown, E extends StructuredErrorDocument = StructuredErrorDocument> = PendingRequest | ResolvedRequest<T, RT> | RejectedRequest<T, RT, E> | CancelledRequest<T, RT, E>;
+  export function createRequestState<T, RT, E>(future: Future<RT>): Readonly<RequestCacheRequestState<T, RT, StructuredErrorDocument<E>>>;
+  /**
+   * `getRequestState` can be used in both JavaScript and Template contexts.
+   *
+   * ```ts
+   * import { getRequestState } from '@warp-drive/ember';
+   *
+   * const state = getRequestState(future);
+   * ```
+   *
+   * For instance, we could write a getter on a component that updates whenever
+   * the request state advances or the future changes, by combining the function
+   * with the use of `@cached`
+   *
+   * ```ts
+   * class Component {
+   *   @cached
+   *   get title() {
+   *     const state = getRequestState(this.args.request);
+   *     if (state.isPending) {
+   *       return 'loading...';
+   *     }
+   *     if (state.isError) { return null; }
+   *     return state.result.title;
+   *   }
+   * }
+   * ```
+   *
+   * Or in a template as a helper:
+   *
+   * ```gjs
+   * import { getRequestState } from '@warp-drive/ember';
+   *
+   * <template>
+   *   {{#let (getRequestState @request) as |state|}}
+   *     {{#if state.isPending}}
+   *       <Spinner />
+   *     {{else if state.isError}}
+   *       <ErrorForm @error={{state.error}} />
+   *     {{else}}
+   *       <h1>{{state.result.title}}</h1>
+   *     {{/if}}
+   *   {{/let}}
+   * </template>
+   * ```
+   *
+   * If looking to use in a template, consider also the `<Request />` component
+   * which offers a numbe of additional capabilities for requests *beyond* what
+   * `RequestState` provides.
+   *
+   * @typedoc
+   */
+  export function getRequestState<RT, T, E>(future: Future<RT>): Readonly<RequestCacheRequestState<T, RT, StructuredErrorDocument<E>>>;
+}
+//# sourceMappingURL=request-state.d.ts.map

package/unstable-preview-types/-private/new-core-tmp/request-state.d.ts.map

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

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

@@ -0,0 +1,145 @@
+declare module '@ember-data/store/-private/record-arrays/identifier-array' {
+  import type { LocalRelationshipOperation } from '@warp-drive/core-types/graph';
+  import type { StableDocumentIdentifier, StableRecordIdentifier } from '@warp-drive/core-types/identifier';
+  import type { TypeFromInstanceOrString } 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/json-api-raw';
+  import type { BaseFinderOptions } from '@ember-data/store/types';
+  import type { RecordArrayManager } from '@ember-data/store/-private/managers/record-array-manager';
+  import type { WarpDriveSignal } from '@ember-data/store/-private/new-core-tmp/reactivity/internal';
+  import { ARRAY_SIGNAL } from '@ember-data/store/-private/new-core-tmp/reactivity/internal';
+  import type { Store } from '@ember-data/store/-private/store-service';
+  import { NativeProxy } from '@ember-data/store/-private/record-arrays/native-proxy-type-fix';
+  export const SOURCE: "___(unique) Symbol(#source)";
+  export const MUTATE: "___(unique) Symbol(#update)";
+  const IS_COLLECTION: "___(unique) Symbol(IS_COLLECTION)";
+  export type IdentifierArrayCreateOptions<T = unknown> = {
+      identifiers: StableRecordIdentifier<TypeFromInstanceOrString<T>>[];
+      type?: TypeFromInstanceOrString<T>;
+      store: Store;
+      allowMutation: boolean;
+      manager: MinimumManager;
+      links?: Links | PaginationLinks | null;
+      meta?: Record<string, unknown> | null;
+      identifier?: StableDocumentIdentifier | null;
+  };
+  type PromiseTo<T> = Omit<Promise<T>, typeof Symbol.toStringTag>;
+  type PromiseManyArray<T> = {
+      length: number;
+      content: IdentifierArray<T> | null;
+      promise: Promise<IdentifierArray<T>> | null;
+  } & PromiseTo<IdentifierArray<T>>;
+  export type MinimumManager = {
+      _syncArray: (array: IdentifierArray) => void;
+      mutate?(mutation: LocalRelationshipOperation): void;
+      reloadHasMany?<T>(key: string, options?: BaseFinderOptions): Promise<IdentifierArray<T>> | PromiseManyArray<T>;
+  };
+  /**
+    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
+  */
+  export interface IdentifierArray<T = unknown> extends Omit<Array<T>, '[]'> {
+      [MUTATE]?(target: StableRecordIdentifier[], receiver: typeof NativeProxy<StableRecordIdentifier[], T[]>, prop: string, args: unknown[], _SIGNAL: WarpDriveSignal): unknown;
+  }
+  export 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;
+      readonly identifier: StableDocumentIdentifier | null;
+      [IS_COLLECTION]: boolean;
+      [ARRAY_SIGNAL]: WarpDriveSignal;
+      [SOURCE]: StableRecordIdentifier[];
+      links: Links | PaginationLinks | null;
+      meta: Record<string, unknown> | null;
+      modelName?: TypeFromInstanceOrString<T>;
+      /**
+        The store that created this record array.
+    
+        @property store
+        @private
+        @type Store
+        */
+      store: Store;
+      _manager: MinimumManager;
+      destroy(clear: boolean): void;
+      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 type CollectionCreateOptions = IdentifierArrayCreateOptions & {
+      manager: RecordArrayManager;
+      query: ImmutableRequestInfo | Record<string, unknown> | null;
+      isLoaded: boolean;
+  };
+  export class Collection<T = unknown> extends IdentifierArray<T> {
+      query: ImmutableRequestInfo | Record<string, unknown> | null;
+      _manager: RecordArrayManager;
+      constructor(options: CollectionCreateOptions);
+      _update(): Promise<Collection<T>>;
+      destroy(clear: boolean): void;
+  }
+  export {};
+}
+//# 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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"}

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

@@ -0,0 +1,203 @@
+declare module '@ember-data/store/-private/record-arrays/many-array' {
+  import type { StableRecordIdentifier } from '@warp-drive/core-types';
+  import type { Cache } from '@warp-drive/core-types/cache';
+  import type { TypedRecordInstance, TypeFromInstance, TypeFromInstanceOrString } from '@warp-drive/core-types/record';
+  import type { Links, PaginationLinks } from '@warp-drive/core-types/spec/json-api-raw';
+  import type { BaseFinderOptions, ModelSchema } from '@ember-data/store/types';
+  import { type WarpDriveSignal } from '@ember-data/store/-private/new-core-tmp/reactivity/internal';
+  import type { CreateRecordProperties, Store } from '@ember-data/store/-private/store-service';
+  import type { MinimumManager } from '@ember-data/store/-private/record-arrays/identifier-array';
+  import { IdentifierArray, MUTATE } from '@ember-data/store/-private/record-arrays/identifier-array';
+  import type { NativeProxy } from '@ember-data/store/-private/record-arrays/native-proxy-type-fix';
+  export interface ManyArrayCreateArgs<T> {
+      identifiers: StableRecordIdentifier<TypeFromInstanceOrString<T>>[];
+      type: TypeFromInstanceOrString<T>;
+      store: Store;
+      allowMutation: boolean;
+      manager: MinimumManager;
+      identifier: StableRecordIdentifier;
+      cache: Cache;
+      meta: Record<string, unknown> | null;
+      links: Links | PaginationLinks | null;
+      key: string;
+      isPolymorphic: boolean;
+      isAsync: boolean;
+      _inverseIsAsync: boolean;
+      isLoaded: boolean;
+  }
+  /**
+    A `ManyArray` is a `MutableArray` that represents the contents of a has-many
+    relationship.
+  
+    The `ManyArray` is instantiated lazily the first time the relationship is
+    requested.
+  
+    This class is not intended to be directly instantiated by consuming applications.
+  
+    ### Inverses
+  
+    Often, the relationships in Ember Data applications will have
+    an inverse. For example, imagine the following models are
+    defined:
+  
+    ```app/models/post.js
+    import Model, { hasMany } from '@ember-data/model';
+  
+    export default class PostModel extends Model {
+      @hasMany('comment') comments;
+    }
+    ```
+  
+    ```app/models/comment.js
+    import Model, { belongsTo } from '@ember-data/model';
+  
+    export default class CommentModel extends Model {
+      @belongsTo('post') post;
+    }
+    ```
+  
+    If you created a new instance of `Post` and added
+    a `Comment` record to its `comments` has-many
+    relationship, you would expect the comment's `post`
+    property to be set to the post that contained
+    the has-many.
+  
+    We call the record to which a relationship belongs-to the
+    relationship's _owner_.
+  
+    @class ManyArray
+    @public
+  */
+  export class RelatedCollection<T = unknown> extends IdentifierArray<T> {
+      isAsync: boolean;
+      /**
+        The loading state of this array
+    
+        @property isLoaded
+        @type {Boolean}
+        @public
+        */
+      isLoaded: boolean;
+      /**
+        `true` if the relationship is polymorphic, `false` otherwise.
+    
+        @property isPolymorphic
+        @type {Boolean}
+        @private
+        */
+      isPolymorphic: boolean;
+      _inverseIsAsync: boolean;
+      /**
+        Metadata associated with the request for async hasMany relationships.
+    
+        Example
+    
+        Given that the server returns the following JSON payload when fetching a
+        hasMany relationship:
+    
+        ```js
+        {
+          "comments": [{
+            "id": 1,
+            "comment": "This is the first comment",
+          }, {
+        // ...
+          }],
+    
+          "meta": {
+            "page": 1,
+            "total": 5
+          }
+        }
+        ```
+    
+        You can then access the meta data via the `meta` property:
+    
+        ```js
+        let comments = await post.comments;
+        let meta = comments.meta;
+    
+        // meta.page => 1
+        // meta.total => 5
+        ```
+    
+        @property meta
+        @type {Object | null}
+        @public
+        */
+      meta: Record<string, unknown> | null;
+      /**
+         * Retrieve the links for this relationship
+         *
+         @property links
+         @type {Object | null}
+         @public
+         */
+      links: Links | PaginationLinks | null;
+      identifier: StableRecordIdentifier;
+      cache: Cache;
+      _manager: MinimumManager;
+      store: Store;
+      key: string;
+      type: ModelSchema;
+      modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string;
+      constructor(options: ManyArrayCreateArgs<T>);
+      [MUTATE](target: StableRecordIdentifier[], receiver: typeof NativeProxy<StableRecordIdentifier[], T[]>, prop: string, args: unknown[], _SIGNAL: WarpDriveSignal): unknown;
+      notify(): void;
+      /**
+        Reloads all of the records in the manyArray. If the manyArray
+        holds a relationship that was originally fetched using a links url
+        EmberData will revisit the original links url to repopulate the
+        relationship.
+    
+        If the ManyArray holds the result of a `store.query()` reload will
+        re-run the original query.
+    
+        Example
+    
+        ```javascript
+        let user = store.peekRecord('user', '1')
+        await login(user);
+    
+        let permissions = await user.permissions;
+        await permissions.reload();
+        ```
+    
+        @method reload
+        @public
+      */
+      reload(options?: BaseFinderOptions): Promise<this>;
+      /**
+        Saves all of the records in the `ManyArray`.
+    
+        Note: this API can only be used in legacy mode with a configured Adapter.
+    
+        Example
+    
+        ```javascript
+        const { content: { data: inbox } } = await store.request(findRecord({ type: 'inbox', id: '1' }));
+    
+        let messages = await inbox.messages;
+        messages.forEach((message) => {
+          message.isRead = true;
+        });
+        messages.save();
+        ```
+    
+        @method save
+        @public
+        @return {PromiseArray} promise
+      */
+      /**
+        Create a child record within the owner
+    
+        @method createRecord
+        @public
+        @param {Object} hash
+        @return {Model} record
+      */
+      createRecord(hash: CreateRecordProperties<T>): T;
+      destroy(): void;
+  }
+}
+//# sourceMappingURL=many-array.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"many-array.d.ts","sourceRoot":"","sources":["../../../src/-private/record-arrays/many-array.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EAEV,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAEvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,EAAsC,KAAK,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC/G,OAAO,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,EAAU,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAI3D,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,WAAW,EAAE,sBAAsB,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IAExB,UAAU,EAAE,sBAAsB,CAAC;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrC,KAAK,EAAE,KAAK,GAAG,eAAe,GAAG,IAAI,CAAC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CACnB;AACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0CE;AACF,qBAAa,iBAAiB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IAC5D,OAAO,EAAE,OAAO,CAAC;IACzB;;;;;;QAMI;IAEI,QAAQ,EAAE,OAAO,CAAC;IAC1B;;;;;;QAMI;IACI,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqCI;IACI,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C;;;;;;SAMK;IACG,KAAK,EAAE,KAAK,GAAG,eAAe,GAAG,IAAI,CAAC;IACtC,UAAU,EAAE,sBAAsB,CAAC;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,CAAC,SAAS,mBAAmB,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;gBAEpE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAS3C,CAAC,MAAM,CAAC,CACN,MAAM,EAAE,sBAAsB,EAAE,EAChC,QAAQ,EAAE,OAAO,WAAW,CAAC,sBAAsB,EAAE,EAAE,CAAC,EAAE,CAAC,EAC3D,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,EAAE,eAAe,GACvB,OAAO;IA4MV,MAAM;IAIN;;;;;;;;;;;;;;;;;;;;;MAqBE;IACF,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD;;;;;;;;;;;;;;;;;;;;MAoBE;IAEF;;;;;;;MAOE;IACF,YAAY,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC;IAShD,OAAO;CAGR"}