@warp-drive/legacy 5.10.0-alpha.10 → 5.10.0-alpha.13

package/dist/adapter-D3A8ixjz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-D3A8ixjz.d.ts","names":[],"sources":["../src/adapter/-private/build-url-mixin.ts","../src/adapter.ts"],"mappings":"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"}

package/dist/adapter.d.ts

@@ -1,2 +1,2 @@
-import { n as BuildURLMixin, t as Adapter } from "./adapter-CARrK3-8.js";
+import { n as BuildURLMixin, t as Adapter } from "./adapter-D3A8ixjz.js";
 export { Adapter, BuildURLMixin };

package/dist/adapter.js

@@ -1,3 +1,3 @@
-import { n as BuildURLMixin, t as Adapter } from "./adapter-eYo2pIuM.js";
+import { n as BuildURLMixin, t as Adapter } from "./adapter-BNC6wlWu.js";
 
 export { Adapter, BuildURLMixin };

package/dist/compat/-private.d.ts

@@ -1,2 +1,2 @@
-import { d as FetchManager, f as SaveOp, m as Snapshot, p as SnapshotRecordArray, u as upgradeStore } from "../compat-BbNNmTM-.js";
+import { d as FetchManager, f as SaveOp, m as Snapshot, p as SnapshotRecordArray, u as upgradeStore } from "../compat-BZlQ-5eI.js";
 export { FetchManager, SaveOp, Snapshot, SnapshotRecordArray, upgradeStore };

package/dist/compat/builders.d.ts

@@ -22,6 +22,8 @@ All `@warp-drive/legacy/compat` builders exist to enable you to migrate your cod
 This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
 To that end, these builders are deprecated and will be removed in a future version of WarpDrive.
 
+@summary Deprecated legacy builder for a `store.request` config that behaves like `store.findAll`, easing
+migration off adapters and serializers.
 @deprecated
 @public
 @param type the name of the resource
@@ -68,6 +70,8 @@ All `@warp-drive/legacy/compat` builders exist to enable you to migrate your cod
 This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
 To that end, these builders are deprecated and will be removed in a future version of Warp Drive.
 
+@summary Deprecated legacy builder for a `store.request` config that behaves like `store.findRecord`, taking a
+type and id or a resource identifier.
 @deprecated
 @public
 @param resource - either a string representing the name of the resource or a ResourceIdentifier object containing both the type (a string) and the id (a string) for the record or an lid (a string) of an existing record
@@ -100,6 +104,8 @@ All `@warp-drive/legacy/compat` builders exist to enable you to migrate your cod
 This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
 To that end, these builders are deprecated and will be removed in a future version of WarpDrive.
 
+@summary Deprecated legacy builder for a `store.request` config that behaves like `store.query`, returning the
+records matching a query object.
 @deprecated
 @public
 @param type the name of the resource
@@ -127,6 +133,8 @@ All `@warp-drive/legacy/compat` builders exist to enable you to migrate your cod
 This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
 To that end, these builders are deprecated and will be removed in a future version of WarpDrive.
 
+@summary Deprecated legacy builder for a `store.request` config that behaves like `store.queryRecord`, returning
+a single record or `null` for a query object.
 @deprecated
 @public
 @param type the name of the resource
@@ -157,6 +165,8 @@ All `@ember-data/legacy-compat` builders exist to enable you to migrate your cod
 This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
 To that end, these builders are deprecated and will be removed in a future version of Ember Data.
 
+@summary Deprecated legacy builder for a `store.request` config that creates, updates, or deletes a record
+through adapters, like the legacy `store.saveRecord`.
 @deprecated
 @public
 @param {Object} record a record to save

package/dist/compat/builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","names":[],"sources":["../../src/compat/builders/find-all.ts","../../src/compat/builders/find-record.ts","../../src/compat/builders/query.ts","../../src/compat/builders/save-record.ts"],"mappings":";;;;;;KASK,oBAAoB,2BAA2B,kBAAkB;EACpE;EACA;IACE,MAAM;IACN,SAAS;;GAEV,oBAAoB;;KAGlB,wBAAwB;;;;;;;;;;;;;;;;iBAiBb,eAAe,UAAU,qBACvC,MAAM,iBAAiB,IACvB,UAAU,wBACT,oBAAoB,iBAAiB,IAAI;iBAC5B,eAAe,cAAc,UAAU,wBAAwB;;;KC5B1E,uBAAuB,2BAA2B,gBAAgB;EACrE;EACA;IACE,QAAQ,yBAAyB;IACjC,SAAS;;GAEV,oBAAoB;;KAGlB,2BAA2B,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoCrB,kBAAkB,UAAU,qBAC1C,MAAM,iBAAiB,IACvB,YACA,UAAU,2BACT,uBAAuB,iBAAiB,IAAI;iBAC/B,kBAAkB,cAAc,YAAY,UAAU,2BAA2B;iBACjF,kBAAkB,UAAU,qBAC1C,UAAU,yBAAyB,iBAAiB,KACpD,UAAU,2BACT,uBAAuB,iBAAiB,IAAI;iBAC/B,kBACd,UAAU,0BACV,UAAU,2BACT;;;KC5DE,kBAAkB,2BAA2B,kBAAkB;EAClE;EACA;IACE,MAAM;IACN,OAAO;IACP,SAAS;;GAEV,oBAAoB;;KAGlB,sBAAsB;;;;;;;;;;;;;;;;;iBAkBX,aAAa,UAAU,qBACrC,MAAM,iBAAiB,IACvB,OAAO,qBACP,UAAU,sBACT,kBAAkB,iBAAiB,IAAI;iBAC1B,aACd,cACA,OAAO,qBACP,UAAU,sBACT;KAwBE,wBAAwB,2BAA2B,gBAAgB;EACtE;EACA;IACE,MAAM;IACN,OAAO;IACP,SAAS;;GAEV,oBAAoB;;;;;;;;;;;;;;;;;;iBAmBP,mBAAmB,UAAU,qBAC3C,MAAM,iBAAiB,IACvB,OAAO,qBACP,UAAU,sBACT,wBAAwB,iBAAiB,IAAI;iBAChC,mBACd,cACA,OAAO,qBACP,UAAU,sBACT;;;KChGE,uBAAuB,2BAA2B,gBAAgB;EACrE;EACA;IACE,QAAQ,YAAY;IACpB,SAAS;;EAEX,UAAU,YAAY;GACrB,oBAAoB;;KAGlB,2BAA2B;;;;;;;;;;;;;;;;iBA0BhB,kBAAkB,UAAU,qBAC1C,QAAQ,GACR,UAAS,0BACR,uBAAuB,iBAAiB,IAAI"}
+{"version":3,"file":"builders.d.ts","names":[],"sources":["../../src/compat/builders/find-all.ts","../../src/compat/builders/find-record.ts","../../src/compat/builders/query.ts","../../src/compat/builders/save-record.ts"],"mappings":";;;;;;KASK,oBAAoB,2BAA2B,kBAAkB;EACpE;EACA;IACE,MAAM;IACN,SAAS;;GAEV,oBAAoB;;KAGlB,wBAAwB;;;;;;;;;;;;;;;;;;iBAmBb,eAAe,UAAU,qBACvC,MAAM,iBAAiB,IACvB,UAAU,wBACT,oBAAoB,iBAAiB,IAAI;iBAC5B,eAAe,cAAc,UAAU,wBAAwB;;;KC9B1E,uBAAuB,2BAA2B,gBAAgB;EACrE;EACA;IACE,QAAQ,yBAAyB;IACjC,SAAS;;GAEV,oBAAoB;;KAGlB,2BAA2B,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsCrB,kBAAkB,UAAU,qBAC1C,MAAM,iBAAiB,IACvB,YACA,UAAU,2BACT,uBAAuB,iBAAiB,IAAI;iBAC/B,kBAAkB,cAAc,YAAY,UAAU,2BAA2B;iBACjF,kBAAkB,UAAU,qBAC1C,UAAU,yBAAyB,iBAAiB,KACpD,UAAU,2BACT,uBAAuB,iBAAiB,IAAI;iBAC/B,kBACd,UAAU,0BACV,UAAU,2BACT;;;KC9DE,kBAAkB,2BAA2B,kBAAkB;EAClE;EACA;IACE,MAAM;IACN,OAAO;IACP,SAAS;;GAEV,oBAAoB;;KAGlB,sBAAsB;;;;;;;;;;;;;;;;;;;iBAoBX,aAAa,UAAU,qBACrC,MAAM,iBAAiB,IACvB,OAAO,qBACP,UAAU,sBACT,kBAAkB,iBAAiB,IAAI;iBAC1B,aACd,cACA,OAAO,qBACP,UAAU,sBACT;KAwBE,wBAAwB,2BAA2B,gBAAgB;EACtE;EACA;IACE,MAAM;IACN,OAAO;IACP,SAAS;;GAEV,oBAAoB;;;;;;;;;;;;;;;;;;;;iBAqBP,mBAAmB,UAAU,qBAC3C,MAAM,iBAAiB,IACvB,OAAO,qBACP,UAAU,sBACT,wBAAwB,iBAAiB,IAAI;iBAChC,mBACd,cACA,OAAO,qBACP,UAAU,sBACT;;;KCpGE,uBAAuB,2BAA2B,gBAAgB;EACrE;EACA;IACE,QAAQ,YAAY;IACpB,SAAS;;EAEX,UAAU,YAAY;GACrB,oBAAoB;;KAGlB,2BAA2B;;;;;;;;;;;;;;;;;;iBA4BhB,kBAAkB,UAAU,qBAC1C,QAAQ,GACR,UAAS,0BACR,uBAAuB,iBAAiB,IAAI"}

package/dist/compat/builders.js

@@ -14,6 +14,8 @@ All `@warp-drive/legacy/compat` builders exist to enable you to migrate your cod
 This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
 To that end, these builders are deprecated and will be removed in a future version of WarpDrive.
 
+@summary Deprecated legacy builder for a `store.request` config that behaves like `store.findAll`, easing
+migration off adapters and serializers.
 @deprecated
 @public
 @param type the name of the resource
@@ -66,6 +68,8 @@ All `@warp-drive/legacy/compat` builders exist to enable you to migrate your cod
 This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
 To that end, these builders are deprecated and will be removed in a future version of Warp Drive.
 
+@summary Deprecated legacy builder for a `store.request` config that behaves like `store.findRecord`, taking a
+type and id or a resource identifier.
 @deprecated
 @public
 @param resource - either a string representing the name of the resource or a ResourceIdentifier object containing both the type (a string) and the id (a string) for the record or an lid (a string) of an existing record
@@ -111,6 +115,8 @@ All `@warp-drive/legacy/compat` builders exist to enable you to migrate your cod
 This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
 To that end, these builders are deprecated and will be removed in a future version of WarpDrive.
 
+@summary Deprecated legacy builder for a `store.request` config that behaves like `store.query`, returning the
+records matching a query object.
 @deprecated
 @public
 @param type the name of the resource
@@ -147,6 +153,8 @@ All `@warp-drive/legacy/compat` builders exist to enable you to migrate your cod
 This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
 To that end, these builders are deprecated and will be removed in a future version of WarpDrive.
 
+@summary Deprecated legacy builder for a `store.request` config that behaves like `store.queryRecord`, returning
+a single record or `null` for a query object.
 @deprecated
 @public
 @param type the name of the resource
@@ -193,6 +201,8 @@ All `@ember-data/legacy-compat` builders exist to enable you to migrate your cod
 This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
 To that end, these builders are deprecated and will be removed in a future version of Ember Data.
 
+@summary Deprecated legacy builder for a `store.request` config that creates, updates, or deletes a record
+through adapters, like the legacy `store.saveRecord`.
 @deprecated
 @public
 @param {Object} record a record to save

package/dist/compat/builders.js.map

@@ -1 +1 @@
-{"version":3,"file":"builders.js","names":["SkipCache","normalizeModelName","macroCondition","getGlobalConfig","findAllBuilder","type","options","WarpDrive","env","DEBUG","test","Error","op","data","cacheOptions","constructResource","ensureStringId","SkipCache","isMaybeIdentifier","normalizeModelName","macroCondition","getGlobalConfig","findRecordBuilder","resource","idOrOptions","options","WarpDrive","env","DEBUG","test","Error","type","normalizedId","preload","op","data","record","cacheOptions","SkipCache","normalizeModelName","macroCondition","getGlobalConfig","queryBuilder","type","query","options","WarpDrive","env","DEBUG","test","Error","op","data","cacheOptions","queryRecordBuilder","recordIdentifierFor","storeFor","assertPrivateStore","SkipCache","macroCondition","getGlobalConfig","_resourceIsFullDeleted","identifier","cache","isDeletionCommitted","isNew","isDeleted","resourceIsFullyDeleted","instanceCache","saveRecordBuilder","record","options","store","WarpDrive","env","DEBUG","test","Error","lid","_instanceCache","recordIsLoaded","operation","op","data","records","cacheOptions"],"sources":["../../src/compat/builders/find-all.ts","../../src/compat/builders/find-record.ts","../../src/compat/builders/query.ts","../../src/compat/builders/save-record.ts"],"sourcesContent":["import type { StoreRequestInput } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport type { FindAllOptions } from '@warp-drive/core/types';\nimport type { TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport { SkipCache } from '@warp-drive/core/types/request';\nimport type { RequestSignature } from '@warp-drive/core/types/symbols';\n\nimport { normalizeModelName } from './utils.ts';\n\ntype FindAllRequestInput<T extends string = string, RT = unknown[]> = StoreRequestInput & {\n  op: 'findAll';\n  data: {\n    type: T;\n    options: FindAllBuilderOptions;\n  };\n  [RequestSignature]?: RT;\n};\n\ntype FindAllBuilderOptions = FindAllOptions;\n\n/**\n  This function builds a request config to perform a `findAll` request for the given type.\n  When passed to `store.request`, this config will result in the same behavior as a `store.findAll` request.\n  Additionally, it takes the same options as `store.findAll`.\n\n  All `@warp-drive/legacy/compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.\n  This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.\n  To that end, these builders are deprecated and will be removed in a future version of WarpDrive.\n\n  @deprecated\n  @public\n  @param type the name of the resource\n  @param options optional, may include `adapterOptions` hash which will be passed to adapter.findAll\n  @return request config\n*/\nexport function findAllBuilder<T extends TypedRecordInstance>(\n  type: TypeFromInstance<T>,\n  options?: FindAllBuilderOptions\n): FindAllRequestInput<TypeFromInstance<T>, T[]>;\nexport function findAllBuilder(type: string, options?: FindAllBuilderOptions): FindAllRequestInput;\nexport function findAllBuilder(type: string, options: FindAllBuilderOptions = {}): FindAllRequestInput {\n  assert(`You need to pass a model name to the findAll builder`, type);\n  assert(\n    `Model name passed to the findAll builder must be a dasherized string instead of ${type}`,\n    typeof type === 'string'\n  );\n\n  return {\n    op: 'findAll',\n    data: {\n      type: normalizeModelName(type),\n      options: options || {},\n    },\n    cacheOptions: { [SkipCache]: true },\n  };\n}\n","import type { StoreRequestInput } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport { constructResource, ensureStringId } from '@warp-drive/core/store/-private';\nimport type { BaseFinderOptions, FindRecordOptions } from '@warp-drive/core/types';\nimport type { TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport { SkipCache } from '@warp-drive/core/types/request';\nimport type { ResourceIdentifierObject } from '@warp-drive/core/types/spec/json-api-raw';\nimport type { RequestSignature } from '@warp-drive/core/types/symbols';\n\nimport { isMaybeIdentifier, normalizeModelName } from './utils.ts';\n\ntype FindRecordRequestInput<T extends string = string, RT = unknown> = StoreRequestInput & {\n  op: 'findRecord';\n  data: {\n    record: ResourceIdentifierObject<T>;\n    options: FindRecordBuilderOptions;\n  };\n  [RequestSignature]?: RT;\n};\n\ntype FindRecordBuilderOptions = Omit<FindRecordOptions, 'preload'>;\n\n/**\n  This function builds a request config to find the record for a given identifier or type and id combination.\n  When passed to `store.request`, this config will result in the same behavior as a `store.findRecord` request.\n  Additionally, it takes the same options as `store.findRecord`, with the exception of `preload` (which is unsupported).\n\n  **Example 1**\n\n  ```ts\n  import { findRecord } from '@warp-drive/legacy/compat/builders';\n  const { content: post } = await store.request<Post>(findRecord<Post>('post', '1'));\n  ```\n\n  **Example 2**\n\n  `findRecord` can be called with a single identifier argument instead of the combination\n  of `type` (modelName) and `id` as separate arguments. You may recognize this combo as\n  the typical pairing from [JSON:API](https://jsonapi.org/format/#document-resource-object-identification)\n\n  ```ts\n  import { findRecord } from '@warp-drive/legacy/compat/builders';\n  const { content: post } = await store.request<Post>(findRecord<Post>({ type: 'post', id }));\n  ```\n\n  All `@warp-drive/legacy/compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.\n  This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.\n  To that end, these builders are deprecated and will be removed in a future version of Warp Drive.\n\n  @deprecated\n  @public\n  @param resource - either a string representing the name of the resource or a ResourceIdentifier object containing both the type (a string) and the id (a string) for the record or an lid (a string) of an existing record\n  @param id - optional object with options for the request only if the first param is a ResourceIdentifier, else the string id of the record to be retrieved\n  @param options - if the first param is a string this will be the optional options for the request. See examples for available options.\n  @return request config\n*/\nexport function findRecordBuilder<T extends TypedRecordInstance>(\n  type: TypeFromInstance<T>,\n  id: string,\n  options?: FindRecordBuilderOptions\n): FindRecordRequestInput<TypeFromInstance<T>, T>;\nexport function findRecordBuilder(type: string, id: string, options?: FindRecordBuilderOptions): FindRecordRequestInput;\nexport function findRecordBuilder<T extends TypedRecordInstance>(\n  resource: ResourceIdentifierObject<TypeFromInstance<T>>,\n  options?: FindRecordBuilderOptions\n): FindRecordRequestInput<TypeFromInstance<T>, T>;\nexport function findRecordBuilder(\n  resource: ResourceIdentifierObject,\n  options?: FindRecordBuilderOptions\n): FindRecordRequestInput;\nexport function findRecordBuilder(\n  resource: string | ResourceIdentifierObject,\n  idOrOptions?: string | FindRecordBuilderOptions,\n  options?: FindRecordBuilderOptions\n): FindRecordRequestInput {\n  assert(\n    `You need to pass a modelName or resource identifier as the first argument to the findRecord builder`,\n    resource\n  );\n  if (isMaybeIdentifier(resource)) {\n    options = idOrOptions as BaseFinderOptions | undefined;\n  } else {\n    assert(\n      `You need to pass a modelName or resource identifier as the first argument to the findRecord builder (passed ${resource})`,\n      typeof resource === 'string'\n    );\n    const type = normalizeModelName(resource);\n    const normalizedId = ensureStringId(idOrOptions as string | number);\n    resource = constructResource(type, normalizedId);\n  }\n\n  options = options || {};\n\n  assert('findRecord builder does not support options.preload', !(options as FindRecordOptions).preload);\n\n  return {\n    op: 'findRecord' as const,\n    data: {\n      record: resource,\n      options,\n    },\n    cacheOptions: { [SkipCache]: true },\n  };\n}\n","import type { StoreRequestInput } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport type { LegacyResourceQuery, QueryOptions } from '@warp-drive/core/types';\nimport type { TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport { SkipCache } from '@warp-drive/core/types/request';\nimport type { RequestSignature } from '@warp-drive/core/types/symbols';\n\nimport { normalizeModelName } from './utils.ts';\n\ntype QueryRequestInput<T extends string = string, RT = unknown[]> = StoreRequestInput & {\n  op: 'query';\n  data: {\n    type: T;\n    query: LegacyResourceQuery;\n    options: QueryBuilderOptions;\n  };\n  [RequestSignature]?: RT;\n};\n\ntype QueryBuilderOptions = QueryOptions;\n\n/**\n  This function builds a request config for a given type and query object.\n  When passed to `store.request`, this config will result in the same behavior as a `store.query` request.\n  Additionally, it takes the same options as `store.query`.\n\n  All `@warp-drive/legacy/compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.\n  This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.\n  To that end, these builders are deprecated and will be removed in a future version of WarpDrive.\n\n  @deprecated\n  @public\n  @param type the name of the resource\n  @param query a query to be used by the adapter\n  @param options optional, may include `adapterOptions` hash which will be passed to adapter.query\n  @return request config\n*/\nexport function queryBuilder<T extends TypedRecordInstance>(\n  type: TypeFromInstance<T>,\n  query: LegacyResourceQuery,\n  options?: QueryBuilderOptions\n): QueryRequestInput<TypeFromInstance<T>, T[]>;\nexport function queryBuilder(\n  type: string,\n  query: LegacyResourceQuery,\n  options?: QueryBuilderOptions\n): QueryRequestInput;\nexport function queryBuilder(\n  type: string,\n  query: LegacyResourceQuery,\n  options: QueryBuilderOptions = {}\n): QueryRequestInput {\n  assert(`You need to pass a model name to the query builder`, type);\n  assert(`You need to pass a query hash to the query builder`, query);\n  assert(\n    `Model name passed to the query builder must be a dasherized string instead of ${type}`,\n    typeof type === 'string'\n  );\n\n  return {\n    op: 'query' as const,\n    data: {\n      type: normalizeModelName(type),\n      query,\n      options: options,\n    },\n    cacheOptions: { [SkipCache]: true },\n  };\n}\n\ntype QueryRecordRequestInput<T extends string = string, RT = unknown> = StoreRequestInput & {\n  op: 'queryRecord';\n  data: {\n    type: T;\n    query: LegacyResourceQuery;\n    options: QueryBuilderOptions;\n  };\n  [RequestSignature]?: RT;\n};\n\n/**\n  This function builds a request config for a given type and query object.\n  When passed to `store.request`, this config will result in the same behavior as a `store.queryRecord` request.\n  Additionally, it takes the same options as `store.queryRecord`.\n\n  All `@warp-drive/legacy/compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.\n  This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.\n  To that end, these builders are deprecated and will be removed in a future version of WarpDrive.\n\n  @deprecated\n  @public\n  @param type the name of the resource\n  @param query a query to be used by the adapter\n  @param options optional, may include `adapterOptions` hash which will be passed to adapter.query\n  @return request config\n*/\nexport function queryRecordBuilder<T extends TypedRecordInstance>(\n  type: TypeFromInstance<T>,\n  query: LegacyResourceQuery,\n  options?: QueryBuilderOptions\n): QueryRecordRequestInput<TypeFromInstance<T>, T | null>;\nexport function queryRecordBuilder(\n  type: string,\n  query: LegacyResourceQuery,\n  options?: QueryBuilderOptions\n): QueryRecordRequestInput;\nexport function queryRecordBuilder(\n  type: string,\n  query: LegacyResourceQuery,\n  options?: QueryBuilderOptions\n): QueryRecordRequestInput {\n  assert(`You need to pass a model name to the queryRecord builder`, type);\n  assert(`You need to pass a query hash to the queryRecord builder`, query);\n  assert(\n    `Model name passed to the queryRecord builder must be a dasherized string instead of ${type}`,\n    typeof type === 'string'\n  );\n\n  return {\n    op: 'queryRecord',\n    data: {\n      type: normalizeModelName(type),\n      query,\n      options: options || {},\n    },\n    cacheOptions: { [SkipCache]: true },\n  };\n}\n","import { recordIdentifierFor, storeFor, type StoreRequestInput } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport { assertPrivateStore, type InstanceCache } from '@warp-drive/core/store/-private';\nimport type { ResourceKey } from '@warp-drive/core/types';\nimport type { Cache } from '@warp-drive/core/types/cache';\nimport type { TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport { SkipCache } from '@warp-drive/core/types/request';\nimport type { RequestSignature } from '@warp-drive/core/types/symbols';\n\ntype SaveRecordRequestInput<T extends string = string, RT = unknown> = StoreRequestInput & {\n  op: 'createRecord' | 'deleteRecord' | 'updateRecord';\n  data: {\n    record: ResourceKey<T>;\n    options: SaveRecordBuilderOptions;\n  };\n  records: [ResourceKey<T>];\n  [RequestSignature]?: RT;\n};\n\ntype SaveRecordBuilderOptions = Record<string, unknown>;\n\nfunction _resourceIsFullDeleted(identifier: ResourceKey, cache: Cache): boolean {\n  return cache.isDeletionCommitted(identifier) || (cache.isNew(identifier) && cache.isDeleted(identifier));\n}\n\nfunction resourceIsFullyDeleted(instanceCache: InstanceCache, identifier: ResourceKey): boolean {\n  const cache = instanceCache.cache;\n  return !cache || _resourceIsFullDeleted(identifier, cache);\n}\n\n/**\n  This function builds a request config for saving the given record (e.g. creating, updating, or deleting the record).\n  When passed to `store.request`, this config will result in the same behavior as a legacy `store.saveRecord` request.\n  Additionally, it takes the same options as `store.saveRecord`.\n\n  All `@ember-data/legacy-compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.\n  This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.\n  To that end, these builders are deprecated and will be removed in a future version of Ember Data.\n\n  @deprecated\n  @public\n  @param {Object} record a record to save\n  @param {SaveRecordBuilderOptions} options optional, may include `adapterOptions` hash which will be passed to adapter.saveRecord\n  @return {SaveRecordRequestInput} request config\n*/\nexport function saveRecordBuilder<T extends TypedRecordInstance>(\n  record: T,\n  options: Record<string, unknown> = {}\n): SaveRecordRequestInput<TypeFromInstance<T>, T> {\n  const store = storeFor(record, true);\n  assertPrivateStore(store);\n  assert(`Unable to initiate save for a record in a disconnected state`, store);\n  const identifier = recordIdentifierFor<T>(record);\n\n  if (!identifier) {\n    // this commonly means we're disconnected\n    // but just in case we throw here to prevent bad things.\n    throw new Error(`Record Is Disconnected`);\n  }\n  assert(\n    `Cannot initiate a save request for an unloaded record: ${identifier.lid}`,\n    store._instanceCache.recordIsLoaded(identifier)\n  );\n\n  if (resourceIsFullyDeleted(store._instanceCache, identifier)) {\n    throw new Error('cannot build saveRecord request for deleted record');\n  }\n\n  if (!options) {\n    options = {};\n  }\n  let operation: 'createRecord' | 'deleteRecord' | 'updateRecord' = 'updateRecord';\n\n  const cache = store.cache;\n  if (cache.isNew(identifier)) {\n    operation = 'createRecord';\n  } else if (cache.isDeleted(identifier)) {\n    operation = 'deleteRecord';\n  }\n\n  return {\n    op: operation,\n    data: {\n      options,\n      record: identifier,\n    },\n    records: [identifier],\n    cacheOptions: { [SkipCache]: true },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"builders.js","names":["SkipCache","normalizeModelName","macroCondition","getGlobalConfig","findAllBuilder","type","options","WarpDrive","env","DEBUG","test","Error","op","data","cacheOptions","constructResource","ensureStringId","SkipCache","isMaybeIdentifier","normalizeModelName","macroCondition","getGlobalConfig","findRecordBuilder","resource","idOrOptions","options","WarpDrive","env","DEBUG","test","Error","type","normalizedId","preload","op","data","record","cacheOptions","SkipCache","normalizeModelName","macroCondition","getGlobalConfig","queryBuilder","type","query","options","WarpDrive","env","DEBUG","test","Error","op","data","cacheOptions","queryRecordBuilder","recordIdentifierFor","storeFor","assertPrivateStore","SkipCache","macroCondition","getGlobalConfig","_resourceIsFullDeleted","identifier","cache","isDeletionCommitted","isNew","isDeleted","resourceIsFullyDeleted","instanceCache","saveRecordBuilder","record","options","store","WarpDrive","env","DEBUG","test","Error","lid","_instanceCache","recordIsLoaded","operation","op","data","records","cacheOptions"],"sources":["../../src/compat/builders/find-all.ts","../../src/compat/builders/find-record.ts","../../src/compat/builders/query.ts","../../src/compat/builders/save-record.ts"],"sourcesContent":["import type { StoreRequestInput } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport type { FindAllOptions } from '@warp-drive/core/types';\nimport type { TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport { SkipCache } from '@warp-drive/core/types/request';\nimport type { RequestSignature } from '@warp-drive/core/types/symbols';\n\nimport { normalizeModelName } from './utils.ts';\n\ntype FindAllRequestInput<T extends string = string, RT = unknown[]> = StoreRequestInput & {\n  op: 'findAll';\n  data: {\n    type: T;\n    options: FindAllBuilderOptions;\n  };\n  [RequestSignature]?: RT;\n};\n\ntype FindAllBuilderOptions = FindAllOptions;\n\n/**\n  This function builds a request config to perform a `findAll` request for the given type.\n  When passed to `store.request`, this config will result in the same behavior as a `store.findAll` request.\n  Additionally, it takes the same options as `store.findAll`.\n\n  All `@warp-drive/legacy/compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.\n  This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.\n  To that end, these builders are deprecated and will be removed in a future version of WarpDrive.\n\n  @summary Deprecated legacy builder for a `store.request` config that behaves like `store.findAll`, easing\n  migration off adapters and serializers.\n  @deprecated\n  @public\n  @param type the name of the resource\n  @param options optional, may include `adapterOptions` hash which will be passed to adapter.findAll\n  @return request config\n*/\nexport function findAllBuilder<T extends TypedRecordInstance>(\n  type: TypeFromInstance<T>,\n  options?: FindAllBuilderOptions\n): FindAllRequestInput<TypeFromInstance<T>, T[]>;\nexport function findAllBuilder(type: string, options?: FindAllBuilderOptions): FindAllRequestInput;\nexport function findAllBuilder(type: string, options: FindAllBuilderOptions = {}): FindAllRequestInput {\n  assert(`You need to pass a model name to the findAll builder`, type);\n  assert(\n    `Model name passed to the findAll builder must be a dasherized string instead of ${type}`,\n    typeof type === 'string'\n  );\n\n  return {\n    op: 'findAll',\n    data: {\n      type: normalizeModelName(type),\n      options: options || {},\n    },\n    cacheOptions: { [SkipCache]: true },\n  };\n}\n","import type { StoreRequestInput } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport { constructResource, ensureStringId } from '@warp-drive/core/store/-private';\nimport type { BaseFinderOptions, FindRecordOptions } from '@warp-drive/core/types';\nimport type { TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport { SkipCache } from '@warp-drive/core/types/request';\nimport type { ResourceIdentifierObject } from '@warp-drive/core/types/spec/json-api-raw';\nimport type { RequestSignature } from '@warp-drive/core/types/symbols';\n\nimport { isMaybeIdentifier, normalizeModelName } from './utils.ts';\n\ntype FindRecordRequestInput<T extends string = string, RT = unknown> = StoreRequestInput & {\n  op: 'findRecord';\n  data: {\n    record: ResourceIdentifierObject<T>;\n    options: FindRecordBuilderOptions;\n  };\n  [RequestSignature]?: RT;\n};\n\ntype FindRecordBuilderOptions = Omit<FindRecordOptions, 'preload'>;\n\n/**\n  This function builds a request config to find the record for a given identifier or type and id combination.\n  When passed to `store.request`, this config will result in the same behavior as a `store.findRecord` request.\n  Additionally, it takes the same options as `store.findRecord`, with the exception of `preload` (which is unsupported).\n\n  **Example 1**\n\n  ```ts\n  import { findRecord } from '@warp-drive/legacy/compat/builders';\n  const { content: post } = await store.request<Post>(findRecord<Post>('post', '1'));\n  ```\n\n  **Example 2**\n\n  `findRecord` can be called with a single identifier argument instead of the combination\n  of `type` (modelName) and `id` as separate arguments. You may recognize this combo as\n  the typical pairing from [JSON:API](https://jsonapi.org/format/#document-resource-object-identification)\n\n  ```ts\n  import { findRecord } from '@warp-drive/legacy/compat/builders';\n  const { content: post } = await store.request<Post>(findRecord<Post>({ type: 'post', id }));\n  ```\n\n  All `@warp-drive/legacy/compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.\n  This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.\n  To that end, these builders are deprecated and will be removed in a future version of Warp Drive.\n\n  @summary Deprecated legacy builder for a `store.request` config that behaves like `store.findRecord`, taking a\n  type and id or a resource identifier.\n  @deprecated\n  @public\n  @param resource - either a string representing the name of the resource or a ResourceIdentifier object containing both the type (a string) and the id (a string) for the record or an lid (a string) of an existing record\n  @param id - optional object with options for the request only if the first param is a ResourceIdentifier, else the string id of the record to be retrieved\n  @param options - if the first param is a string this will be the optional options for the request. See examples for available options.\n  @return request config\n*/\nexport function findRecordBuilder<T extends TypedRecordInstance>(\n  type: TypeFromInstance<T>,\n  id: string,\n  options?: FindRecordBuilderOptions\n): FindRecordRequestInput<TypeFromInstance<T>, T>;\nexport function findRecordBuilder(type: string, id: string, options?: FindRecordBuilderOptions): FindRecordRequestInput;\nexport function findRecordBuilder<T extends TypedRecordInstance>(\n  resource: ResourceIdentifierObject<TypeFromInstance<T>>,\n  options?: FindRecordBuilderOptions\n): FindRecordRequestInput<TypeFromInstance<T>, T>;\nexport function findRecordBuilder(\n  resource: ResourceIdentifierObject,\n  options?: FindRecordBuilderOptions\n): FindRecordRequestInput;\nexport function findRecordBuilder(\n  resource: string | ResourceIdentifierObject,\n  idOrOptions?: string | FindRecordBuilderOptions,\n  options?: FindRecordBuilderOptions\n): FindRecordRequestInput {\n  assert(\n    `You need to pass a modelName or resource identifier as the first argument to the findRecord builder`,\n    resource\n  );\n  if (isMaybeIdentifier(resource)) {\n    options = idOrOptions as BaseFinderOptions | undefined;\n  } else {\n    assert(\n      `You need to pass a modelName or resource identifier as the first argument to the findRecord builder (passed ${resource})`,\n      typeof resource === 'string'\n    );\n    const type = normalizeModelName(resource);\n    const normalizedId = ensureStringId(idOrOptions as string | number);\n    resource = constructResource(type, normalizedId);\n  }\n\n  options = options || {};\n\n  assert('findRecord builder does not support options.preload', !(options as FindRecordOptions).preload);\n\n  return {\n    op: 'findRecord' as const,\n    data: {\n      record: resource,\n      options,\n    },\n    cacheOptions: { [SkipCache]: true },\n  };\n}\n","import type { StoreRequestInput } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport type { LegacyResourceQuery, QueryOptions } from '@warp-drive/core/types';\nimport type { TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport { SkipCache } from '@warp-drive/core/types/request';\nimport type { RequestSignature } from '@warp-drive/core/types/symbols';\n\nimport { normalizeModelName } from './utils.ts';\n\ntype QueryRequestInput<T extends string = string, RT = unknown[]> = StoreRequestInput & {\n  op: 'query';\n  data: {\n    type: T;\n    query: LegacyResourceQuery;\n    options: QueryBuilderOptions;\n  };\n  [RequestSignature]?: RT;\n};\n\ntype QueryBuilderOptions = QueryOptions;\n\n/**\n  This function builds a request config for a given type and query object.\n  When passed to `store.request`, this config will result in the same behavior as a `store.query` request.\n  Additionally, it takes the same options as `store.query`.\n\n  All `@warp-drive/legacy/compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.\n  This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.\n  To that end, these builders are deprecated and will be removed in a future version of WarpDrive.\n\n  @summary Deprecated legacy builder for a `store.request` config that behaves like `store.query`, returning the\n  records matching a query object.\n  @deprecated\n  @public\n  @param type the name of the resource\n  @param query a query to be used by the adapter\n  @param options optional, may include `adapterOptions` hash which will be passed to adapter.query\n  @return request config\n*/\nexport function queryBuilder<T extends TypedRecordInstance>(\n  type: TypeFromInstance<T>,\n  query: LegacyResourceQuery,\n  options?: QueryBuilderOptions\n): QueryRequestInput<TypeFromInstance<T>, T[]>;\nexport function queryBuilder(\n  type: string,\n  query: LegacyResourceQuery,\n  options?: QueryBuilderOptions\n): QueryRequestInput;\nexport function queryBuilder(\n  type: string,\n  query: LegacyResourceQuery,\n  options: QueryBuilderOptions = {}\n): QueryRequestInput {\n  assert(`You need to pass a model name to the query builder`, type);\n  assert(`You need to pass a query hash to the query builder`, query);\n  assert(\n    `Model name passed to the query builder must be a dasherized string instead of ${type}`,\n    typeof type === 'string'\n  );\n\n  return {\n    op: 'query' as const,\n    data: {\n      type: normalizeModelName(type),\n      query,\n      options: options,\n    },\n    cacheOptions: { [SkipCache]: true },\n  };\n}\n\ntype QueryRecordRequestInput<T extends string = string, RT = unknown> = StoreRequestInput & {\n  op: 'queryRecord';\n  data: {\n    type: T;\n    query: LegacyResourceQuery;\n    options: QueryBuilderOptions;\n  };\n  [RequestSignature]?: RT;\n};\n\n/**\n  This function builds a request config for a given type and query object.\n  When passed to `store.request`, this config will result in the same behavior as a `store.queryRecord` request.\n  Additionally, it takes the same options as `store.queryRecord`.\n\n  All `@warp-drive/legacy/compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.\n  This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.\n  To that end, these builders are deprecated and will be removed in a future version of WarpDrive.\n\n  @summary Deprecated legacy builder for a `store.request` config that behaves like `store.queryRecord`, returning\n  a single record or `null` for a query object.\n  @deprecated\n  @public\n  @param type the name of the resource\n  @param query a query to be used by the adapter\n  @param options optional, may include `adapterOptions` hash which will be passed to adapter.query\n  @return request config\n*/\nexport function queryRecordBuilder<T extends TypedRecordInstance>(\n  type: TypeFromInstance<T>,\n  query: LegacyResourceQuery,\n  options?: QueryBuilderOptions\n): QueryRecordRequestInput<TypeFromInstance<T>, T | null>;\nexport function queryRecordBuilder(\n  type: string,\n  query: LegacyResourceQuery,\n  options?: QueryBuilderOptions\n): QueryRecordRequestInput;\nexport function queryRecordBuilder(\n  type: string,\n  query: LegacyResourceQuery,\n  options?: QueryBuilderOptions\n): QueryRecordRequestInput {\n  assert(`You need to pass a model name to the queryRecord builder`, type);\n  assert(`You need to pass a query hash to the queryRecord builder`, query);\n  assert(\n    `Model name passed to the queryRecord builder must be a dasherized string instead of ${type}`,\n    typeof type === 'string'\n  );\n\n  return {\n    op: 'queryRecord',\n    data: {\n      type: normalizeModelName(type),\n      query,\n      options: options || {},\n    },\n    cacheOptions: { [SkipCache]: true },\n  };\n}\n","import { recordIdentifierFor, storeFor, type StoreRequestInput } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport { assertPrivateStore, type InstanceCache } from '@warp-drive/core/store/-private';\nimport type { ResourceKey } from '@warp-drive/core/types';\nimport type { Cache } from '@warp-drive/core/types/cache';\nimport type { TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport { SkipCache } from '@warp-drive/core/types/request';\nimport type { RequestSignature } from '@warp-drive/core/types/symbols';\n\ntype SaveRecordRequestInput<T extends string = string, RT = unknown> = StoreRequestInput & {\n  op: 'createRecord' | 'deleteRecord' | 'updateRecord';\n  data: {\n    record: ResourceKey<T>;\n    options: SaveRecordBuilderOptions;\n  };\n  records: [ResourceKey<T>];\n  [RequestSignature]?: RT;\n};\n\ntype SaveRecordBuilderOptions = Record<string, unknown>;\n\nfunction _resourceIsFullDeleted(identifier: ResourceKey, cache: Cache): boolean {\n  return cache.isDeletionCommitted(identifier) || (cache.isNew(identifier) && cache.isDeleted(identifier));\n}\n\nfunction resourceIsFullyDeleted(instanceCache: InstanceCache, identifier: ResourceKey): boolean {\n  const cache = instanceCache.cache;\n  return !cache || _resourceIsFullDeleted(identifier, cache);\n}\n\n/**\n  This function builds a request config for saving the given record (e.g. creating, updating, or deleting the record).\n  When passed to `store.request`, this config will result in the same behavior as a legacy `store.saveRecord` request.\n  Additionally, it takes the same options as `store.saveRecord`.\n\n  All `@ember-data/legacy-compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.\n  This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.\n  To that end, these builders are deprecated and will be removed in a future version of Ember Data.\n\n  @summary Deprecated legacy builder for a `store.request` config that creates, updates, or deletes a record\n  through adapters, like the legacy `store.saveRecord`.\n  @deprecated\n  @public\n  @param {Object} record a record to save\n  @param {SaveRecordBuilderOptions} options optional, may include `adapterOptions` hash which will be passed to adapter.saveRecord\n  @return {SaveRecordRequestInput} request config\n*/\nexport function saveRecordBuilder<T extends TypedRecordInstance>(\n  record: T,\n  options: Record<string, unknown> = {}\n): SaveRecordRequestInput<TypeFromInstance<T>, T> {\n  const store = storeFor(record, true);\n  assertPrivateStore(store);\n  assert(`Unable to initiate save for a record in a disconnected state`, store);\n  const identifier = recordIdentifierFor<T>(record);\n\n  if (!identifier) {\n    // this commonly means we're disconnected\n    // but just in case we throw here to prevent bad things.\n    throw new Error(`Record Is Disconnected`);\n  }\n  assert(\n    `Cannot initiate a save request for an unloaded record: ${identifier.lid}`,\n    store._instanceCache.recordIsLoaded(identifier)\n  );\n\n  if (resourceIsFullyDeleted(store._instanceCache, identifier)) {\n    throw new Error('cannot build saveRecord request for deleted record');\n  }\n\n  if (!options) {\n    options = {};\n  }\n  let operation: 'createRecord' | 'deleteRecord' | 'updateRecord' = 'updateRecord';\n\n  const cache = store.cache;\n  if (cache.isNew(identifier)) {\n    operation = 'createRecord';\n  } else if (cache.isDeleted(identifier)) {\n    operation = 'deleteRecord';\n  }\n\n  return {\n    op: operation,\n    data: {\n      options,\n      record: identifier,\n    },\n    records: [identifier],\n    cacheOptions: { [SkipCache]: true },\n  };\n}\n"],"mappings":"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"}

package/dist/compat/extensions.d.ts

@@ -1,2 +1,2 @@
-import { a as WithArrayLike, i as EmberObjectExtension, n as EmberArrayLikeExtension, o as WithEmberObject, r as EmberObjectArrayExtension, t as ArrayType } from "../extensions-DumNm4dA.js";
+import { a as WithArrayLike, i as EmberObjectExtension, n as EmberArrayLikeExtension, o as WithEmberObject, r as EmberObjectArrayExtension, t as ArrayType } from "../extensions-fwdnX9n4.js";
 export { ArrayType, EmberArrayLikeExtension, EmberObjectArrayExtension, EmberObjectExtension, WithArrayLike, WithEmberObject };

package/dist/compat/extensions.js

@@ -4,6 +4,11 @@ import { addObserver, removeObserver } from "@ember/object/observers";
 import { compare } from "@ember/utils";
 
 //#region src/compat/extensions.ts
+/**
+* @module
+* @summary Legacy schema extensions that give reactive objects and arrays the classic `EmberObject` and Ember array
+* APIs, such as `get`, `set` and `mapBy`, plus matching types.
+*/
 const EmberObjectFeatures = {};
 [
 	"addObserver",
@@ -56,6 +61,9 @@ const EmberObjectFeatures = {};
 * `getProperties`, `setProperties`, `incrementProperty`, `decrementProperty`,
 * `toggleProperty`, `notifyPropertyChange`, `addObserver`, `removeObserver`)
 * to reactive array resources.
+*
+* @summary Legacy schema extension that gives reactive arrays the classic `EmberObject` API such as `get`, `set`,
+* and observers, to ease migration from Ember objects.
 */
 const EmberObjectArrayExtension = {
 	kind: "array",
@@ -67,6 +75,9 @@ const EmberObjectArrayExtension = {
 * `getProperties`, `setProperties`, `incrementProperty`, `decrementProperty`,
 * `toggleProperty`, `notifyPropertyChange`, `addObserver`, `removeObserver`)
 * to reactive object resources.
+*
+* @summary Legacy schema extension that gives reactive objects the classic `EmberObject` API such as `get`, `set`,
+* and observers, to ease migration from Ember objects.
 */
 const EmberObjectExtension = {
 	kind: "object",
@@ -259,6 +270,9 @@ const EmberArrayLikeFeatures = {
 * A schema extension that adds Ember's classic `MutableArray`/`Enumerable`
 * style methods (`pushObject`, `removeObject`, `mapBy`, `filterBy`,
 * `sortBy`, `firstObject`, `lastObject`, etc.) to reactive array resources.
+*
+* @summary Legacy schema extension that gives reactive arrays Ember array methods such as `pushObject`, `mapBy`,
+* `filterBy`, and `firstObject`.
 */
 const EmberArrayLikeExtension = {
 	kind: "array",
@@ -267,14 +281,22 @@ const EmberArrayLikeExtension = {
 };
 /**
 * Extracts the element type of an array type, or `never` if `T` is not an array.
+*
+* @summary Type utility resolving to the element type of an array type, or `never` for non-arrays.
 */
 /**
 * Adds the classic `EmberObject` API (as registered by {@link EmberObjectExtension}/
 * {@link EmberObjectArrayExtension}) to the type of a reactive resource.
+*
+* @summary Legacy type that adds the classic `EmberObject` methods to a reactive resource type using
+* `EmberObjectExtension` or `EmberObjectArrayExtension`.
 */
 /**
 * Adds Ember's classic array-like API (as registered by {@link EmberArrayLikeExtension})
 * to the type of a reactive array resource.
+*
+* @summary Legacy type that adds Ember array methods such as `mapBy` and `firstObject` to a reactive array type
+* using `EmberArrayLikeExtension`.
 */
 //#endregion
 export { EmberArrayLikeExtension, EmberObjectArrayExtension, EmberObjectExtension };

package/dist/compat/extensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.js","names":["get","getProperties","notifyPropertyChange","set","setProperties","addObserver","removeObserver","compare","macroCondition","getGlobalConfig","EmberObjectFeatures","EmberObjectMethods","forEach","method","delegatedMethod","args","Error","keyName","decrement","WarpDrive","env","DEBUG","test","isNaN","parseFloat","isFinite","increment","String","key","EmberObjectArrayExtension","kind","name","features","EmberObjectExtension","EmberArrayLikeFeatures","addObject","obj","index","indexOf","push","addObjects","objs","popObject","pop","pushObject","pushObjects","shiftObject","shift","unshiftObject","unshift","unshiftObjects","objectAt","arrIndex","Math","sign","length","objectsAt","indices","map","removeAt","splice","insertAt","removeObject","removeObjects","toArray","slice","replace","idx","amt","objects","clear","setObjects","Array","isArray","reverseObjects","reverse","compact","filter","v","undefined","any","callback","target","some","isAny","prop","value","hasValue","arguments","isEvery","every","getEach","mapBy","findBy","find","val","Boolean","filterBy","record","sortBy","sortKeys","sort","a","b","i","propA","propB","compareValue","invoke","addArrayObserver","removeArrayObserver","arrayContentWillChange","arrayContentDidChange","reject","apply","rejectBy","setEach","item","uniq","from","Set","uniqBy","seen","result","has","add","without","newArr","firstObject","at","lastObject","EmberArrayLikeExtension"],"sources":["../../src/compat/extensions.ts"],"sourcesContent":["import {\n  type default as EmberObject,\n  get,\n  getProperties,\n  notifyPropertyChange,\n  set,\n  setProperties,\n} from '@ember/object';\nimport { addObserver, removeObserver } from '@ember/object/observers';\nimport { compare } from '@ember/utils';\n\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport type { CAUTION_MEGA_DANGER_ZONE_Extension } from '@warp-drive/core/reactive';\n\nconst EmberObjectFeatures = {};\nconst EmberObjectMethods = [\n  'addObserver',\n  'cacheFor',\n  'decrementProperty',\n  'get',\n  'getProperties',\n  'incrementProperty',\n  'notifyPropertyChange',\n  'removeObserver',\n  'set',\n  'setProperties',\n  'toggleProperty',\n] as const;\nEmberObjectMethods.forEach((method) => {\n  EmberObjectFeatures[method] = function delegatedMethod(...args: unknown[]): unknown {\n    switch (method) {\n      case 'addObserver':\n        return (addObserver as (...args: unknown[]) => unknown)(this, ...args);\n      case 'cacheFor':\n        throw new Error('cacheFor has been removed and will not be replaced');\n      case 'decrementProperty': {\n        const keyName = args[0] as string;\n        const decrement = (args[1] as number) ?? 1;\n        assert(\n          'Must pass a numeric value to decrementProperty',\n          (typeof decrement === 'number' || !isNaN(parseFloat(decrement))) && isFinite(decrement)\n        );\n        return set(this, keyName, ((get(this, keyName) as number) || 0) - decrement);\n      }\n      case 'get':\n        // the cast is required: without it, TS resolves `get` to an overload whose\n        // parameter list isn't a rest/tuple, and the spread below fails to typecheck\n        // oxlint-disable-next-line typescript/no-unnecessary-type-assertion\n        return (get as (...args: unknown[]) => unknown)(this, ...args);\n      case 'getProperties':\n        return (getProperties as (...args: unknown[]) => unknown)(this, ...args);\n      case 'incrementProperty': {\n        const keyName = args[0] as string;\n        const increment = (args[1] as number) ?? 1;\n        assert(\n          'Must pass a numeric value to incrementProperty',\n          !isNaN(parseFloat(String(increment))) && isFinite(increment)\n        );\n        return set(this, keyName, (parseFloat(get(this, keyName) as string) || 0) + increment);\n      }\n      case 'notifyPropertyChange':\n        return (notifyPropertyChange as (...args: unknown[]) => unknown)(this, ...args);\n      case 'removeObserver':\n        return (removeObserver as (...args: unknown[]) => unknown)(this, ...args);\n      case 'set':\n        return (set as (...args: unknown[]) => unknown)(this, ...args);\n      case 'setProperties':\n        return (setProperties as (...args: unknown[]) => unknown)(this, ...args);\n      case 'toggleProperty': {\n        const key = args[0] as string;\n        return set(this, key, !get(this, key));\n      }\n    }\n  };\n});\n/**\n * A schema extension that adds the classic `EmberObject` API (`get`, `set`,\n * `getProperties`, `setProperties`, `incrementProperty`, `decrementProperty`,\n * `toggleProperty`, `notifyPropertyChange`, `addObserver`, `removeObserver`)\n * to reactive array resources.\n */\nexport const EmberObjectArrayExtension: CAUTION_MEGA_DANGER_ZONE_Extension = {\n  kind: 'array',\n  name: 'ember-object' as const,\n  features: EmberObjectFeatures,\n};\n/**\n * A schema extension that adds the classic `EmberObject` API (`get`, `set`,\n * `getProperties`, `setProperties`, `incrementProperty`, `decrementProperty`,\n * `toggleProperty`, `notifyPropertyChange`, `addObserver`, `removeObserver`)\n * to reactive object resources.\n */\nexport const EmberObjectExtension: CAUTION_MEGA_DANGER_ZONE_Extension = {\n  kind: 'object',\n  name: 'ember-object' as const,\n  features: EmberObjectFeatures,\n};\n\nconst EmberArrayLikeFeatures = {\n  addObject<T>(this: T[], obj: T): T[] {\n    const index = this.indexOf(obj);\n    if (index === -1) {\n      this.push(obj);\n    }\n    return this;\n  },\n\n  addObjects<T>(this: T[], objs: T[]): T[] {\n    objs.forEach((obj: T) => {\n      const index = this.indexOf(obj);\n      if (index === -1) {\n        this.push(obj);\n      }\n    });\n    return this;\n  },\n\n  popObject<T>(this: T[]): T | undefined {\n    return this.pop();\n  },\n\n  pushObject<T>(this: T[], obj: T): T {\n    this.push(obj);\n    return obj;\n  },\n\n  pushObjects<T>(this: T[], objs: T[]): T[] {\n    this.push(...objs);\n    return this;\n  },\n\n  shiftObject<T>(this: T[]): NonNullable<T> {\n    return this.shift()!;\n  },\n\n  unshiftObject<T>(this: T[], obj: T): T {\n    this.unshift(obj);\n    return obj;\n  },\n\n  unshiftObjects<T>(this: T[], objs: T[]): T[] {\n    this.unshift(...objs);\n    return this;\n  },\n\n  objectAt<T>(this: T[], index: number): T {\n    //For negative index values go back from the end of the array\n    const arrIndex = Math.sign(index) === -1 ? this.length + index : index;\n\n    return this[arrIndex];\n  },\n\n  objectsAt<T>(this: T[], indices: number[]): T[] {\n    // @ts-expect-error adding MutableArray method\n    // oxlint-disable-next-line typescript/no-unsafe-return, typescript/no-unsafe-call\n    return indices.map((index) => this.objectAt(index)!);\n  },\n\n  removeAt<T>(this: T[], index: number): T[] {\n    this.splice(index, 1);\n    return this;\n  },\n\n  insertAt<T>(this: T[], index: number, obj: T): T[] {\n    this.splice(index, 0, obj);\n    return this;\n  },\n\n  removeObject<T>(this: T[], obj: T): T[] {\n    const index = this.indexOf(obj);\n    if (index !== -1) {\n      this.splice(index, 1);\n    }\n    return this;\n  },\n\n  removeObjects<T>(this: T[], objs: T[]): T[] {\n    objs.forEach((obj) => {\n      const index = this.indexOf(obj);\n      if (index !== -1) {\n        this.splice(index, 1);\n      }\n    });\n    return this;\n  },\n\n  toArray<T>(this: T[]): T[] {\n    return this.slice();\n  },\n\n  replace<T>(this: T[], idx: number, amt: number, objects?: T[]): void {\n    if (objects) {\n      this.splice(idx, amt, ...objects);\n    } else {\n      this.splice(idx, amt);\n    }\n  },\n\n  clear<T>(this: T[]): T[] {\n    this.splice(0, this.length);\n    return this;\n  },\n\n  setObjects<T>(this: T[], objects: T[]): T[] {\n    assert(`setObjects expects to receive an array as its argument`, Array.isArray(objects));\n    this.splice(0, this.length);\n    this.push(...objects);\n    return this;\n  },\n\n  reverseObjects<T>(this: T[]): T[] {\n    this.reverse();\n    return this;\n  },\n\n  compact<T>(this: T[]): (T & {})[] {\n    return this.filter((v) => v !== null && v !== undefined);\n  },\n\n  any<T>(this: T[], callback: Parameters<Array<T>['some']>[0], target?: unknown): boolean {\n    return this.some(callback, target);\n  },\n\n  isAny<T>(this: T[], prop: string, value: unknown): boolean {\n    const hasValue = arguments.length === 2;\n    return (this as unknown as Array<Record<string, unknown>>).some((v) =>\n      hasValue ? v[prop] === value : v[prop] === true\n    );\n  },\n\n  isEvery<T>(this: T[], prop: string, value: unknown): boolean {\n    const hasValue = arguments.length === 2;\n    return (this as unknown as Array<Record<string, unknown>>).every((v) =>\n      hasValue ? v[prop] === value : v[prop] === true\n    );\n  },\n\n  getEach<T>(this: T[], key: string): unknown[] {\n    return this.map((value) => get(value, key));\n  },\n\n  mapBy<T>(this: T[], key: string): unknown[] {\n    return this.map((value) => get(value, key));\n  },\n\n  findBy<T>(this: T[], key: string, value?: unknown): T | undefined {\n    if (arguments.length === 2) {\n      return this.find((val) => {\n        return get(val, key) === value;\n      });\n    } else {\n      return this.find((val) => Boolean(get(val, key)));\n    }\n  },\n\n  filterBy<T>(this: T[], key: string, value?: unknown): T[] {\n    if (arguments.length === 2) {\n      return this.filter((record) => {\n        return get(record, key) === value;\n      });\n    }\n\n    return this.filter((record) => {\n      return Boolean(get(record, key));\n    });\n  },\n\n  sortBy<T>(this: T[], ...sortKeys: string[]): T[] {\n    return this.slice().sort((a, b) => {\n      for (let i = 0; i < sortKeys.length; i++) {\n        const key = sortKeys[i];\n\n        const propA = get(a, key);\n\n        const propB = get(b, key);\n        // return 1 or -1 else continue to the next sortKey\n        const compareValue = compare(propA, propB);\n\n        if (compareValue) {\n          return compareValue;\n        }\n      }\n      return 0;\n    });\n  },\n\n  invoke<T>(this: T[], key: string, ...args: unknown[]): unknown[] {\n    return (this as unknown as Array<Record<string, unknown>>).map((value) =>\n      (value[key] as (...args: unknown[]) => unknown)(...args)\n    );\n  },\n\n  addArrayObserver<T>(this: T[]): void {},\n\n  removeArrayObserver<T>(this: T[]): void {},\n\n  arrayContentWillChange<T>(this: T[]): void {},\n\n  arrayContentDidChange<T>(this: T[]): void {},\n\n  reject<T>(this: T[], callback: Parameters<Array<T>['filter']>[0], target?: unknown): T[] {\n    assert('`reject` expects a function as first argument.', typeof callback === 'function');\n\n    return this.filter((...args) => {\n      return !callback.apply(target, args);\n    });\n  },\n\n  rejectBy<T>(this: T[], key: string, value?: unknown): T[] {\n    if (arguments.length === 2) {\n      return this.filter((record) => {\n        return get(record, key) !== value;\n      });\n    }\n\n    return this.filter((record) => {\n      return !get(record, key);\n    });\n  },\n\n  setEach<T>(this: T[], key: string, value: unknown): void {\n    (this as unknown as Array<Record<string, unknown>>).forEach((item) => set(item, key, value));\n  },\n\n  uniq<T>(this: T[]): T[] {\n    return Array.from(new Set(this));\n  },\n\n  uniqBy<T>(this: T[], key: string): T[] {\n    const seen = new Set();\n    const result: T[] = [];\n    this.forEach((item) => {\n      const value = get(item, key);\n      if (seen.has(value)) {\n        return;\n      }\n      seen.add(value);\n      result.push(item);\n    });\n    return result;\n  },\n\n  without<T>(this: T[], value: T): T[] {\n    const newArr = this.slice();\n    const index = this.indexOf(value);\n    if (index !== -1) {\n      newArr.splice(index, 1);\n    }\n\n    return newArr;\n  },\n\n  get firstObject(): unknown {\n    return (this as unknown as unknown[]).at(0);\n  },\n\n  get lastObject(): unknown {\n    return (this as unknown as unknown[]).at(-1);\n  },\n};\n\n/**\n * A schema extension that adds Ember's classic `MutableArray`/`Enumerable`\n * style methods (`pushObject`, `removeObject`, `mapBy`, `filterBy`,\n * `sortBy`, `firstObject`, `lastObject`, etc.) to reactive array resources.\n */\nexport const EmberArrayLikeExtension: CAUTION_MEGA_DANGER_ZONE_Extension = {\n  kind: 'array',\n  name: 'ember-array-like' as const,\n  features: EmberArrayLikeFeatures,\n};\n\n/**\n * Extracts the element type of an array type, or `never` if `T` is not an array.\n */\nexport type ArrayType<T> = T extends ReadonlyArray<infer U> ? U : never;\n/**\n * Adds the classic `EmberObject` API (as registered by {@link EmberObjectExtension}/\n * {@link EmberObjectArrayExtension}) to the type of a reactive resource.\n */\nexport type WithEmberObject<T> = T & Pick<T & EmberObject, ArrayType<typeof EmberObjectMethods>>;\n\n/**\n * Adds Ember's classic array-like API (as registered by {@link EmberArrayLikeExtension})\n * to the type of a reactive array resource.\n */\nexport type WithArrayLike<T> =\n  T extends Array<infer U>\n    ? U &\n        Omit<typeof EmberArrayLikeFeatures, 'firstObject' | 'lastObject'> & {\n          /**\n           * the first member of the array, or `undefined` if the array is empty\n           */\n          firstObject: T | undefined;\n          /**\n           * the last member of the array, or `undefined` if the array is empty\n           */\n          lastObject: T | undefined;\n        }\n    : T[] &\n        Omit<typeof EmberArrayLikeFeatures, 'firstObject' | 'lastObject'> & {\n          /**\n           * the first member of the array, or `undefined` if the array is empty\n           */\n          firstObject: T | undefined;\n          /**\n           * the last member of the array, or `undefined` if the array is empty\n           */\n          lastObject: T | undefined;\n        };\n"],"mappings":"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"}
+{"version":3,"file":"extensions.js","names":["get","getProperties","notifyPropertyChange","set","setProperties","addObserver","removeObserver","compare","macroCondition","getGlobalConfig","EmberObjectFeatures","EmberObjectMethods","forEach","method","delegatedMethod","args","Error","keyName","decrement","WarpDrive","env","DEBUG","test","isNaN","parseFloat","isFinite","increment","String","key","EmberObjectArrayExtension","kind","name","features","EmberObjectExtension","EmberArrayLikeFeatures","addObject","obj","index","indexOf","push","addObjects","objs","popObject","pop","pushObject","pushObjects","shiftObject","shift","unshiftObject","unshift","unshiftObjects","objectAt","arrIndex","Math","sign","length","objectsAt","indices","map","removeAt","splice","insertAt","removeObject","removeObjects","toArray","slice","replace","idx","amt","objects","clear","setObjects","Array","isArray","reverseObjects","reverse","compact","filter","v","undefined","any","callback","target","some","isAny","prop","value","hasValue","arguments","isEvery","every","getEach","mapBy","findBy","find","val","Boolean","filterBy","record","sortBy","sortKeys","sort","a","b","i","propA","propB","compareValue","invoke","addArrayObserver","removeArrayObserver","arrayContentWillChange","arrayContentDidChange","reject","apply","rejectBy","setEach","item","uniq","from","Set","uniqBy","seen","result","has","add","without","newArr","firstObject","at","lastObject","EmberArrayLikeExtension"],"sources":["../../src/compat/extensions.ts"],"sourcesContent":["/**\n * @module\n * @summary Legacy schema extensions that give reactive objects and arrays the classic `EmberObject` and Ember array\n * APIs, such as `get`, `set` and `mapBy`, plus matching types.\n */\n\nimport {\n  type default as EmberObject,\n  get,\n  getProperties,\n  notifyPropertyChange,\n  set,\n  setProperties,\n} from '@ember/object';\nimport { addObserver, removeObserver } from '@ember/object/observers';\nimport { compare } from '@ember/utils';\n\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport type { CAUTION_MEGA_DANGER_ZONE_Extension } from '@warp-drive/core/reactive';\n\nconst EmberObjectFeatures = {};\nconst EmberObjectMethods = [\n  'addObserver',\n  'cacheFor',\n  'decrementProperty',\n  'get',\n  'getProperties',\n  'incrementProperty',\n  'notifyPropertyChange',\n  'removeObserver',\n  'set',\n  'setProperties',\n  'toggleProperty',\n] as const;\nEmberObjectMethods.forEach((method) => {\n  EmberObjectFeatures[method] = function delegatedMethod(...args: unknown[]): unknown {\n    switch (method) {\n      case 'addObserver':\n        return (addObserver as (...args: unknown[]) => unknown)(this, ...args);\n      case 'cacheFor':\n        throw new Error('cacheFor has been removed and will not be replaced');\n      case 'decrementProperty': {\n        const keyName = args[0] as string;\n        const decrement = (args[1] as number) ?? 1;\n        assert(\n          'Must pass a numeric value to decrementProperty',\n          (typeof decrement === 'number' || !isNaN(parseFloat(decrement))) && isFinite(decrement)\n        );\n        return set(this, keyName, ((get(this, keyName) as number) || 0) - decrement);\n      }\n      case 'get':\n        // the cast is required: without it, TS resolves `get` to an overload whose\n        // parameter list isn't a rest/tuple, and the spread below fails to typecheck\n        // oxlint-disable-next-line typescript/no-unnecessary-type-assertion\n        return (get as (...args: unknown[]) => unknown)(this, ...args);\n      case 'getProperties':\n        return (getProperties as (...args: unknown[]) => unknown)(this, ...args);\n      case 'incrementProperty': {\n        const keyName = args[0] as string;\n        const increment = (args[1] as number) ?? 1;\n        assert(\n          'Must pass a numeric value to incrementProperty',\n          !isNaN(parseFloat(String(increment))) && isFinite(increment)\n        );\n        return set(this, keyName, (parseFloat(get(this, keyName) as string) || 0) + increment);\n      }\n      case 'notifyPropertyChange':\n        return (notifyPropertyChange as (...args: unknown[]) => unknown)(this, ...args);\n      case 'removeObserver':\n        return (removeObserver as (...args: unknown[]) => unknown)(this, ...args);\n      case 'set':\n        return (set as (...args: unknown[]) => unknown)(this, ...args);\n      case 'setProperties':\n        return (setProperties as (...args: unknown[]) => unknown)(this, ...args);\n      case 'toggleProperty': {\n        const key = args[0] as string;\n        return set(this, key, !get(this, key));\n      }\n    }\n  };\n});\n/**\n * A schema extension that adds the classic `EmberObject` API (`get`, `set`,\n * `getProperties`, `setProperties`, `incrementProperty`, `decrementProperty`,\n * `toggleProperty`, `notifyPropertyChange`, `addObserver`, `removeObserver`)\n * to reactive array resources.\n *\n * @summary Legacy schema extension that gives reactive arrays the classic `EmberObject` API such as `get`, `set`,\n * and observers, to ease migration from Ember objects.\n */\nexport const EmberObjectArrayExtension: CAUTION_MEGA_DANGER_ZONE_Extension = {\n  kind: 'array',\n  name: 'ember-object' as const,\n  features: EmberObjectFeatures,\n};\n/**\n * A schema extension that adds the classic `EmberObject` API (`get`, `set`,\n * `getProperties`, `setProperties`, `incrementProperty`, `decrementProperty`,\n * `toggleProperty`, `notifyPropertyChange`, `addObserver`, `removeObserver`)\n * to reactive object resources.\n *\n * @summary Legacy schema extension that gives reactive objects the classic `EmberObject` API such as `get`, `set`,\n * and observers, to ease migration from Ember objects.\n */\nexport const EmberObjectExtension: CAUTION_MEGA_DANGER_ZONE_Extension = {\n  kind: 'object',\n  name: 'ember-object' as const,\n  features: EmberObjectFeatures,\n};\n\nconst EmberArrayLikeFeatures = {\n  addObject<T>(this: T[], obj: T): T[] {\n    const index = this.indexOf(obj);\n    if (index === -1) {\n      this.push(obj);\n    }\n    return this;\n  },\n\n  addObjects<T>(this: T[], objs: T[]): T[] {\n    objs.forEach((obj: T) => {\n      const index = this.indexOf(obj);\n      if (index === -1) {\n        this.push(obj);\n      }\n    });\n    return this;\n  },\n\n  popObject<T>(this: T[]): T | undefined {\n    return this.pop();\n  },\n\n  pushObject<T>(this: T[], obj: T): T {\n    this.push(obj);\n    return obj;\n  },\n\n  pushObjects<T>(this: T[], objs: T[]): T[] {\n    this.push(...objs);\n    return this;\n  },\n\n  shiftObject<T>(this: T[]): NonNullable<T> {\n    return this.shift()!;\n  },\n\n  unshiftObject<T>(this: T[], obj: T): T {\n    this.unshift(obj);\n    return obj;\n  },\n\n  unshiftObjects<T>(this: T[], objs: T[]): T[] {\n    this.unshift(...objs);\n    return this;\n  },\n\n  objectAt<T>(this: T[], index: number): T {\n    //For negative index values go back from the end of the array\n    const arrIndex = Math.sign(index) === -1 ? this.length + index : index;\n\n    return this[arrIndex];\n  },\n\n  objectsAt<T>(this: T[], indices: number[]): T[] {\n    // @ts-expect-error adding MutableArray method\n    // oxlint-disable-next-line typescript/no-unsafe-return, typescript/no-unsafe-call\n    return indices.map((index) => this.objectAt(index)!);\n  },\n\n  removeAt<T>(this: T[], index: number): T[] {\n    this.splice(index, 1);\n    return this;\n  },\n\n  insertAt<T>(this: T[], index: number, obj: T): T[] {\n    this.splice(index, 0, obj);\n    return this;\n  },\n\n  removeObject<T>(this: T[], obj: T): T[] {\n    const index = this.indexOf(obj);\n    if (index !== -1) {\n      this.splice(index, 1);\n    }\n    return this;\n  },\n\n  removeObjects<T>(this: T[], objs: T[]): T[] {\n    objs.forEach((obj) => {\n      const index = this.indexOf(obj);\n      if (index !== -1) {\n        this.splice(index, 1);\n      }\n    });\n    return this;\n  },\n\n  toArray<T>(this: T[]): T[] {\n    return this.slice();\n  },\n\n  replace<T>(this: T[], idx: number, amt: number, objects?: T[]): void {\n    if (objects) {\n      this.splice(idx, amt, ...objects);\n    } else {\n      this.splice(idx, amt);\n    }\n  },\n\n  clear<T>(this: T[]): T[] {\n    this.splice(0, this.length);\n    return this;\n  },\n\n  setObjects<T>(this: T[], objects: T[]): T[] {\n    assert(`setObjects expects to receive an array as its argument`, Array.isArray(objects));\n    this.splice(0, this.length);\n    this.push(...objects);\n    return this;\n  },\n\n  reverseObjects<T>(this: T[]): T[] {\n    this.reverse();\n    return this;\n  },\n\n  compact<T>(this: T[]): (T & {})[] {\n    return this.filter((v) => v !== null && v !== undefined);\n  },\n\n  any<T>(this: T[], callback: Parameters<Array<T>['some']>[0], target?: unknown): boolean {\n    return this.some(callback, target);\n  },\n\n  isAny<T>(this: T[], prop: string, value: unknown): boolean {\n    const hasValue = arguments.length === 2;\n    return (this as unknown as Array<Record<string, unknown>>).some((v) =>\n      hasValue ? v[prop] === value : v[prop] === true\n    );\n  },\n\n  isEvery<T>(this: T[], prop: string, value: unknown): boolean {\n    const hasValue = arguments.length === 2;\n    return (this as unknown as Array<Record<string, unknown>>).every((v) =>\n      hasValue ? v[prop] === value : v[prop] === true\n    );\n  },\n\n  getEach<T>(this: T[], key: string): unknown[] {\n    return this.map((value) => get(value, key));\n  },\n\n  mapBy<T>(this: T[], key: string): unknown[] {\n    return this.map((value) => get(value, key));\n  },\n\n  findBy<T>(this: T[], key: string, value?: unknown): T | undefined {\n    if (arguments.length === 2) {\n      return this.find((val) => {\n        return get(val, key) === value;\n      });\n    } else {\n      return this.find((val) => Boolean(get(val, key)));\n    }\n  },\n\n  filterBy<T>(this: T[], key: string, value?: unknown): T[] {\n    if (arguments.length === 2) {\n      return this.filter((record) => {\n        return get(record, key) === value;\n      });\n    }\n\n    return this.filter((record) => {\n      return Boolean(get(record, key));\n    });\n  },\n\n  sortBy<T>(this: T[], ...sortKeys: string[]): T[] {\n    return this.slice().sort((a, b) => {\n      for (let i = 0; i < sortKeys.length; i++) {\n        const key = sortKeys[i];\n\n        const propA = get(a, key);\n\n        const propB = get(b, key);\n        // return 1 or -1 else continue to the next sortKey\n        const compareValue = compare(propA, propB);\n\n        if (compareValue) {\n          return compareValue;\n        }\n      }\n      return 0;\n    });\n  },\n\n  invoke<T>(this: T[], key: string, ...args: unknown[]): unknown[] {\n    return (this as unknown as Array<Record<string, unknown>>).map((value) =>\n      (value[key] as (...args: unknown[]) => unknown)(...args)\n    );\n  },\n\n  addArrayObserver<T>(this: T[]): void {},\n\n  removeArrayObserver<T>(this: T[]): void {},\n\n  arrayContentWillChange<T>(this: T[]): void {},\n\n  arrayContentDidChange<T>(this: T[]): void {},\n\n  reject<T>(this: T[], callback: Parameters<Array<T>['filter']>[0], target?: unknown): T[] {\n    assert('`reject` expects a function as first argument.', typeof callback === 'function');\n\n    return this.filter((...args) => {\n      return !callback.apply(target, args);\n    });\n  },\n\n  rejectBy<T>(this: T[], key: string, value?: unknown): T[] {\n    if (arguments.length === 2) {\n      return this.filter((record) => {\n        return get(record, key) !== value;\n      });\n    }\n\n    return this.filter((record) => {\n      return !get(record, key);\n    });\n  },\n\n  setEach<T>(this: T[], key: string, value: unknown): void {\n    (this as unknown as Array<Record<string, unknown>>).forEach((item) => set(item, key, value));\n  },\n\n  uniq<T>(this: T[]): T[] {\n    return Array.from(new Set(this));\n  },\n\n  uniqBy<T>(this: T[], key: string): T[] {\n    const seen = new Set();\n    const result: T[] = [];\n    this.forEach((item) => {\n      const value = get(item, key);\n      if (seen.has(value)) {\n        return;\n      }\n      seen.add(value);\n      result.push(item);\n    });\n    return result;\n  },\n\n  without<T>(this: T[], value: T): T[] {\n    const newArr = this.slice();\n    const index = this.indexOf(value);\n    if (index !== -1) {\n      newArr.splice(index, 1);\n    }\n\n    return newArr;\n  },\n\n  get firstObject(): unknown {\n    return (this as unknown as unknown[]).at(0);\n  },\n\n  get lastObject(): unknown {\n    return (this as unknown as unknown[]).at(-1);\n  },\n};\n\n/**\n * A schema extension that adds Ember's classic `MutableArray`/`Enumerable`\n * style methods (`pushObject`, `removeObject`, `mapBy`, `filterBy`,\n * `sortBy`, `firstObject`, `lastObject`, etc.) to reactive array resources.\n *\n * @summary Legacy schema extension that gives reactive arrays Ember array methods such as `pushObject`, `mapBy`,\n * `filterBy`, and `firstObject`.\n */\nexport const EmberArrayLikeExtension: CAUTION_MEGA_DANGER_ZONE_Extension = {\n  kind: 'array',\n  name: 'ember-array-like' as const,\n  features: EmberArrayLikeFeatures,\n};\n\n/**\n * Extracts the element type of an array type, or `never` if `T` is not an array.\n *\n * @summary Type utility resolving to the element type of an array type, or `never` for non-arrays.\n */\nexport type ArrayType<T> = T extends ReadonlyArray<infer U> ? U : never;\n/**\n * Adds the classic `EmberObject` API (as registered by {@link EmberObjectExtension}/\n * {@link EmberObjectArrayExtension}) to the type of a reactive resource.\n *\n * @summary Legacy type that adds the classic `EmberObject` methods to a reactive resource type using\n * `EmberObjectExtension` or `EmberObjectArrayExtension`.\n */\nexport type WithEmberObject<T> = T & Pick<T & EmberObject, ArrayType<typeof EmberObjectMethods>>;\n\n/**\n * Adds Ember's classic array-like API (as registered by {@link EmberArrayLikeExtension})\n * to the type of a reactive array resource.\n *\n * @summary Legacy type that adds Ember array methods such as `mapBy` and `firstObject` to a reactive array type\n * using `EmberArrayLikeExtension`.\n */\nexport type WithArrayLike<T> =\n  T extends Array<infer U>\n    ? U &\n        Omit<typeof EmberArrayLikeFeatures, 'firstObject' | 'lastObject'> & {\n          /**\n           * the first member of the array, or `undefined` if the array is empty\n           */\n          firstObject: T | undefined;\n          /**\n           * the last member of the array, or `undefined` if the array is empty\n           */\n          lastObject: T | undefined;\n        }\n    : T[] &\n        Omit<typeof EmberArrayLikeFeatures, 'firstObject' | 'lastObject'> & {\n          /**\n           * the first member of the array, or `undefined` if the array is empty\n           */\n          firstObject: T | undefined;\n          /**\n           * the last member of the array, or `undefined` if the array is empty\n           */\n          lastObject: T | undefined;\n        };\n"],"mappings":"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"}

package/dist/compat/utils.d.ts

@@ -5,6 +5,8 @@ type Reporter = (type: "formatted-id" | "formatted-type", actual: unknown, expec
  * changes during normalization. This is useful for instrumenting
  * to discover places where usage in the app is not consistent.
  *
+ * @summary Legacy migration helper that registers a callback invoked whenever `formattedId` or `formattedType`
+ * has to change the id or type it was given.
  * @param fn - a function which takes a mismatch-type ('formatted-id' | 'formatted-type'), actual, and expected value
  * @public
  */
@@ -14,6 +16,8 @@ export declare function configureMismatchReporter(fn: Reporter): void;
  * fails validation. This is useful for instrumenting
  * to discover places where usage in the app is not consistent.
  *
+ * @summary Legacy migration helper that registers a callback invoked when an id or type passed to these utilities
+ * fails validation.
  * @param fn - a function which takes a message and a condition
  * @public
  */
@@ -28,6 +32,8 @@ export declare function configureAssertFn(fn: (message: string, condition: unkno
  * the configured mismatch reporter and assert functions will
  * be called.
  *
+ * @summary Legacy migration helper that replaces the singularize-and-dasherize function `formattedType` and
+ * `isEquivType` use to normalize resource types.
  * @param fn - a function which takes a string and returns a string
  * @public
  */
@@ -57,6 +63,8 @@ export declare function configureTypeNormalization(fn: (type: string) => string)
  * formattedType('PostComment'); // => 'post-comment'
  * ```
  *
+ * @summary Legacy migration helper that normalizes a resource type to the singular dasherized form the cache
+ * expects, such as `'PostComments'` to `'post-comment'`.
  * @param type the potentially un-normalized type
  * @return the normalized type
  * @public
@@ -78,6 +86,8 @@ export declare function formattedType<T extends string>(type: T | string): T;
  * formattedId(null); // => null
  *	```
  *
+ * @summary Legacy migration helper that normalizes a resource id to the `string` or `null` the cache expects,
+ * asserting on invalid ids such as `''` or `0`.
  * @param id the potentially un-normalized id
  * @return the normalized id
  * @public
@@ -89,6 +99,8 @@ export declare function formattedId(id: string | number | null): string | null;
  * Like {@link formattedId}, but asserts that `id` is not `null` rather
  * than allowing and passing through `null`.
  *
+ * @summary Legacy migration helper that normalizes a resource id to a string like `formattedId`, but asserts that
+ * it is not `null`.
  * @public
  */
 export declare function expectId(id: string | number): string;
@@ -118,6 +130,8 @@ export declare function expectId(id: null): never;
  * isEquivType('posts', null); // false
  * ```
  *
+ * @summary Legacy migration helper that reports whether two resource types match after normalization, so
+ * `'posts'` and `'post'` are equivalent.
  * @param expected a potentially unnormalized type to match against
  * @param actual a potentially unnormalized type to match against
  * @return true if the types are equivalent
@@ -140,6 +154,8 @@ export declare function isEquivType(expected: string, actual: string): boolean;
  * isEquivId(1, null); // false
  * ```
  *
+ * @summary Legacy migration helper that reports whether two resource ids match after normalization, so `1` and
+ * `'1'` are equivalent.
  * @param expected a potentially un-normalized id to match against
  * @param actual a potentially un-normalized id to match against
  * @return true if the ids are equivalent

package/dist/compat/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","names":[],"sources":["../../src/compat/utils.ts"],"mappings":";KAcK,YAAY,yCAAyC,iBAAiB;;;;;;;;;wBA0B3D,0BAA0B,IAAI;;;;;;;;;wBAY9B,kBAAkB,KAAK,iBAAiB;;;;;;;;;;;;;;wBAiBxC,2BAA2B,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAmChC,cAAc,kBAAkB,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;wBAuCnD,YAAY;wBACZ,YAAY;wBACZ,YAAY;;;;;;;wBA0BZ,SAAS;;;;;;wBAMT,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;wBAgCT,YAAY,kBAAkB;;;;;;;;;;;;;;;;;;;;;;wBAmC9B,UAAU,2BAA2B"}
+{"version":3,"file":"utils.d.ts","names":[],"sources":["../../src/compat/utils.ts"],"mappings":";KAgBK,YAAY,yCAAyC,iBAAiB;;;;;;;;;;;wBA4B3D,0BAA0B,IAAI;;;;;;;;;;;wBAc9B,kBAAkB,KAAK,iBAAiB;;;;;;;;;;;;;;;;wBAmBxC,2BAA2B,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqChC,cAAc,kBAAkB,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;wBAyCnD,YAAY;wBACZ,YAAY;wBACZ,YAAY;;;;;;;;;wBA4BZ,SAAS;;;;;;wBAMT,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAkCT,YAAY,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;wBAqC9B,UAAU,2BAA2B"}

package/dist/compat/utils.js

@@ -6,6 +6,8 @@ import { dasherize, singularize } from "@warp-drive/utilities/string";
 Utilities for helping to migrate to stricter
 and more consistent use of IDs and types.
 
+@summary Legacy helpers that normalize, compare, and report mismatched resource ids and types while migrating to
+stricter formats.
 @module
 */
 let MismatchReporter = function() {};
@@ -24,6 +26,8 @@ let NormalizedType = (str) => {
 * changes during normalization. This is useful for instrumenting
 * to discover places where usage in the app is not consistent.
 *
+* @summary Legacy migration helper that registers a callback invoked whenever `formattedId` or `formattedType`
+* has to change the id or type it was given.
 * @param fn - a function which takes a mismatch-type ('formatted-id' | 'formatted-type'), actual, and expected value
 * @public
 */
@@ -35,6 +39,8 @@ function configureMismatchReporter(fn) {
 * fails validation. This is useful for instrumenting
 * to discover places where usage in the app is not consistent.
 *
+* @summary Legacy migration helper that registers a callback invoked when an id or type passed to these utilities
+* fails validation.
 * @param fn - a function which takes a message and a condition
 * @public
 */
@@ -51,6 +57,8 @@ function configureAssertFn(fn) {
 * the configured mismatch reporter and assert functions will
 * be called.
 *
+* @summary Legacy migration helper that replaces the singularize-and-dasherize function `formattedType` and
+* `isEquivType` use to normalize resource types.
 * @param fn - a function which takes a string and returns a string
 * @public
 */
@@ -83,6 +91,8 @@ const NORMALIZED_TYPES = /* @__PURE__ */ new Map();
 * formattedType('PostComment'); // => 'post-comment'
 * ```
 *
+* @summary Legacy migration helper that normalizes a resource type to the singular dasherized form the cache
+* expects, such as `'PostComments'` to `'post-comment'`.
 * @param type the potentially un-normalized type
 * @return the normalized type
 * @public
@@ -116,6 +126,8 @@ function formattedType(type) {
 * formattedId(null); // => null
 *	```
 *
+* @summary Legacy migration helper that normalizes a resource id to the `string` or `null` the cache expects,
+* asserting on invalid ids such as `''` or `0`.
 * @param id the potentially un-normalized id
 * @return the normalized id
 * @public
@@ -133,6 +145,8 @@ function formattedId(id) {
 * Like {@link formattedId}, but asserts that `id` is not `null` rather
 * than allowing and passing through `null`.
 *
+* @summary Legacy migration helper that normalizes a resource id to a string like `formattedId`, but asserts that
+* it is not `null`.
 * @public
 */
 /**
@@ -164,6 +178,8 @@ function expectId(id) {
 * isEquivType('posts', null); // false
 * ```
 *
+* @summary Legacy migration helper that reports whether two resource types match after normalization, so
+* `'posts'` and `'post'` are equivalent.
 * @param expected a potentially unnormalized type to match against
 * @param actual a potentially unnormalized type to match against
 * @return true if the types are equivalent
@@ -196,6 +212,8 @@ function isEquivType(expected, actual) {
 * isEquivId(1, null); // false
 * ```
 *
+* @summary Legacy migration helper that reports whether two resource ids match after normalization, so `1` and
+* `'1'` are equivalent.
 * @param expected a potentially un-normalized id to match against
 * @param actual a potentially un-normalized id to match against
 * @return true if the ids are equivalent