@warp-drive/legacy 5.9.0-alpha.21 → 5.9.0-alpha.22

package/declarations/model/-private/model.d.ts

@@ -1,1279 +0,0 @@
-import EmberObject from "@ember/object";
-import type { Store } from "@warp-drive/core";
-import type { ModelSchema, ResourceKey } from "@warp-drive/core/types";
-import type { ChangedAttributesHash } from "@warp-drive/core/types/cache";
-import type { LegacyAttributeField, LegacyRelationshipField } from "@warp-drive/core/types/schema/fields";
-import type { Snapshot } from "../../compat/-private.js";
-import { Errors } from "./errors.js";
-import type { MinimalLegacyRecord } from "./model-methods.js";
-import RecordState from "./record-state.js";
-import type BelongsToReference from "./references/belongs-to.js";
-import type HasManyReference from "./references/has-many.js";
-import type { _MaybeBelongsToFields, isSubClass, MaybeAttrFields, MaybeHasManyFields, MaybeRelationshipFields } from "./type-utils.js";
-export type ModelCreateArgs = {
-	_createProps: Record<string, unknown>;
-	_secretInit: {
-		identifier: ResourceKey;
-		store: Store;
-		cb: (record: Model, identifier: ResourceKey, store: Store) => void;
-	};
-};
-export type StaticModel = typeof Model & {
-	create(options: ModelCreateArgs): Model;
-};
-export type ModelFactory = {
-	class: StaticModel;
-};
-export type FactoryCache = Record<string, ModelFactory>;
-export type ModelStore = Store & {
-	_modelFactoryCache: FactoryCache;
-};
-interface Model {
-	/**
-	* The store service instance which created this record instance
-	*/
-	store: Store;
-	/**
-	Create a JSON representation of the record, using the serialization
-	strategy of the store's adapter.
-	
-	`serialize` takes an optional hash as a parameter, currently
-	supported options are:
-	
-	- `includeId`: `true` if the record's ID should be included in the
-	JSON representation.
-	
-	@public
-	@param {Object} options
-	@return {Object} an object whose values are primitive JSON values only
-	*/
-	serialize<T extends MinimalLegacyRecord>(this: T, options?: Record<string, unknown>): unknown;
-	/**
-	Same as `deleteRecord`, but saves the record immediately.
-	
-	Example
-	
-	```js
-	import Component from '@glimmer/component';
-	
-	export default class extends Component {
-	delete = () => {
-	this.args.model.destroyRecord().then(function() {
-	this.transitionToRoute('model.index');
-	});
-	}
-	}
-	```
-	
-	If you pass an object on the `adapterOptions` property of the options
-	argument it will be passed to your adapter via the snapshot
-	
-	```js
-	record.destroyRecord({ adapterOptions: { subscribe: false } });
-	```
-	
-	```js [app/adapters/post.js]
-	import MyCustomAdapter from './custom-adapter';
-	
-	export default class PostAdapter extends MyCustomAdapter {
-	deleteRecord(store, type, snapshot) {
-	if (snapshot.adapterOptions.subscribe) {
-	// ...
-	}
-	// ...
-	}
-	}
-	```
-	
-	@public
-	@param options
-	@return a promise that will be resolved when the adapter returns
-	successfully or rejected if the adapter returns with an error.
-	*/
-	destroyRecord<T extends MinimalLegacyRecord>(this: T, options?: Record<string, unknown>): Promise<this>;
-	/**
-	Unloads the record from the store. This will not send a delete request
-	to your server, it just unloads the record from memory.
-	
-	@public
-	*/
-	unloadRecord<T extends MinimalLegacyRecord>(this: T): void;
-	/**
-	Returns an object, whose keys are changed properties, and value is
-	an [oldProp, newProp] array.
-	
-	The array represents the diff of the canonical state with the local state
-	of the model. Note: if the model is created locally, the canonical state is
-	empty since the adapter hasn't acknowledged the attributes yet:
-	
-	Example
-	
-	```js [app/models/mascot.js]
-	import { Model, attr } from '@warp-drive/legacy/model';
-	
-	export default class MascotModel extends Model {
-	@attr('string') name;
-	@attr('boolean', {
-	defaultValue: false
-	})
-	isAdmin;
-	}
-	```
-	
-	```javascript
-	let mascot = store.createRecord('mascot');
-	
-	mascot.changedAttributes(); // {}
-	
-	mascot.set('name', 'Tomster');
-	mascot.changedAttributes(); // { name: [undefined, 'Tomster'] }
-	
-	mascot.set('isAdmin', true);
-	mascot.changedAttributes(); // { isAdmin: [undefined, true], name: [undefined, 'Tomster'] }
-	
-	mascot.save().then(function() {
-	mascot.changedAttributes(); // {}
-	
-	mascot.set('isAdmin', false);
-	mascot.changedAttributes(); // { isAdmin: [true, false] }
-	});
-	```
-	
-	@public
-	@return {Object} an object, whose keys are changed properties,
-	and value is an [oldProp, newProp] array.
-	*/
-	changedAttributes<T extends MinimalLegacyRecord>(this: T): ChangedAttributesHash;
-	/**
-	If the model `hasDirtyAttributes` this function will discard any unsaved
-	changes. If the model `isNew` it will be removed from the store.
-	
-	Example
-	
-	```javascript
-	record.name; // 'Untitled Document'
-	record.set('name', 'Doc 1');
-	record.name; // 'Doc 1'
-	record.rollbackAttributes();
-	record.name; // 'Untitled Document'
-	```
-	
-	@since 1.13.0
-	@public
-	*/
-	rollbackAttributes<T extends MinimalLegacyRecord>(this: T): void;
-	/**
-	@private
-	*/
-	_createSnapshot<T extends MinimalLegacyRecord>(this: T): Snapshot<T>;
-	/**
-	Save the record and persist any changes to the record to an
-	external source via the adapter.
-	
-	Example
-	
-	```javascript
-	record.set('name', 'Tomster');
-	record.save().then(function() {
-	// Success callback
-	}, function() {
-	// Error callback
-	});
-	```
-	
-	If you pass an object using the `adapterOptions` property of the options
-	argument it will be passed to your adapter via the snapshot.
-	
-	```js
-	record.save({ adapterOptions: { subscribe: false } });
-	```
-	
-	```js [app/adapters/post.js]
-	import MyCustomAdapter from './custom-adapter';
-	
-	export default class PostAdapter extends MyCustomAdapter {
-	updateRecord(store, type, snapshot) {
-	if (snapshot.adapterOptions.subscribe) {
-	// ...
-	}
-	// ...
-	}
-	}
-	```
-	
-	@deprecated use {@link Store.request} instead
-	@public
-	@return a promise that will be resolved when the adapter returns
-	successfully or rejected if the adapter returns with an error.
-	*/
-	save<T extends MinimalLegacyRecord>(this: T, options?: Record<string, unknown>): Promise<this>;
-	/**
-	Reload the record from the adapter.
-	
-	This will only work if the record has already finished loading.
-	
-	Example
-	
-	```js
-	import Component from '@glimmer/component';
-	
-	export default class extends Component {
-	async reload = () => {
-	await this.args.model.reload();
-	// do something with the reloaded model
-	}
-	}
-	```
-	
-	@public
-	@param {Object} options optional, may include `adapterOptions` hash which will be passed to adapter request
-	
-	@return {Promise} a promise that will be resolved with the record when the
-	adapter returns successfully or rejected if the adapter returns
-	with an error.
-	*/
-	reload<T extends MinimalLegacyRecord>(this: T, options?: Record<string, unknown>): Promise<T>;
-	/**
-	Get the reference for the specified belongsTo relationship.
-	
-	For instance, given the following model
-	
-	```js [app/models/blog-post.js]
-	import { Model, belongsTo } from '@warp-drive/legacy/model';
-	
-	export default class BlogPost extends Model {
-	@belongsTo('user', { async: true, inverse: null }) author;
-	}
-	```
-	
-	Then the reference for the author relationship would be
-	retrieved from a record instance like so:
-	
-	```js
-	blogPost.belongsTo('author');
-	```
-	
-	A `BelongsToReference` is a low-level API that allows access
-	and manipulation of a belongsTo relationship.
-	
-	It is especially useful when you're dealing with `async` relationships
-	as it allows synchronous access to the relationship data if loaded, as
-	well as APIs for loading, reloading the data or accessing available
-	information without triggering a load.
-	
-	It may also be useful when using `sync` relationships that need to be
-	loaded/reloaded with more precise timing than marking the
-	relationship as `async` and relying on autofetch would have allowed.
-	
-	However,keep in mind that marking a relationship as `async: false` will introduce
-	bugs into your application if the data is not always guaranteed to be available
-	by the time the relationship is accessed. Ergo, it is recommended when using this
-	approach to utilize `links` for unloaded relationship state instead of identifiers.
-	
-	Reference APIs are entangled with the relationship's underlying state,
-	thus any getters or cached properties that utilize these will properly
-	invalidate if the relationship state changes.
-	
-	References are "stable", meaning that multiple calls to retrieve the reference
-	for a given relationship will always return the same HasManyReference.
-	
-	@public
-	@param prop - the name of the relationship
-	@since 2.5.0
-	@return reference for this relationship
-	*/
-	belongsTo<
-		T extends Model,
-		K extends keyof T & string
-	>(this: T, prop: K & (K extends _MaybeBelongsToFields<T> ? K : never)): BelongsToReference<T, K>;
-	/**
-	Get the reference for the specified hasMany relationship.
-	
-	For instance, given the following model
-	
-	```js [app/models/blog-post.js]
-	import { Model, hasMany } from '@warp-drive/legacy/model';
-	
-	export default class BlogPost extends Model {
-	@hasMany('comment', { async: true, inverse: null }) comments;
-	}
-	```
-	
-	Then the reference for the comments relationship would be
-	retrieved from a record instance like so:
-	
-	```js
-	blogPost.hasMany('comments');
-	```
-	
-	A `HasManyReference` is a low-level API that allows access
-	and manipulation of a hasMany relationship.
-	
-	It is especially useful when you are dealing with `async` relationships
-	as it allows synchronous access to the relationship data if loaded, as
-	well as APIs for loading, reloading the data or accessing available
-	information without triggering a load.
-	
-	It may also be useful when using `sync` relationships with `@ember-data/model`
-	that need to be loaded/reloaded with more precise timing than marking the
-	relationship as `async` and relying on autofetch would have allowed.
-	
-	However,keep in mind that marking a relationship as `async: false` will introduce
-	bugs into your application if the data is not always guaranteed to be available
-	by the time the relationship is accessed. Ergo, it is recommended when using this
-	approach to utilize `links` for unloaded relationship state instead of identifiers.
-	
-	Reference APIs are entangled with the relationship's underlying state,
-	thus any getters or cached properties that utilize these will properly
-	invalidate if the relationship state changes.
-	
-	References are "stable", meaning that multiple calls to retrieve the reference
-	for a given relationship will always return the same HasManyReference.
-	
-	@public
-	@param prop - the name of the relationship
-	@since 2.5.0
-	@return reference for this relationship
-	*/
-	hasMany<
-		T extends MinimalLegacyRecord,
-		K extends MaybeHasManyFields<T>
-	>(this: T, prop: K): HasManyReference<T, K>;
-	/**
-	Marks the record as deleted but does not save it. You must call
-	`save` afterwards if you want to persist it. You might use this
-	method if you want to allow the user to still `rollbackAttributes()`
-	after a delete was made.
-	
-	Example
-	
-	```js
-	import Component from '@glimmer/component';
-	
-	export default class extends Component {
-	softDelete = () => {
-	this.args.model.deleteRecord();
-	}
-	
-	confirm = () => {
-	this.args.model.save();
-	}
-	
-	undo = () => {
-	this.args.model.rollbackAttributes();
-	}
-	}
-	```
-	
-	@public
-	*/
-	deleteRecord<T extends MinimalLegacyRecord>(this: T): void;
-}
-/**
-* Base class from which Models can be defined.
-*
-* ::: code-group
-*
-* ```js [app/models/user.js]
-* import { Model, attr, belongsTo, hasMany } from '@warp-drive/legacy/model';
-*
-* export default class User extends Model {
-*   @attr name;
-*   @attr('number') age;
-*   @hasMany('post', { async: true, inverse: null }) posts;
-*   @belongsTo('group', { async: false, inverse: 'users' }) group;
-* }
-* ```
-*
-* ```ts [app/models/user.ts]
-* import { Model, attr, belongsTo, hasMany, type AsyncHasMany } from '@warp-drive/legacy/model';
-* import type { NumberTransform } from '@ember-data/serializer/transform';
-* import type Group from './group';
-* import type Post from './post';
-*
-* export default class User extends Model {
-*   @attr declare name: string;
-*
-*   @attr<NumberTransform>('number')
-*   declare age: number;
-*
-*   @hasMany('post', { async: true, inverse: null })
-*   declare posts: AsyncHasMany<Post>;
-*
-*   @belongsTo('group', { async: false, inverse: 'users' })
-*   declare group: Group | null;
-* }
-* ```
-*
-* :::
-*
-* Models both define the schema for a resource type and provide
-* the class to use as the reactive object for data of resource
-* of that type.
-*
-* @public
-* @noInheritDoc
-* @hideconstructor
-* @legacy
-*/
-declare class Model extends EmberObject implements MinimalLegacyRecord {
-	/** @private */
-	destroy(): this;
-	/**
-	If this property is `true` the record is in the `empty`
-	state. Empty is the first state all records enter after they have
-	been created. Most records created by the store will quickly
-	transition to the `loading` state if data needs to be fetched from
-	the server or the `created` state if the record is created on the
-	client. A record can also enter the empty state if the adapter is
-	unable to locate the record.
-	
-	@public
-	*/
-	get isEmpty(): boolean;
-	/**
-	If this property is `true` the record is in the `loading` state. A
-	record enters this state when the store asks the adapter for its
-	data. It remains in this state until the adapter provides the
-	requested data.
-	
-	@public
-	*/
-	get isLoading(): boolean;
-	/**
-	If this property is `true` the record is in the `loaded` state. A
-	record enters this state when its data is populated. Most of a
-	record's lifecycle is spent inside substates of the `loaded`
-	state.
-	
-	Example
-	
-	```javascript
-	let record = store.createRecord('model');
-	record.isLoaded; // true
-	
-	const { content: { data: model } } = await store.request(findRecord({ type: 'model', id: '1' }));
-	model.isLoaded;
-	```
-	
-	@public
-	*/
-	get isLoaded(): boolean;
-	/**
-	If this property is `true` the record is in the `dirty` state. The
-	record has local changes that have not yet been saved by the
-	adapter. This includes records that have been created (but not yet
-	saved) or deleted.
-	
-	Example
-	
-	```javascript
-	let record = store.createRecord('model');
-	record.hasDirtyAttributes; // true
-	
-	const { content: { data: model } } = await store.request(findRecord({ type: 'model', id: '1' }));
-	
-	model.hasDirtyAttributes; // false
-	model.foo = 'some value';
-	model.hasDirtyAttributes; // true
-	```
-	
-	@since 1.13.0
-	@public
-	*/
-	get hasDirtyAttributes(): boolean;
-	/**
-	If this property is `true` the record is in the `saving` state. A
-	record enters the saving state when `save` is called, but the
-	adapter has not yet acknowledged that the changes have been
-	persisted to the backend.
-	
-	Example
-	
-	```javascript
-	let record = store.createRecord('model');
-	record.isSaving; // false
-	let promise = record.save();
-	record.isSaving; // true
-	promise.then(function() {
-	record.isSaving; // false
-	});
-	```
-	
-	@public
-	*/
-	get isSaving(): boolean;
-	/**
-	If this property is `true` the record is in the `deleted` state
-	and has been marked for deletion. When `isDeleted` is true and
-	`hasDirtyAttributes` is true, the record is deleted locally but the deletion
-	was not yet persisted. When `isSaving` is true, the change is
-	in-flight. When both `hasDirtyAttributes` and `isSaving` are false, the
-	change has persisted.
-	
-	Example
-	
-	```javascript
-	let record = store.createRecord('model');
-	record.isDeleted;    // false
-	record.deleteRecord();
-	
-	// Locally deleted
-	record.isDeleted;           // true
-	record.hasDirtyAttributes;  // true
-	record.isSaving;            // false
-	
-	// Persisting the deletion
-	let promise = record.save();
-	record.isDeleted;    // true
-	record.isSaving;     // true
-	
-	// Deletion Persisted
-	promise.then(function() {
-	record.isDeleted;          // true
-	record.isSaving;           // false
-	record.hasDirtyAttributes; // false
-	});
-	```
-	
-	@public
-	*/
-	get isDeleted(): boolean;
-	/**
-	If this property is `true` the record is in the `new` state. A
-	record will be in the `new` state when it has been created on the
-	client and the adapter has not yet report that it was successfully
-	saved.
-	
-	Example
-	
-	```javascript
-	let record = store.createRecord('model');
-	record.isNew; // true
-	
-	record.save().then(function(model) {
-	model.isNew; // false
-	});
-	```
-	
-	@public
-	*/
-	get isNew(): boolean;
-	/**
-	If this property is `true` the record is in the `valid` state.
-	
-	A record will be in the `valid` state when the adapter did not report any
-	server-side validation failures.
-	
-	@public
-	*/
-	get isValid(): boolean;
-	/**
-	If the record is in the dirty state this property will report what
-	kind of change has caused it to move into the dirty
-	state. Possible values are:
-	
-	- `created` The record has been created by the client and not yet saved to the adapter.
-	- `updated` The record has been updated by the client and not yet saved to the adapter.
-	- `deleted` The record has been deleted by the client and not yet saved to the adapter.
-	
-	Example
-	
-	```javascript
-	let record = store.createRecord('model');
-	record.dirtyType; // 'created'
-	```
-	
-	@public
-	*/
-	get dirtyType(): "created" | "updated" | "deleted" | "";
-	/**
-	If `true` the adapter reported that it was unable to save local
-	changes to the backend for any reason other than a server-side
-	validation error.
-	
-	Example
-	
-	```javascript
-	record.isError; // false
-	record.set('foo', 'valid value');
-	record.save().then(null, function() {
-	record.isError; // true
-	});
-	```
-	
-	@public
-	*/
-	get isError(): boolean;
-	/**
-	* `isError` is read-only and cannot be set directly.
-	*/
-	set isError(v: boolean);
-	/**
-	If `true` the store is attempting to reload the record from the adapter.
-	
-	Example
-	
-	```javascript
-	record.isReloading; // false
-	record.reload();
-	record.isReloading; // true
-	```
-	
-	@public
-	*/
-	isReloading: boolean;
-	/**
-	All ember models have an id property. This is an identifier
-	managed by an external source. These are always coerced to be
-	strings before being used internally. Note when declaring the
-	attributes for a model it is an error to declare an id
-	attribute.
-	
-	```javascript
-	let record = store.createRecord('model');
-	record.id; // null
-	
-	const { content: { data: model } } = await store.request(findRecord({ type: 'model', id: '1' }));
-	model.id; // '1'
-	```
-	
-	@public
-	*/
-	get id(): string | null;
-	/**
-	* Assigns the resource's primary key. Typically only used internally
-	* when a client-created record is assigned an id upon being saved.
-	*/
-	set id(id: string | null);
-	toString(): string;
-	/**
-	@private
-	*/
-	get currentState(): RecordState;
-	/**
-	* `currentState` is read-only and cannot be set directly.
-	*/
-	set currentState(_v: RecordState);
-	/**
-	The store service instance which created this record instance
-	
-	@public
-	*/
-	store: Store;
-	/**
-	When the record is in the `invalid` state this object will contain
-	any errors returned by the adapter. When present the errors hash
-	contains keys corresponding to the invalid property names
-	and values which are arrays of Javascript objects with two keys:
-	
-	- `message` A string containing the error message from the backend
-	- `attribute` The name of the property associated with this error message
-	
-	```javascript
-	record.errors.length; // 0
-	record.set('foo', 'invalid value');
-	record.save().catch(function() {
-	record.errors.foo;
-	// [{message: 'foo should be a number.', attribute: 'foo'}]
-	});
-	```
-	
-	The `errors` property is useful for displaying error messages to
-	the user.
-	
-	```handlebars
-	<label>Username: <Input @value={{@model.username}} /> </label>
-	{{#each @model.errors.username as |error|}}
-	<div class="error">
-	{{error.message}}
-	</div>
-	{{/each}}
-	<label>Email: <Input @value={{@model.email}} /> </label>
-	{{#each @model.errors.email as |error|}}
-	<div class="error">
-	{{error.message}}
-	</div>
-	{{/each}}
-	```
-	
-	
-	You can also access the special `messages` property on the error
-	object to get an array of all the error strings.
-	
-	```handlebars
-	{{#each @model.errors.messages as |message|}}
-	<div class="error">
-	{{message}}
-	</div>
-	{{/each}}
-	```
-	
-	@public
-	*/
-	get errors(): Errors;
-	/**
-	This property holds the `AdapterError` object with which
-	last adapter operation was rejected.
-	
-	@public
-	*/
-	get adapterError(): unknown;
-	/**
-	* `adapterError` is read-only and cannot be set directly.
-	*/
-	set adapterError(v: unknown);
-	notifyPropertyChange(prop: string): this;
-	/**
-	Given a callback, iterates over each of the relationships in the model,
-	invoking the callback with the name of each relationship and its relationship
-	descriptor.
-	
-	
-	The callback method you provide should have the following signature (all
-	parameters are optional):
-	
-	```javascript
-	function(name, descriptor);
-	```
-	
-	- `name` the name of the current property in the iteration
-	- `descriptor` the meta object that describes this relationship
-	
-	The relationship descriptor argument is an object with the following properties.
-	
-	- **name** <span class="type">String</span> the name of this relationship on the Model
-	- **kind** <span class="type">String</span> "hasMany" or "belongsTo"
-	- **options** <span class="type">Object</span> the original options hash passed when the relationship was declared
-	- **parentType** <span class="type">Model</span> the type of the Model that owns this relationship
-	- **type** <span class="type">String</span> the type name of the related Model
-	
-	Note that in addition to a callback, you can also pass an optional target
-	object that will be set as `this` on the context.
-	
-	Example
-	
-	```js [app/serializers/application.js]
-	import JSONSerializer from '@ember-data/serializer/json';
-	
-	export default class ApplicationSerializer extends JSONSerializer {
-	serialize(record, options) {
-	let json = {};
-	
-	record.eachRelationship(function(name, descriptor) {
-	if (descriptor.kind === 'hasMany') {
-	let serializedHasManyName = name.toUpperCase() + '_IDS';
-	json[serializedHasManyName] = record.get(name).map(r => r.id);
-	}
-	});
-	
-	return json;
-	}
-	}
-	```
-	
-	@public
-	@param callback the callback to invoke
-	@param binding the value to which the callback's `this` should be bound
-	*/
-	eachRelationship<T>(callback: (this: NoInfer<T> | undefined, key: MaybeRelationshipFields<this>, meta: LegacyRelationshipField) => void, binding?: T): void;
-	/**
-	* Returns the relationship schema for the given relationship name, if any.
-	*/
-	relationshipFor(name: string): LegacyRelationshipField | undefined;
-	/**
-	* Returns the inverse relationship schema for the given relationship
-	* name, if one exists. See {@link Model.inverseFor | the static inverseFor}.
-	*/
-	inverseFor(name: string): LegacyRelationshipField | null;
-	/**
-	* Iterates over the attributes defined on this record's class, calling
-	* `callback` for each one. See {@link Model.eachAttribute | the static eachAttribute}.
-	*
-	* @param callback the callback to invoke
-	* @param binding the value to which the callback's `this` should be bound
-	*/
-	eachAttribute<T>(callback: (this: NoInfer<T> | undefined, key: isSubClass<this> extends true ? MaybeAttrFields<this> : string, meta: LegacyAttributeField) => void, binding?: T): void;
-	/**
-	Represents the model's class name as a string. This can be used to look up the model's class name through
-	`Store`'s modelFor method.
-	
-	`modelName` is generated for you by WarpDrive. It will be a lowercased, dasherized string.
-	For example:
-	
-	```javascript
-	store.modelFor('post').modelName; // 'post'
-	store.modelFor('blog-post').modelName; // 'blog-post'
-	```
-	
-	The most common place you'll want to access `modelName` is in your serializer's `payloadKeyFromModelName` method. For example, to change payload
-	keys to underscore (instead of dasherized), you might use the following code:
-	
-	```javascript
-	import RESTSerializer from '@ember-data/serializer/rest';
-	import { underscore } from '<app-name>/utils/string-utils';
-	
-	export default const PostSerializer = RESTSerializer.extend({
-	payloadKeyFromModelName(modelName) {
-	return underscore(modelName);
-	}
-	});
-	```
-	
-	@public
-	*/
-	static modelName: string;
-	/**
-	For a given relationship name, returns the model type of the relationship.
-	
-	For example, if you define a model like this:
-	
-	```js [app/models/post.js]
-	import { Model, hasMany } from '@warp-drive/legacy/model';
-	
-	export default class PostModel extends Model {
-	@hasMany('comment') comments;
-	}
-	```
-	
-	Calling `store.modelFor('post').typeForRelationship('comments', store)` will return `Comment`.
-	
-	@public
-	@param name the name of the relationship
-	@param store an instance of Store
-	@return the type of the relationship, or undefined
-	*/
-	static typeForRelationship(name: string, store: Store): ModelSchema | undefined;
-	/**
-	* A cache of resolved inverse relationships by name, populated lazily by
-	* {@link Model.inverseFor | inverseFor}.
-	*/
-	static get inverseMap(): Record<string, LegacyRelationshipField | null>;
-	/**
-	Find the relationship which is the inverse of the one asked for.
-	
-	For example, if you define models like this:
-	
-	```js [app/models/post.js]
-	import { Model, hasMany } from '@warp-drive/legacy/model';
-	
-	export default class PostModel extends Model {
-	@hasMany('message') comments;
-	}
-	```
-	
-	```js [app/models/message.js]
-	import { Model, belongsTo } from '@warp-drive/legacy/model';
-	
-	export default class MessageModel extends Model {
-	@belongsTo('post') owner;
-	}
-	```
-	
-	``` js
-	store.modelFor('post').inverseFor('comments', store) // { type: 'message', name: 'owner', kind: 'belongsTo' }
-	store.modelFor('message').inverseFor('owner', store) // { type: 'post', name: 'comments', kind: 'hasMany' }
-	```
-	
-	@public
-	@param name the name of the relationship
-	@param store
-	@return the inverse relationship, or null
-	*/
-	static inverseFor(name: string, store: Store): LegacyRelationshipField | null;
-	/**
-	* @private
-	*/
-	static _findInverseFor(name: string, store: Store): LegacyRelationshipField | null;
-	/**
-	The model's relationships as a map, keyed on the type of the
-	relationship. The value of each entry is an array containing a descriptor
-	for each relationship with that type, describing the name of the relationship
-	as well as the type.
-	
-	For example, given the following model definition:
-	
-	```js [app/models/blog.js]
-	import { Model, belongsTo, hasMany } from '@warp-drive/legacy/model';
-	
-	export default class BlogModel extends Model {
-	@hasMany('user') users;
-	@belongsTo('user') owner;
-	@hasMany('post') posts;
-	}
-	```
-	
-	This computed property would return a map describing these
-	relationships, like this:
-	
-	```javascript
-	import Blog from 'app/models/blog';
-	import User from 'app/models/user';
-	import Post from 'app/models/post';
-	
-	let relationships = Blog.relationships;
-	relationships.user;
-	//=> [ { name: 'users', kind: 'hasMany' },
-	//     { name: 'owner', kind: 'belongsTo' } ]
-	relationships.post;
-	//=> [ { name: 'posts', kind: 'hasMany' } ]
-	```
-	
-	@public
-	*/
-	static get relationships(): Map<string, LegacyRelationshipField[]>;
-	/**
-	A hash containing lists of the model's relationships, grouped
-	by the relationship kind. For example, given a model with this
-	definition:
-	
-	```js [app/models/blog.js]
-	import { Model, belongsTo, hasMany } from '@warp-drive/legacy/model';
-	
-	export default class BlogModel extends Model {
-	@hasMany('user') users;
-	@belongsTo('user') owner;
-	
-	@hasMany('post') posts;
-	}
-	```
-	
-	This property would contain the following:
-	
-	```javascript
-	import Blog from 'app/models/blog';
-	
-	let relationshipNames = Blog.relationshipNames;
-	relationshipNames.hasMany;
-	//=> ['users', 'posts']
-	relationshipNames.belongsTo;
-	//=> ['owner']
-	```
-	
-	@public
-	*/
-	static get relationshipNames(): {
-		/**
-		* the names of the model's `hasMany` relationships
-		*/
-		hasMany: string[];
-		/**
-		* the names of the model's `belongsTo` relationships
-		*/
-		belongsTo: string[];
-	};
-	/**
-	An array of types directly related to a model. Each type will be
-	included once, regardless of the number of relationships it has with
-	the model.
-	
-	For example, given a model with this definition:
-	
-	```js [app/models/blog.js]
-	import { Model, belongsTo, hasMany } from '@warp-drive/legacy/model';
-	
-	export default class BlogModel extends Model {
-	@hasMany('user') users;
-	@belongsTo('user') owner;
-	
-	@hasMany('post') posts;
-	}
-	```
-	
-	This property would contain the following:
-	
-	```javascript
-	import Blog from 'app/models/blog';
-	
-	let relatedTypes = Blog.relatedTypes');
-	//=> ['user', 'post']
-	```
-	
-	@public
-	*/
-	static get relatedTypes(): string[];
-	/**
-	A map whose keys are the relationships of a model and whose values are
-	relationship descriptors.
-	
-	For example, given a model with this
-	definition:
-	
-	```js [app/models/blog.js]
-	import { Model, belongsTo, hasMany } from '@warp-drive/legacy/model';
-	
-	export default class BlogModel extends Model {
-	@hasMany('user') users;
-	@belongsTo('user') owner;
-	
-	@hasMany('post') posts;
-	}
-	```
-	
-	This property would contain the following:
-	
-	```javascript
-	import Blog from 'app/models/blog';
-	
-	let relationshipsByName = Blog.relationshipsByName;
-	relationshipsByName.users;
-	//=> { name: 'users', kind: 'hasMany', type: 'user', options: Object }
-	relationshipsByName.owner;
-	//=> { name: 'owner', kind: 'belongsTo', type: 'user', options: Object }
-	```
-	
-	@public
-	*/
-	static get relationshipsByName(): Map<string, LegacyRelationshipField>;
-	/**
-	* A hash of the model's relationship schemas keyed by relationship name.
-	* See also {@link Model.relationshipsByName | relationshipsByName}, which
-	* provides the same information as a `Map`.
-	*/
-	static get relationshipsObject(): Record<string, LegacyRelationshipField>;
-	/**
-	A map whose keys are the fields of the model and whose values are strings
-	describing the kind of the field. A model's fields are the union of all of its
-	attributes and relationships.
-	
-	For example:
-	
-	```js [app/models/blog.js]
-	import { Model, attr, belongsTo, hasMany } from '@warp-drive/legacy/model';
-	
-	export default class BlogModel extends Model {
-	@hasMany('user') users;
-	@belongsTo('user') owner;
-	
-	@hasMany('post') posts;
-	
-	@attr('string') title;
-	}
-	```
-	
-	```js
-	import Blog from 'app/models/blog'
-	
-	let fields = Blog.fields;
-	fields.forEach(function(kind, field) {
-	// do thing
-	});
-	
-	// prints:
-	// users, hasMany
-	// owner, belongsTo
-	// posts, hasMany
-	// title, attribute
-	```
-	
-	@public
-	*/
-	static get fields(): Map<string, "attribute" | "belongsTo" | "hasMany">;
-	/**
-	Given a callback, iterates over each of the relationships in the model,
-	invoking the callback with the name of each relationship and its relationship
-	descriptor.
-	
-	@public
-	@param callback the callback to invoke
-	@param binding the value to which the callback's `this` should be bound
-	*/
-	static eachRelationship<
-		T,
-		Schema extends Model
-	>(callback: (this: T | undefined, key: MaybeRelationshipFields<Schema>, relationship: LegacyRelationshipField) => void, binding?: T): void;
-	/**
-	Given a callback, iterates over each of the types related to a model,
-	invoking the callback with the related type's class. Each type will be
-	returned just once, regardless of how many different relationships it has
-	with a model.
-	
-	@public
-	@param callback the callback to invoke
-	@param binding the value to which the callback's `this` should be bound
-	*/
-	static eachRelatedType<T>(callback: (this: T | undefined, type: string) => void, binding?: T): void;
-	/**
-	*
-	* @private
-	* @deprecated
-	*/
-	static determineRelationshipType(knownSide: LegacyRelationshipField, store: Store): "oneToOne" | "oneToMany" | "manyToOne" | "manyToMany" | "oneToNone" | "manyToNone";
-	/**
-	A map whose keys are the attributes of the model (properties
-	described by attr) and whose values are the meta object for the
-	property.
-	
-	Example
-	
-	```js [app/models/person.js]
-	import { Model, attr } from '@warp-drive/legacy/model';
-	
-	export default class PersonModel extends Model {
-	@attr('string') firstName;
-	@attr('string') lastName;
-	@attr('date') birthday;
-	}
-	```
-	
-	```javascript
-	import Person from 'app/models/person'
-	
-	let attributes = Person.attributes
-	
-	attributes.forEach(function(meta, name) {
-	// do thing
-	});
-	
-	// prints:
-	// firstName {type: "string", kind: 'attribute', options: Object, parentType: function, name: "firstName"}
-	// lastName {type: "string", kind: 'attribute', options: Object, parentType: function, name: "lastName"}
-	// birthday {type: "date", kind: 'attribute', options: Object, parentType: function, name: "birthday"}
-	```
-	
-	@public
-	*/
-	static get attributes(): Map<string, LegacyAttributeField>;
-	/**
-	A map whose keys are the attributes of the model (properties
-	described by attr) and whose values are type of transformation
-	applied to each attribute. This map does not include any
-	attributes that do not have an transformation type.
-	
-	Example
-	
-	```js [app/models/person.js]
-	import { Model, attr } from '@warp-drive/legacy/model';
-	
-	export default class PersonModel extends Model {
-	@attr firstName;
-	@attr('string') lastName;
-	@attr('date') birthday;
-	}
-	```
-	
-	```javascript
-	import Person from 'app/models/person';
-	
-	let transformedAttributes = Person.transformedAttributes
-	
-	transformedAttributes.forEach(function(field, type) {
-	// do thing
-	});
-	
-	// prints:
-	// lastName string
-	// birthday date
-	```
-	
-	@public
-	*/
-	static get transformedAttributes(): Map<string, string>;
-	/**
-	Iterates through the attributes of the model, calling the passed function on each
-	attribute.
-	
-	The callback method you provide should have the following signature (all
-	parameters are optional):
-	
-	```javascript
-	function(name, meta);
-	```
-	
-	- `name` the name of the current property in the iteration
-	- `meta` the meta object for the attribute property in the iteration
-	
-	Note that in addition to a callback, you can also pass an optional target
-	object that will be set as `this` on the context.
-	
-	Example
-	
-	```javascript
-	import { Model, attr } from '@warp-drive/legacy/model';
-	
-	class PersonModel extends Model {
-	@attr('string') firstName;
-	@attr('string') lastName;
-	@attr('date') birthday;
-	}
-	
-	PersonModel.eachAttribute(function(name, meta) {
-	// do thing
-	});
-	
-	// prints:
-	// firstName {type: "string", kind: 'attribute', options: Object, parentType: function, name: "firstName"}
-	// lastName {type: "string", kind: 'attribute', options: Object, parentType: function, name: "lastName"}
-	// birthday {type: "date", kind: 'attribute', options: Object, parentType: function, name: "birthday"}
-	```
-	
-	@public
-	@param callback The callback to execute
-	@param binding [optional] the value to which the callback's `this` should be bound
-	*/
-	static eachAttribute<
-		T,
-		Schema extends Model
-	>(callback: (this: T | undefined, key: MaybeAttrFields<Schema>, attribute: LegacyAttributeField) => void, binding?: T): void;
-	/**
-	Iterates through the transformedAttributes of the model, calling
-	the passed function on each attribute. Note the callback will not be
-	called for any attributes that do not have an transformation type.
-	
-	The callback method you provide should have the following signature (all
-	parameters are optional):
-	
-	```javascript
-	function(name, type);
-	```
-	
-	- `name` the name of the current property in the iteration
-	- `type` a string containing the name of the type of transformed
-	applied to the attribute
-	
-	Note that in addition to a callback, you can also pass an optional target
-	object that will be set as `this` on the context.
-	
-	Example
-	
-	```javascript
-	import { Model, attr } from '@warp-drive/legacy/model';
-	
-	let Person = Model.extend({
-	firstName: attr(),
-	lastName: attr('string'),
-	birthday: attr('date')
-	});
-	
-	Person.eachTransformedAttribute(function(name, type) {
-	// do thing
-	});
-	
-	// prints:
-	// lastName string
-	// birthday date
-	```
-	
-	@public
-	@param callback The callback to execute
-	@param binding [optional] the value to which the callback's `this` should be bound
-	*/
-	static eachTransformedAttribute<
-		T,
-		Schema extends Model
-	>(callback: (this: T | undefined, key: Exclude<keyof Schema & string, keyof Model & string>, type: string) => void, binding?: T): void;
-	/**
-	Returns the name of the model class.
-	
-	@public
-	*/
-	static toString(): string;
-}
-/**
-* Restores the pre-`RequestManager` implementations of `save`,
-* `destroyRecord`, and `reload` onto the given `Model` subclass, for
-* apps that have not yet migrated off of the deprecated
-* `ENABLE_LEGACY_REQUEST_METHODS` behaviors.
-*/
-export declare function restoreDeprecatedModelRequestBehaviors(ModelKlass: typeof Model): void;
-export { Model };