@warp-drive/legacy 5.10.0-alpha.2 → 5.10.0-alpha.21

package/dist/unpkg/dev-deprecated/compat/builders.js

@@ -1,9 +1,9 @@
-import { n as normalizeModelName, t as isMaybeIdentifier } from "../utils-DQkMqhDv.js";
+import { n as normalizeModelName, t as isMaybeIdentifier } from "../utils-DyGjRZ14.js";
 import { recordIdentifierFor, storeFor } from "@warp-drive/core";
 import { assertPrivateStore, constructResource, ensureStringId } from "@warp-drive/core/store/-private";
 import { SkipCache } from "@warp-drive/core/types/request";
 
-//#region src/compat/builders/find-all.ts
+// src/compat/builders/find-all.ts
 /**
 This function builds a request config to perform a `findAll` request for the given type.
 When passed to `store.request`, this config will result in the same behavior as a `store.findAll` request.
@@ -13,6 +13,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
@@ -36,8 +38,7 @@ function findAllBuilder(type, options = {}) {
 	};
 }
 
-//#endregion
-//#region src/compat/builders/find-record.ts
+// src/compat/builders/find-record.ts
 /**
 This function builds a request config to find the record for a given identifier or type and id combination.
 When passed to `store.request`, this config will result in the same behavior as a `store.findRecord` request.
@@ -65,6 +66,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
@@ -99,8 +102,7 @@ function findRecordBuilder(resource, idOrOptions, options) {
 	};
 }
 
-//#endregion
-//#region src/compat/builders/query.ts
+// src/compat/builders/query.ts
 /**
 This function builds a request config for a given type and query object.
 When passed to `store.request`, this config will result in the same behavior as a `store.query` request.
@@ -110,6 +112,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
@@ -146,6 +150,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
@@ -174,8 +180,7 @@ function queryRecordBuilder(type, query, options) {
 	};
 }
 
-//#endregion
-//#region src/compat/builders/save-record.ts
+// src/compat/builders/save-record.ts
 function _resourceIsFullDeleted(identifier, cache) {
 	return cache.isDeletionCommitted(identifier) || cache.isNew(identifier) && cache.isDeleted(identifier);
 }
@@ -192,6 +197,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
@@ -226,6 +233,5 @@ function saveRecordBuilder(record, options = {}) {
 	};
 }
 
-//#endregion
 export { findAllBuilder as findAll, findRecordBuilder as findRecord, queryBuilder as query, queryRecordBuilder as queryRecord, saveRecordBuilder as saveRecord };
 //# sourceMappingURL=builders.js.map

package/dist/unpkg/dev-deprecated/compat/builders.js.map

@@ -1 +1 @@
-{"version":3,"file":"builders.js","names":["SkipCache","normalizeModelName","findAllBuilder","type","options","test","Error","op","data","cacheOptions","constructResource","ensureStringId","SkipCache","isMaybeIdentifier","normalizeModelName","findRecordBuilder","resource","idOrOptions","options","test","Error","type","normalizedId","preload","op","data","record","cacheOptions","SkipCache","normalizeModelName","queryBuilder","type","query","options","test","Error","op","data","cacheOptions","queryRecordBuilder","recordIdentifierFor","storeFor","assertPrivateStore","SkipCache","_resourceIsFullDeleted","identifier","cache","isDeletionCommitted","isNew","isDeleted","resourceIsFullyDeleted","instanceCache","saveRecordBuilder","record","options","store","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","findAllBuilder","type","options","test","Error","op","data","cacheOptions","constructResource","ensureStringId","SkipCache","isMaybeIdentifier","normalizeModelName","findRecordBuilder","resource","idOrOptions","options","test","Error","type","normalizedId","preload","op","data","record","cacheOptions","SkipCache","normalizeModelName","queryBuilder","type","query","options","test","Error","op","data","cacheOptions","queryRecordBuilder","recordIdentifierFor","storeFor","assertPrivateStore","SkipCache","_resourceIsFullDeleted","identifier","cache","isDeletionCommitted","isNew","isDeleted","resourceIsFullyDeleted","instanceCache","saveRecordBuilder","record","options","store","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":";;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgBE,eAAeC,MAAcC,UAAiC,CAAC,GAAwB;CACrG,EAAAC,SAAA;EAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MAAO,sDAAsD;CAAA,EAAA,CAAEH,IAAI;CACnE,EAAAE,SAAA;EAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MACE,mFAAmFH,MAAM;CAAA,EAAA,CACzF,OAAOA,SAAS,QAAQ;CAG1B,OAAO;EACLI,IAAI;EACJC,MAAM;GACJL,MAAMF,mBAAmBE,IAAI;GAC7BC,SAASA,WAAW,CAAC;EACvB;EACAK,cAAc,GAAGT,YAAY,KAAK;CACpC;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACeA,SAAgBe,kBACdC,UACAC,aACAC,SACwB;CACxB,EAAAC,SAAA;EAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MACE,qGAAqG;CAAA,EAAA,CACrGJ,QAAQ;CAEV,IAAIH,kBAAkBG,QAAQ,GAC5BE,UAAUD;MACL;EACL,EAAAE,SAAA;GAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MACE,+GAA+GJ,SAAQ,EAAG;EAAA,EAAA,CAC1H,OAAOA,aAAa,QAAQ;EAE9B,MAAMK,OAAOP,mBAAmBE,QAAQ;EACxC,MAAMM,eAAeX,eAAeM,WAA8B;EAClED,WAAWN,kBAAkBW,MAAMC,YAAY;CACjD;CAEAJ,UAAUA,WAAW,CAAC;CAEtB,EAAAC,SAAA;EAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MAAO,qDAAqD;CAAA,EAAA,CAAE,CAAEF,QAA8BK,OAAO;CAErG,OAAO;EACLC,IAAI;EACJC,MAAM;GACJC,QAAQV;GACRE;EACF;EACAS,cAAc,GAAGf,YAAY,KAAK;CACpC;AACF;;;;;;;;;;;;;;;;;;;;;ACxDA,SAAgBkB,aACdC,MACAC,OACAC,UAA+B,CAAC,GACb;CACnB,EAAAC,SAAA;EAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MAAO,oDAAoD;CAAA,EAAA,CAAEJ,IAAI;CACjE,EAAAG,SAAA;EAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MAAO,oDAAoD;CAAA,EAAA,CAAEH,KAAK;CAClE,EAAAE,SAAA;EAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MACE,iFAAiFJ,MAAM;CAAA,EAAA,CACvF,OAAOA,SAAS,QAAQ;CAG1B,OAAO;EACLK,IAAI;EACJC,MAAM;GACJN,MAAMF,mBAAmBE,IAAI;GAC7BC;GACSC;EACX;EACAK,cAAc,GAAGV,YAAY,KAAK;CACpC;AACF;;;;;;;;;;;;;;;;;;;AAwCA,SAAgBW,mBACdR,MACAC,OACAC,SACyB;CACzB,EAAAC,SAAA;EAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MAAO,0DAA0D;CAAA,EAAA,CAAEJ,IAAI;CACvE,EAAAG,SAAA;EAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MAAO,0DAA0D;CAAA,EAAA,CAAEH,KAAK;CACxE,EAAAE,SAAA;EAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MACE,uFAAuFJ,MAAM;CAAA,EAAA,CAC7F,OAAOA,SAAS,QAAQ;CAG1B,OAAO;EACLK,IAAI;EACJC,MAAM;GACJN,MAAMF,mBAAmBE,IAAI;GAC7BC;GACAC,SAASA,WAAW,CAAC;EACvB;EACAK,cAAc,GAAGV,YAAY,KAAK;CACpC;AACF;;;AC9GA,SAASgB,uBAAuBC,YAAyBC,OAAuB;CAC9E,OAAOA,MAAMC,oBAAoBF,UAAU,KAAMC,MAAME,MAAMH,UAAU,KAAKC,MAAMG,UAAUJ,UAAU;AACxG;AAEA,SAASK,uBAAuBC,eAA8BN,YAAkC;CAC9F,MAAMC,QAAQK,cAAcL;CAC5B,OAAO,CAACA,SAASF,uBAAuBC,YAAYC,KAAK;AAC3D;;;;;;;;;;;;;;;;;;AAmBA,SAAgBM,kBACdC,QACAC,UAAmC,CAAC,GACY;CAChD,MAAMC,QAAQd,SAASY,QAAQ,IAAI;CACnCX,mBAAmBa,KAAK;CACxB,EAAAC,SAAA;EAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MAAO,8DAA8D;CAAA,EAAA,CAAEF,KAAK;CAC5E,MAAMV,aAAaL,oBAAuBa,MAAM;CAEhD,IAAI,CAACR,YAGH,MAAM,IAAIY,MAAM,wBAAwB;CAE1C,EAAAD,SAAA;EAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MACE,0DAA0DZ,WAAWa,KAAK;CAAA,EAAA,CAC1EH,MAAMI,eAAeC,eAAef,UAAU,CAAC;CAGjD,IAAIK,uBAAuBK,MAAMI,gBAAgBd,UAAU,GACzD,MAAM,IAAIY,MAAM,oDAAoD;CAGtE,IAAI,CAACH,SACHA,UAAU,CAAC;CAEb,IAAIO,YAA8D;CAElE,MAAMf,QAAQS,MAAMT;CACpB,IAAIA,MAAME,MAAMH,UAAU,GACxBgB,YAAY;MACP,IAAIf,MAAMG,UAAUJ,UAAU,GACnCgB,YAAY;CAGd,OAAO;EACLC,IAAID;EACJE,MAAM;GACJT;GACAD,QAAQR;EACV;EACAmB,SAAS,CAACnB,UAAU;EACpBoB,cAAc,GAAGtB,YAAY,KAAK;CACpC;AACF"}

package/dist/unpkg/dev-deprecated/compat/extensions.js

@@ -2,7 +2,12 @@ import { get, getProperties, notifyPropertyChange, set, setProperties } from "@e
 import { addObserver, removeObserver } from "@ember/object/observers";
 import { compare } from "@ember/utils";
 
-//#region src/compat/extensions.ts
+// 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",
@@ -55,6 +60,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",
@@ -66,6 +74,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",
@@ -258,6 +269,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",
@@ -266,15 +280,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 };
 //# sourceMappingURL=extensions.js.map

package/dist/unpkg/dev-deprecated/compat/extensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.js","names":["get","getProperties","notifyPropertyChange","set","setProperties","addObserver","removeObserver","compare","EmberObjectFeatures","EmberObjectMethods","forEach","method","delegatedMethod","args","Error","keyName","decrement","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","EmberObjectFeatures","EmberObjectMethods","forEach","method","delegatedMethod","args","Error","keyName","decrement","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/unpkg/dev-deprecated/compat/utils.js

@@ -1,10 +1,12 @@
 import { dasherize, singularize } from "@warp-drive/utilities/string";
 
-//#region src/compat/utils.ts
+// src/compat/utils.ts
 /**
 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() {};
@@ -23,6 +25,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
 */
@@ -34,6 +38,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
 */
@@ -50,6 +56,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
 */
@@ -82,6 +90,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
@@ -115,6 +125,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
@@ -132,6 +144,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
 */
 /**
@@ -163,6 +177,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
@@ -195,6 +211,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
@@ -213,6 +231,5 @@ function isEquivId(expected, actual) {
 	return expected === actual || formattedId(expected) === formattedId(actual);
 }
 
-//#endregion
 export { configureAssertFn, configureMismatchReporter, configureTypeNormalization, expectId, formattedId, formattedType, isEquivId, isEquivType };
 //# sourceMappingURL=utils.js.map

package/dist/unpkg/dev-deprecated/compat/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":["dasherize","singularize","MismatchReporter","_AssertFn","AssertFn","message","condition","test","Error","NormalizedType","str","configureMismatchReporter","fn","configureAssertFn","configureTypeNormalization","NORMALIZED_TYPES","Map","formattedType","type","undefined","length","normalized","get","set","formattedId","id","formatted","String","expectId","isEquivType","expected","actual","isEquivId"],"sources":["../../../../src/compat/utils.ts"],"sourcesContent":["/**\n  Utilities for helping to migrate to stricter\n  and more consistent use of IDs and types.\n\n  @module\n*/\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport { dasherize, singularize } from '@warp-drive/utilities/string';\n\ninterface AssertFunc {\n  (desc: string, condition: unknown): asserts condition;\n  (desc: string): never;\n}\n\ntype Reporter = (type: 'formatted-id' | 'formatted-type', actual: unknown, expected: unknown) => void;\ntype Normalizer = (type: string) => string;\n\nlet MismatchReporter: Reporter = function () {};\n\n// TODO: @runspired This pattern prevents AssertFn from being removed in production builds\n// but we should enable that if we can.\nlet _AssertFn: (message: string, condition: unknown) => void = function () {};\nconst AssertFn: AssertFunc = ((message: string, condition: unknown) => {\n  if (!condition) {\n    _AssertFn(message, condition);\n  }\n  assert(message, condition);\n}) as unknown as AssertFunc;\nlet NormalizedType: Normalizer = (str: string) => {\n  return singularize(dasherize(str));\n};\n\n/**\n * Configure a function to be called when an id or type\n * changes during normalization. This is useful for instrumenting\n * to discover places where usage in the app is not consistent.\n *\n * @param fn - a function which takes a mismatch-type ('formatted-id' | 'formatted-type'), actual, and expected value\n * @public\n */\nexport function configureMismatchReporter(fn: Reporter): void {\n  MismatchReporter = fn;\n}\n\n/**\n * Configure a function to be called when an id or type\n * fails validation. This is useful for instrumenting\n * to discover places where usage in the app is not consistent.\n *\n * @param fn - a function which takes a message and a condition\n * @public\n */\nexport function configureAssertFn(fn: (message: string, condition: unknown) => void): void {\n  _AssertFn = fn;\n}\n\n/**\n * Configure a function to be called to normalize\n * a resource type string. Used by both formattedType\n * and isEquivType to ensure consistent normalization\n * during comparison.\n *\n * If validation fails or the type turns out be unnormalized\n * the configured mismatch reporter and assert functions will\n * be called.\n *\n * @param fn - a function which takes a string and returns a string\n * @public\n */\nexport function configureTypeNormalization(fn: (type: string) => string): void {\n  NormalizedType = fn;\n}\n\nconst NORMALIZED_TYPES = new Map<string, string>();\n\n/**\n * Converts a potentially unnormalized type into the format expected\n * by our WarpDrive Cache. Currently this is singular-dasherized.\n *\n * you should not rely on this function to give you an exact format\n * for display purposes. Formatting for display should be handled\n * differently if the exact format matters.\n *\n * Asserts invalid types (undefined, null, '') in dev.\n *\n * **Usage**\n *\n * ```js\n * import formattedType from 'soxhub-client/helpers/formatted-type';\n *\n * formattedType('post'); // => 'post'\n * formattedType('posts'); // => 'post'\n * formattedType('Posts'); // => 'post'\n * formattedType('post-comment'); // => 'post-comment'\n * formattedType('post-comments'); // => 'post-comment'\n * formattedType('post_comment'); // => 'post-comment'\n * formattedType('postComment'); // => 'post-comment'\n * formattedType('PostComment'); // => 'post-comment'\n * ```\n *\n * @param type the potentially un-normalized type\n * @return the normalized type\n * @public\n */\nexport function formattedType<T extends string>(type: T | string): T {\n  AssertFn('formattedType: type must not be null', type !== null);\n  AssertFn('formattedType: type must not be undefined', type !== undefined);\n  AssertFn('formattedType: type must be a string', typeof type === 'string');\n  AssertFn('formattedType: type must not be empty', type.length > 0);\n  let normalized = NORMALIZED_TYPES.get(type);\n\n  if (normalized === undefined) {\n    normalized = NormalizedType(type);\n    NORMALIZED_TYPES.set(type, normalized);\n  }\n\n  if (normalized !== type) {\n    MismatchReporter('formatted-type', type, normalized);\n  }\n\n  return normalized as T;\n}\n\n/**\n * Format an id to the format expected by the WarpDrive Cache.\n * Currently this means that id should be `string | null`.\n *\n * Asserts invalid IDs (undefined, '', 0, '0') in dev.\n *\n * **Usage**\n *\n * ```js\n * import formattedId from 'client/utils/formatted-id';\n *\n * formattedId('1'); // => '1'\n * formattedId(1); // => '1'\n * formattedId(null); // => null\n *\t```\n *\n * @param id the potentially un-normalized id\n * @return the normalized id\n * @public\n */\nexport function formattedId(id: string | number): string;\nexport function formattedId(id: null): null;\nexport function formattedId(id: string | number | null): string | null;\nexport function formattedId(id: string | number | null): string | null {\n  AssertFn('formattedId: id must not be undefined', id !== undefined);\n  AssertFn(\n    'formattedId: id must be a number, string or null',\n    typeof id === 'number' || typeof id === 'string' || id === null\n  );\n  AssertFn(\n    'formattedId: id must not be empty',\n    typeof id === 'number' || id === null || (typeof id === 'string' && id.length > 0)\n  );\n  AssertFn('formattedId: id must not be 0', id !== '0' && id !== 0);\n\n  const formatted = id === null ? null : String(id);\n  if (formatted !== id) {\n    MismatchReporter('formatted-id', id, formatted);\n  }\n  return id === null ? null : String(id);\n}\n\n/**\n * Like {@link formattedId}, but asserts that `id` is not `null` rather\n * than allowing and passing through `null`.\n *\n * @public\n */\nexport function expectId(id: string | number): string;\n/**\n * Throws, since `id` is `null`.\n *\n * @public\n */\nexport function expectId(id: null): never;\nexport function expectId(id: string | number | null): string {\n  AssertFn('expectId: id must not be null', id !== null);\n\n  return formattedId(id);\n}\n\n/**\n * Compares two types for strict equality, converting them to\n * the format expected by the WarpDrive Cache to ensure\n * differences in format are accounted for in the comparison.\n *\n * Asserts when expected or actual are invalid types in dev.\n * Expected may never be null.\n *\n * ```js\n * isEquivType('posts', 'post'); // true\n * isEquivType('post', 'post'); // true\n * isEquivType('posts', 'posts'); // true\n * isEquivType('post-comment', 'postComment'); // true\n * isEquivType('post-comment', 'PostComment'); // true\n * isEquivType('post-comment', 'post_comment'); // true\n * isEquivType('post-comment', 'post-comment'); // true\n * isEquivType('post-comment', 'post'); // false\n * isEquivType('posts', null); // false\n * ```\n *\n * @param expected a potentially unnormalized type to match against\n * @param actual a potentially unnormalized type to match against\n * @return true if the types are equivalent\n * @public\n */\nexport function isEquivType(expected: string, actual: string): boolean {\n  AssertFn('isEquivType: Expected type must not be null', expected !== null);\n  AssertFn('isEquivType: Expected type must not be undefined', expected !== undefined);\n  AssertFn('isEquivType: Expected type must be a string', typeof expected === 'string');\n  AssertFn('isEquivType: Expected type must not be empty', expected.length > 0);\n\n  AssertFn('isEquivType: Actual type must not be null', actual !== null);\n  AssertFn('isEquivType: Actual type must not be undefined', actual !== undefined);\n  AssertFn('isEquivType: Actual type must be a string', typeof actual === 'string');\n  AssertFn('isEquivType: Actual type must not be empty', actual.length > 0);\n\n  return expected === actual || formattedType(expected) === formattedType(actual);\n}\n\n/**\n * Compares two IDs for strict equality, converting them to\n * the format expected by the WarpDrive Cache to ensure\n * differences in format are accounted for in the comparison.\n *\n * Asserts when expected or actual are invalid IDs in dev.\n * Expected may never be null.\n *\n * ```js\n * isEquivId('1', 1); // true\n * isEquivId('2', '2'); // true\n * isEquivId(3, '3'); // true\n * isEquivId(4, '3'); // false\n * isEquivId(1, null); // false\n * ```\n *\n * @param expected a potentially un-normalized id to match against\n * @param actual a potentially un-normalized id to match against\n * @return true if the ids are equivalent\n * @public\n */\nexport function isEquivId(expected: string | number, actual: string | number | null): boolean {\n  AssertFn('isEquivId: Expected id must not be null', expected !== null);\n  AssertFn('isEquivId: Expected id must not be undefined', expected !== undefined);\n  AssertFn(\n    'isEquivId: Expected id must be a number or string',\n    typeof expected === 'number' || typeof expected === 'string'\n  );\n  AssertFn(\n    'isEquivId: Expected id must not be empty',\n    typeof expected === 'number' || (typeof expected === 'string' && expected.length > 0)\n  );\n  AssertFn('isEquivId: Expected id must not be 0', expected !== '0' && expected !== 0);\n\n  AssertFn('isEquivId: Actual id must not be undefined', actual !== undefined);\n  AssertFn(\n    'isEquivId: Actual id must be a number, string or null',\n    typeof actual === 'number' || typeof actual === 'string' || actual === null\n  );\n  AssertFn(\n    'isEquivId: Actual id must not be empty',\n    actual === null || typeof actual === 'number' || (typeof actual === 'string' && actual.length > 0)\n  );\n  AssertFn('isEquivId: Actual id must not be 0', actual !== '0' && actual !== 0);\n\n  return expected === actual || formattedId(expected) === formattedId(actual);\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils.js","names":["dasherize","singularize","MismatchReporter","_AssertFn","AssertFn","message","condition","test","Error","NormalizedType","str","configureMismatchReporter","fn","configureAssertFn","configureTypeNormalization","NORMALIZED_TYPES","Map","formattedType","type","undefined","length","normalized","get","set","formattedId","id","formatted","String","expectId","isEquivType","expected","actual","isEquivId"],"sources":["../../../../src/compat/utils.ts"],"sourcesContent":["/**\n  Utilities for helping to migrate to stricter\n  and more consistent use of IDs and types.\n\n  @summary Legacy helpers that normalize, compare, and report mismatched resource ids and types while migrating to\n  stricter formats.\n  @module\n*/\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport { dasherize, singularize } from '@warp-drive/utilities/string';\n\ninterface AssertFunc {\n  (desc: string, condition: unknown): asserts condition;\n  (desc: string): never;\n}\n\ntype Reporter = (type: 'formatted-id' | 'formatted-type', actual: unknown, expected: unknown) => void;\ntype Normalizer = (type: string) => string;\n\nlet MismatchReporter: Reporter = function () {};\n\n// TODO: @runspired This pattern prevents AssertFn from being removed in production builds\n// but we should enable that if we can.\nlet _AssertFn: (message: string, condition: unknown) => void = function () {};\nconst AssertFn: AssertFunc = ((message: string, condition: unknown) => {\n  if (!condition) {\n    _AssertFn(message, condition);\n  }\n  assert(message, condition);\n}) as unknown as AssertFunc;\nlet NormalizedType: Normalizer = (str: string) => {\n  return singularize(dasherize(str));\n};\n\n/**\n * Configure a function to be called when an id or type\n * changes during normalization. This is useful for instrumenting\n * to discover places where usage in the app is not consistent.\n *\n * @summary Legacy migration helper that registers a callback invoked whenever `formattedId` or `formattedType`\n * has to change the id or type it was given.\n * @param fn - a function which takes a mismatch-type ('formatted-id' | 'formatted-type'), actual, and expected value\n * @public\n */\nexport function configureMismatchReporter(fn: Reporter): void {\n  MismatchReporter = fn;\n}\n\n/**\n * Configure a function to be called when an id or type\n * fails validation. This is useful for instrumenting\n * to discover places where usage in the app is not consistent.\n *\n * @summary Legacy migration helper that registers a callback invoked when an id or type passed to these utilities\n * fails validation.\n * @param fn - a function which takes a message and a condition\n * @public\n */\nexport function configureAssertFn(fn: (message: string, condition: unknown) => void): void {\n  _AssertFn = fn;\n}\n\n/**\n * Configure a function to be called to normalize\n * a resource type string. Used by both formattedType\n * and isEquivType to ensure consistent normalization\n * during comparison.\n *\n * If validation fails or the type turns out be unnormalized\n * the configured mismatch reporter and assert functions will\n * be called.\n *\n * @summary Legacy migration helper that replaces the singularize-and-dasherize function `formattedType` and\n * `isEquivType` use to normalize resource types.\n * @param fn - a function which takes a string and returns a string\n * @public\n */\nexport function configureTypeNormalization(fn: (type: string) => string): void {\n  NormalizedType = fn;\n}\n\nconst NORMALIZED_TYPES = new Map<string, string>();\n\n/**\n * Converts a potentially unnormalized type into the format expected\n * by our WarpDrive Cache. Currently this is singular-dasherized.\n *\n * you should not rely on this function to give you an exact format\n * for display purposes. Formatting for display should be handled\n * differently if the exact format matters.\n *\n * Asserts invalid types (undefined, null, '') in dev.\n *\n * **Usage**\n *\n * ```js\n * import formattedType from 'soxhub-client/helpers/formatted-type';\n *\n * formattedType('post'); // => 'post'\n * formattedType('posts'); // => 'post'\n * formattedType('Posts'); // => 'post'\n * formattedType('post-comment'); // => 'post-comment'\n * formattedType('post-comments'); // => 'post-comment'\n * formattedType('post_comment'); // => 'post-comment'\n * formattedType('postComment'); // => 'post-comment'\n * formattedType('PostComment'); // => 'post-comment'\n * ```\n *\n * @summary Legacy migration helper that normalizes a resource type to the singular dasherized form the cache\n * expects, such as `'PostComments'` to `'post-comment'`.\n * @param type the potentially un-normalized type\n * @return the normalized type\n * @public\n */\nexport function formattedType<T extends string>(type: T | string): T {\n  AssertFn('formattedType: type must not be null', type !== null);\n  AssertFn('formattedType: type must not be undefined', type !== undefined);\n  AssertFn('formattedType: type must be a string', typeof type === 'string');\n  AssertFn('formattedType: type must not be empty', type.length > 0);\n  let normalized = NORMALIZED_TYPES.get(type);\n\n  if (normalized === undefined) {\n    normalized = NormalizedType(type);\n    NORMALIZED_TYPES.set(type, normalized);\n  }\n\n  if (normalized !== type) {\n    MismatchReporter('formatted-type', type, normalized);\n  }\n\n  return normalized as T;\n}\n\n/**\n * Format an id to the format expected by the WarpDrive Cache.\n * Currently this means that id should be `string | null`.\n *\n * Asserts invalid IDs (undefined, '', 0, '0') in dev.\n *\n * **Usage**\n *\n * ```js\n * import formattedId from 'client/utils/formatted-id';\n *\n * formattedId('1'); // => '1'\n * formattedId(1); // => '1'\n * formattedId(null); // => null\n *\t```\n *\n * @summary Legacy migration helper that normalizes a resource id to the `string` or `null` the cache expects,\n * asserting on invalid ids such as `''` or `0`.\n * @param id the potentially un-normalized id\n * @return the normalized id\n * @public\n */\nexport function formattedId(id: string | number): string;\nexport function formattedId(id: null): null;\nexport function formattedId(id: string | number | null): string | null;\nexport function formattedId(id: string | number | null): string | null {\n  AssertFn('formattedId: id must not be undefined', id !== undefined);\n  AssertFn(\n    'formattedId: id must be a number, string or null',\n    typeof id === 'number' || typeof id === 'string' || id === null\n  );\n  AssertFn(\n    'formattedId: id must not be empty',\n    typeof id === 'number' || id === null || (typeof id === 'string' && id.length > 0)\n  );\n  AssertFn('formattedId: id must not be 0', id !== '0' && id !== 0);\n\n  const formatted = id === null ? null : String(id);\n  if (formatted !== id) {\n    MismatchReporter('formatted-id', id, formatted);\n  }\n  return id === null ? null : String(id);\n}\n\n/**\n * Like {@link formattedId}, but asserts that `id` is not `null` rather\n * than allowing and passing through `null`.\n *\n * @summary Legacy migration helper that normalizes a resource id to a string like `formattedId`, but asserts that\n * it is not `null`.\n * @public\n */\nexport function expectId(id: string | number): string;\n/**\n * Throws, since `id` is `null`.\n *\n * @public\n */\nexport function expectId(id: null): never;\nexport function expectId(id: string | number | null): string {\n  AssertFn('expectId: id must not be null', id !== null);\n\n  return formattedId(id);\n}\n\n/**\n * Compares two types for strict equality, converting them to\n * the format expected by the WarpDrive Cache to ensure\n * differences in format are accounted for in the comparison.\n *\n * Asserts when expected or actual are invalid types in dev.\n * Expected may never be null.\n *\n * ```js\n * isEquivType('posts', 'post'); // true\n * isEquivType('post', 'post'); // true\n * isEquivType('posts', 'posts'); // true\n * isEquivType('post-comment', 'postComment'); // true\n * isEquivType('post-comment', 'PostComment'); // true\n * isEquivType('post-comment', 'post_comment'); // true\n * isEquivType('post-comment', 'post-comment'); // true\n * isEquivType('post-comment', 'post'); // false\n * isEquivType('posts', null); // false\n * ```\n *\n * @summary Legacy migration helper that reports whether two resource types match after normalization, so\n * `'posts'` and `'post'` are equivalent.\n * @param expected a potentially unnormalized type to match against\n * @param actual a potentially unnormalized type to match against\n * @return true if the types are equivalent\n * @public\n */\nexport function isEquivType(expected: string, actual: string): boolean {\n  AssertFn('isEquivType: Expected type must not be null', expected !== null);\n  AssertFn('isEquivType: Expected type must not be undefined', expected !== undefined);\n  AssertFn('isEquivType: Expected type must be a string', typeof expected === 'string');\n  AssertFn('isEquivType: Expected type must not be empty', expected.length > 0);\n\n  AssertFn('isEquivType: Actual type must not be null', actual !== null);\n  AssertFn('isEquivType: Actual type must not be undefined', actual !== undefined);\n  AssertFn('isEquivType: Actual type must be a string', typeof actual === 'string');\n  AssertFn('isEquivType: Actual type must not be empty', actual.length > 0);\n\n  return expected === actual || formattedType(expected) === formattedType(actual);\n}\n\n/**\n * Compares two IDs for strict equality, converting them to\n * the format expected by the WarpDrive Cache to ensure\n * differences in format are accounted for in the comparison.\n *\n * Asserts when expected or actual are invalid IDs in dev.\n * Expected may never be null.\n *\n * ```js\n * isEquivId('1', 1); // true\n * isEquivId('2', '2'); // true\n * isEquivId(3, '3'); // true\n * isEquivId(4, '3'); // false\n * isEquivId(1, null); // false\n * ```\n *\n * @summary Legacy migration helper that reports whether two resource ids match after normalization, so `1` and\n * `'1'` are equivalent.\n * @param expected a potentially un-normalized id to match against\n * @param actual a potentially un-normalized id to match against\n * @return true if the ids are equivalent\n * @public\n */\nexport function isEquivId(expected: string | number, actual: string | number | null): boolean {\n  AssertFn('isEquivId: Expected id must not be null', expected !== null);\n  AssertFn('isEquivId: Expected id must not be undefined', expected !== undefined);\n  AssertFn(\n    'isEquivId: Expected id must be a number or string',\n    typeof expected === 'number' || typeof expected === 'string'\n  );\n  AssertFn(\n    'isEquivId: Expected id must not be empty',\n    typeof expected === 'number' || (typeof expected === 'string' && expected.length > 0)\n  );\n  AssertFn('isEquivId: Expected id must not be 0', expected !== '0' && expected !== 0);\n\n  AssertFn('isEquivId: Actual id must not be undefined', actual !== undefined);\n  AssertFn(\n    'isEquivId: Actual id must be a number, string or null',\n    typeof actual === 'number' || typeof actual === 'string' || actual === null\n  );\n  AssertFn(\n    'isEquivId: Actual id must not be empty',\n    actual === null || typeof actual === 'number' || (typeof actual === 'string' && actual.length > 0)\n  );\n  AssertFn('isEquivId: Actual id must not be 0', actual !== '0' && actual !== 0);\n\n  return expected === actual || formattedId(expected) === formattedId(actual);\n}\n"],"mappings":"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"}