@ember-data/legacy-compat 5.6.0-alpha.5 → 5.6.0-beta.1

package/dist/utils.js

@@ -1,224 +1 @@
-import { singularize, dasherize } from '@ember-data/request-utils/string';
-import { macroCondition, getGlobalConfig } from '@embroider/macros';
-
-/**
-  Utilities for helping to migrate to stricter
-  and more consistent use of IDs and types.
-
-  @module
-  @deprecated
-*/
-let MismatchReporter = function () {};
-
-// TODO: @runspired This pattern prevents AssertFn from being removed in production builds
-// but we should enable that if we can.
-let _AssertFn = function () {};
-const AssertFn = (message, condition) => {
-  if (!condition) {
-    _AssertFn(message, condition);
-  }
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(message);
-    }
-  })(condition) : {};
-};
-let NormalizedType = str => {
-  return singularize(dasherize(str));
-};
-
-/**
- * Configure a function to be called when an id or type
- * changes during normalization. This is useful for instrumenting
- * to discover places where usage in the app is not consistent.
- *
- * @param method a function which takes a mismatch-type ('formatted-id' | 'formatted-type'), actual, and expected value
- * @public
- */
-function configureMismatchReporter(fn) {
-  MismatchReporter = fn;
-}
-
-/**
- * Configure a function to be called when an id or type
- * fails validation. This is useful for instrumenting
- * to discover places where usage in the app is not consistent.
- *
- * @param method a function which takes a message and a condition
- * @public
- */
-function configureAssertFn(fn) {
-  _AssertFn = fn;
-}
-
-/**
- * Configure a function to be called to normalize
- * a resource type string. Used by both formattedType
- * and isEquivType to ensure consistent normalization
- * during comparison.
- *
- * If validation fails or the type turns out be unnormalized
- * the configured mismatch reporter and assert functions will
- * be called.
- *
- * @param method a function which takes a string and returns a string
- * @public
- */
-function configureTypeNormalization(fn) {
-  NormalizedType = fn;
-}
-const NORMALIZED_TYPES = new Map();
-
-/**
- * Converts a potentially unnormalized type into the format expected
- * by our EmberData Cache. Currently this is singular-dasherized.
- *
- * you should not rely on this function to give you an exact format
- * for display purposes. Formatting for display should be handled
- * differently if the exact format matters.
- *
- * Asserts invalid types (undefined, null, '') in dev.
- *
- * **Usage**
- *
- * ```js
- * import formattedType from 'soxhub-client/helpers/formatted-type';
- *
- * formattedType('post'); // => 'post'
- * formattedType('posts'); // => 'post'
- * formattedType('Posts'); // => 'post'
- * formattedType('post-comment'); // => 'post-comment'
- * formattedType('post-comments'); // => 'post-comment'
- * formattedType('post_comment'); // => 'post-comment'
- * formattedType('postComment'); // => 'post-comment'
- * formattedType('PostComment'); // => 'post-comment'
- * ```
- *
- * @param {String} type the potentially un-normalized type
- * @return {String} the normalized type
- * @public
- */
-function formattedType(type) {
-  AssertFn('formattedType: type must not be null', type !== null);
-  AssertFn('formattedType: type must not be undefined', type !== undefined);
-  AssertFn('formattedType: type must be a string', typeof type === 'string');
-  AssertFn('formattedType: type must not be empty', type.length > 0);
-  let normalized = NORMALIZED_TYPES.get(type);
-  if (normalized === undefined) {
-    normalized = NormalizedType(type);
-    NORMALIZED_TYPES.set(type, normalized);
-  }
-  if (normalized !== type) {
-    MismatchReporter('formatted-type', type, normalized);
-  }
-  return normalized;
-}
-
-/**
- * Format an id to the format expected by the EmberData Cache.
- * Currently this means that id should be `string | null`.
- *
- * Asserts invalid IDs (undefined, '', 0, '0') in dev.
- *
- * **Usage**
- *
- * ```js
- * import formattedId from 'client/utils/formatted-id';
- *
- * formattedId('1'); // => '1'
- * formattedId(1); // => '1'
- * formattedId(null); // => null
- *	```
- *
- * @param {String | Number | null} id the potentially un-normalized id
- * @return {String | null} the normalized id
- * @public
- */
-
-function formattedId(id) {
-  AssertFn('formattedId: id must not be undefined', id !== undefined);
-  AssertFn('formattedId: id must be a number, string or null', typeof id === 'number' || typeof id === 'string' || id === null);
-  AssertFn('formattedId: id must not be empty', typeof id === 'number' || id === null || typeof id === 'string' && id.length > 0);
-  AssertFn('formattedId: id must not be 0', id !== '0' && id !== 0);
-  const formatted = id === null ? null : String(id);
-  if (formatted !== id) {
-    MismatchReporter('formatted-id', id, formatted);
-  }
-  return id === null ? null : String(id);
-}
-function expectId(id) {
-  AssertFn('expectId: id must not be null', id !== null);
-  return formattedId(id);
-}
-
-/**
- * Compares two types for strict equality, converting them to
- * the format expected by the EmberData Cache to ensure
- * differences in format are accounted for in the comparison.
- *
- * Asserts when expected or actual are invalid types in dev.
- * Expected may never be null.
- *
- * ```js
- * isEquivType('posts', 'post'); // true
- * isEquivType('post', 'post'); // true
- * isEquivType('posts', 'posts'); // true
- * isEquivType('post-comment', 'postComment'); // true
- * isEquivType('post-comment', 'PostComment'); // true
- * isEquivType('post-comment', 'post_comment'); // true
- * isEquivType('post-comment', 'post-comment'); // true
- * isEquivType('post-comment', 'post'); // false
- * isEquivType('posts', null); // false
- * ```
- *
- * @param {String} expected a potentially unnormalized type to match against
- * @param {String} actual a potentially unnormalized type to match against
- * @return {Boolean} true if the types are equivalent
- * @public
- */
-function isEquivType(expected, actual) {
-  AssertFn('isEquivType: Expected type must not be null', expected !== null);
-  AssertFn('isEquivType: Expected type must not be undefined', expected !== undefined);
-  AssertFn('isEquivType: Expected type must be a string', typeof expected === 'string');
-  AssertFn('isEquivType: Expected type must not be empty', expected.length > 0);
-  AssertFn('isEquivType: Actual type must not be null', actual !== null);
-  AssertFn('isEquivType: Actual type must not be undefined', actual !== undefined);
-  AssertFn('isEquivType: Actual type must be a string', typeof actual === 'string');
-  AssertFn('isEquivType: Actual type must not be empty', actual.length > 0);
-  return expected === actual || formattedType(expected) === formattedType(actual);
-}
-
-/**
- * Compares two IDs for strict equality, converting them to
- * the format expected by the EmberData Cache to ensure
- * differences in format are accounted for in the comparison.
- *
- * Asserts when expected or actual are invalid IDs in dev.
- * Expected may never be null.
- *
- * ```js
- * isEquivId('1', 1); // true
- * isEquivId('2', '2'); // true
- * isEquivId(3, '3'); // true
- * isEquivId(4, '3'); // false
- * isEquivId(1, null); // false
- * ```
- *
- * @param {string | number} expected a potentially un-normalized id to match against
- * @param {string | number} actual a potentially un-normalized id to match against
- * @return {Boolean} true if the ids are equivalent
- * @public
- */
-function isEquivId(expected, actual) {
-  AssertFn('isEquivId: Expected id must not be null', expected !== null);
-  AssertFn('isEquivId: Expected id must not be undefined', expected !== undefined);
-  AssertFn('isEquivId: Expected id must be a number or string', typeof expected === 'number' || typeof expected === 'string');
-  AssertFn('isEquivId: Expected id must not be empty', typeof expected === 'number' || typeof expected === 'string' && expected.length > 0);
-  AssertFn('isEquivId: Expected id must not be 0', expected !== '0' && expected !== 0);
-  AssertFn('isEquivId: Actual id must not be undefined', actual !== undefined);
-  AssertFn('isEquivId: Actual id must be a number, string or null', typeof actual === 'number' || typeof actual === 'string' || actual === null);
-  AssertFn('isEquivId: Actual id must not be empty', actual === null || typeof actual === 'number' || typeof actual === 'string' && actual.length > 0);
-  AssertFn('isEquivId: Actual id must not be 0', actual !== '0' && actual !== 0);
-  return expected === actual || formattedId(expected) === formattedId(actual);
-}
-export { configureAssertFn, configureMismatchReporter, configureTypeNormalization, expectId, formattedId, formattedType, isEquivId, isEquivType };
+export * from '@warp-drive/legacy/compat/utils';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ember-data/legacy-compat",
   "description": "Compatibility Shims for Older EmberData",
-  "version": "5.6.0-alpha.5",
+  "version": "5.6.0-beta.1",
   "license": "MIT",
   "author": "Chris Thoburn <runspired@users.noreply.github.com>",
   "repository": {
@@ -41,44 +41,21 @@
     "type": "addon",
     "version": 2
   },
-  "peerDependenciesMeta": {
-    "@ember-data/graph": {
-      "optional": true
-    },
-    "@ember-data/json-api": {
-      "optional": true
-    }
-  },
   "dependencies": {
     "@embroider/macros": "^1.16.12",
-    "@warp-drive/build-config": "5.6.0-alpha.5"
-  },
-  "peerDependencies": {
-    "@ember-data/graph": "5.6.0-alpha.5",
-    "@ember-data/json-api": "5.6.0-alpha.5",
-    "@ember-data/request": "5.6.0-alpha.5",
-    "@ember-data/request-utils": "5.6.0-alpha.5",
-    "@ember-data/store": "5.6.0-alpha.5",
-    "@ember/test-waiters": "^3.1.0 || >= 4.0.0",
-    "@warp-drive/core-types": "5.6.0-alpha.5"
+    "@warp-drive/core": "5.6.0-beta.0",
+    "@warp-drive/legacy": "5.6.0-beta.0",
+    "@warp-drive/utilities": "5.6.0-beta.0"
   },
+  "peerDependencies": {},
   "devDependencies": {
     "@babel/core": "^7.26.10",
     "@babel/plugin-transform-typescript": "^7.27.0",
     "@babel/preset-env": "^7.26.9",
     "@babel/preset-typescript": "^7.27.0",
-    "@ember-data/graph": "5.6.0-alpha.5",
-    "@ember-data/json-api": "5.6.0-alpha.5",
-    "@ember-data/request": "5.6.0-alpha.5",
-    "@ember-data/request-utils": "5.6.0-alpha.5",
-    "@ember-data/store": "5.6.0-alpha.5",
-    "@ember/test-waiters": "^4.1.0",
-    "@glimmer/component": "^2.0.0",
-    "@warp-drive/core-types": "5.6.0-alpha.5",
-    "@warp-drive/internal-config": "5.6.0-alpha.5",
-    "ember-source": "~6.3.0",
+    "@warp-drive/internal-config": "5.6.0-beta.1",
     "typescript": "^5.8.3",
-    "vite": "^5.4.15"
+    "vite": "^7.0.0"
   },
   "ember": {
     "edition": "octane"

package/unstable-preview-types/-private.d.ts

@@ -1,16 +1,10 @@
 declare module '@ember-data/legacy-compat/-private' {
-  import type Store from '@ember-data/store';
-  import type { CompatStore } from '@ember-data/legacy-compat';
   /**
-   * Utilities - often temporary - for maintaining backwards compatibility with
-   * older parts of EmberData.
-   *
-    @module
+  * Utilities - often temporary - for maintaining backwards compatibility with
+  * older parts of EmberData.
+  *
+  @module
   */
-  export { SnapshotRecordArray } from '@ember-data/legacy-compat/legacy-network-handler/snapshot-record-array';
-  export { SaveOp } from '@ember-data/legacy-compat/legacy-network-handler/fetch-manager';
-  export { FetchManager } from '@ember-data/legacy-compat/legacy-network-handler/fetch-manager';
-  export { Snapshot } from '@ember-data/legacy-compat/legacy-network-handler/snapshot';
-  export function upgradeStore(store: Store): asserts store is CompatStore;
-}
-//# sourceMappingURL=-private.d.ts.map
+  export * from "@warp-drive/legacy/compat/-private";
+  
+}

package/unstable-preview-types/builders.d.ts

@@ -1,17 +1,14 @@
 declare module '@ember-data/legacy-compat/builders' {
   /**
-    Builders for migrating from `store` methods to `store.request`.
+  Builders for migrating from `store` methods to `store.request`.
   
-    These builders enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.
-    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.
+  These builders enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.
+  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.
   
-    @module
-    @deprecated
+  @module
+  @deprecated
   */
-  export { findAllBuilder as findAll } from '@ember-data/legacy-compat/builders/find-all';
-  export { findRecordBuilder as findRecord } from '@ember-data/legacy-compat/builders/find-record';
-  export { queryBuilder as query, queryRecordBuilder as queryRecord } from '@ember-data/legacy-compat/builders/query';
-  export { saveRecordBuilder as saveRecord } from '@ember-data/legacy-compat/builders/save-record';
-}
-//# sourceMappingURL=builders.d.ts.map
+  export * from "@warp-drive/legacy/compat/builders";
+  
+}

package/unstable-preview-types/index.d.ts

@@ -1,154 +1,7 @@
 /// <reference path="./builders.d.ts" />
 /// <reference path="./-private.d.ts" />
 /// <reference path="./utils.d.ts" />
-/// <reference path="./builders/utils.d.ts" />
-/// <reference path="./builders/find-record.d.ts" />
-/// <reference path="./builders/save-record.d.ts" />
-/// <reference path="./builders/query.d.ts" />
-/// <reference path="./builders/find-all.d.ts" />
-/// <reference path="./legacy-network-handler/snapshot-record-array.d.ts" />
-/// <reference path="./legacy-network-handler/legacy-network-handler.d.ts" />
-/// <reference path="./legacy-network-handler/snapshot.d.ts" />
-/// <reference path="./legacy-network-handler/identifier-has-id.d.ts" />
-/// <reference path="./legacy-network-handler/minimum-serializer-interface.d.ts" />
-/// <reference path="./legacy-network-handler/fetch-manager.d.ts" />
-/// <reference path="./legacy-network-handler/serializer-response.d.ts" />
-/// <reference path="./legacy-network-handler/minimum-adapter-interface.d.ts" />
-/// <reference path="./legacy-network-handler/legacy-data-fetch.d.ts" />
-/// <reference path="./legacy-network-handler/legacy-data-utils.d.ts" />
 declare module '@ember-data/legacy-compat' {
-  import type Store from '@ember-data/store';
-  import type { ObjectValue } from '@warp-drive/core-types/json/raw';
-  import { FetchManager } from '@ember-data/legacy-compat/-private';
-  import type { AdapterPayload, MinimumAdapterInterface } from '@ember-data/legacy-compat/legacy-network-handler/minimum-adapter-interface';
-  import type { MinimumSerializerInterface, SerializerOptions } from '@ember-data/legacy-compat/legacy-network-handler/minimum-serializer-interface';
-  export { LegacyNetworkHandler } from '@ember-data/legacy-compat/legacy-network-handler/legacy-network-handler';
-  export type { MinimumAdapterInterface, MinimumSerializerInterface, SerializerOptions, AdapterPayload };
-  export type LegacyStoreCompat = {
-      _fetchManager: FetchManager;
-      adapterFor(this: Store, modelName: string): MinimumAdapterInterface;
-      adapterFor(this: Store, modelName: string, _allowMissing: true): MinimumAdapterInterface | undefined;
-      serializerFor<K extends string>(modelName: K, _allowMissing?: boolean): MinimumSerializerInterface | null;
-      normalize(modelName: string, payload: ObjectValue): ObjectValue;
-      pushPayload(modelName: string, payload: ObjectValue): void;
-      serializeRecord(record: unknown, options?: SerializerOptions): unknown;
-      _adapterCache: Record<string, MinimumAdapterInterface & {
-          store: Store;
-      }>;
-      _serializerCache: Record<string, MinimumSerializerInterface & {
-          store: Store;
-      }>;
-  };
-  export type CompatStore = Store & LegacyStoreCompat;
-  /**
-      Returns an instance of the adapter for a given type. For
-      example, `adapterFor('person')` will return an instance of
-      the adapter located at `app/adapters/person.js`
+  export * from "@warp-drive/legacy/compat";
   
-      If no `person` adapter is found, this method will look
-      for an `application` adapter (the default adapter for
-      your entire application).
-  
-      @public
-      @param {String} modelName
-      @return {Adapter}
-    */
-  export function adapterFor(this: Store, modelName: string): MinimumAdapterInterface;
-  export function adapterFor(this: Store, modelName: string, _allowMissing: true): MinimumAdapterInterface | undefined;
-  /**
-      Returns an instance of the serializer for a given type. For
-      example, `serializerFor('person')` will return an instance of
-      `App.PersonSerializer`.
-  
-      If no `App.PersonSerializer` is found, this method will look
-      for an `App.ApplicationSerializer` (the default serializer for
-      your entire application).
-  
-      If a serializer cannot be found on the adapter, it will fall back
-      to an instance of `JSONSerializer`.
-  
-      @public
-      @param {String} modelName the record to serialize
-      @return {Serializer}
-    */
-  export function serializerFor(this: Store, modelName: string): MinimumSerializerInterface | null;
-  /**
-      `normalize` converts a json payload into the normalized form that
-      [push](../methods/push?anchor=push) expects.
-  
-      Example
-  
-      ```js
-      socket.on('message', function(message) {
-        let modelName = message.model;
-        let data = message.data;
-        store.push(store.normalize(modelName, data));
-      });
-      ```
-  
-      @public
-      @param {String} modelName The name of the model type for this payload
-      @param {Object} payload
-      @return {Object} The normalized payload
-    */
-  export function normalize(this: Store, modelName: string, payload: ObjectValue): import("@warp-drive/core-types/spec/json-api-raw").SingleResourceDocument;
-  /**
-      Push some raw data into the store.
-  
-      This method can be used both to push in brand new
-      records, as well as to update existing records. You
-      can push in more than one type of object at once.
-      All objects should be in the format expected by the
-      serializer.
-  
-      ```js [app/serializers/application.js]
-      import RESTSerializer from '@ember-data/serializer/rest';
-  
-      export default class ApplicationSerializer extends RESTSerializer;
-      ```
-  
-      ```js
-      let pushData = {
-        posts: [
-          { id: 1, postTitle: "Great post", commentIds: [2] }
-        ],
-        comments: [
-          { id: 2, commentBody: "Insightful comment" }
-        ]
-      }
-  
-      store.pushPayload(pushData);
-      ```
-  
-      By default, the data will be deserialized using a default
-      serializer (the application serializer if it exists).
-  
-      Alternatively, `pushPayload` will accept a model type which
-      will determine which serializer will process the payload.
-  
-      ```js [app/serializers/application.js]
-      import RESTSerializer from '@ember-data/serializer/rest';
-  
-       export default class ApplicationSerializer extends RESTSerializer;
-      ```
-  
-      ```js [app/serializers/post.js]
-      import JSONSerializer from '@ember-data/serializer/json';
-  
-      export default JSONSerializer;
-      ```
-  
-      ```js
-      store.pushPayload(pushData); // Will use the application serializer
-      store.pushPayload('post', pushData); // Will use the post serializer
-      ```
-  
-      @public
-      @param {String} modelName Optionally, a model type used to determine which serializer will be used
-      @param {Object} inputPayload
-    */
-  export function pushPayload(this: Store, modelName: string, inputPayload: ObjectValue): void;
-  export function serializeRecord(this: Store, record: unknown, options?: SerializerOptions): unknown;
-  export function cleanup(this: Store): void;
-}
-//# sourceMappingURL=index.d.ts.map
+}

package/unstable-preview-types/utils.d.ts

@@ -1,140 +1,11 @@
 declare module '@ember-data/legacy-compat/utils' {
-  type Reporter = (type: 'formatted-id' | 'formatted-type', actual: unknown, expected: unknown) => void;
   /**
-   * Configure a function to be called when an id or type
-   * changes during normalization. This is useful for instrumenting
-   * to discover places where usage in the app is not consistent.
-   *
-   * @param method a function which takes a mismatch-type ('formatted-id' | 'formatted-type'), actual, and expected value
-   * @public
-   */
-  export function configureMismatchReporter(fn: Reporter): void;
-  /**
-   * Configure a function to be called when an id or type
-   * fails validation. This is useful for instrumenting
-   * to discover places where usage in the app is not consistent.
-   *
-   * @param method a function which takes a message and a condition
-   * @public
-   */
-  export function configureAssertFn(fn: (message: string, condition: unknown) => void): void;
-  /**
-   * Configure a function to be called to normalize
-   * a resource type string. Used by both formattedType
-   * and isEquivType to ensure consistent normalization
-   * during comparison.
-   *
-   * If validation fails or the type turns out be unnormalized
-   * the configured mismatch reporter and assert functions will
-   * be called.
-   *
-   * @param method a function which takes a string and returns a string
-   * @public
-   */
-  export function configureTypeNormalization(fn: (type: string) => string): void;
-  /**
-   * Converts a potentially unnormalized type into the format expected
-   * by our EmberData Cache. Currently this is singular-dasherized.
-   *
-   * you should not rely on this function to give you an exact format
-   * for display purposes. Formatting for display should be handled
-   * differently if the exact format matters.
-   *
-   * Asserts invalid types (undefined, null, '') in dev.
-   *
-   * **Usage**
-   *
-   * ```js
-   * import formattedType from 'soxhub-client/helpers/formatted-type';
-   *
-   * formattedType('post'); // => 'post'
-   * formattedType('posts'); // => 'post'
-   * formattedType('Posts'); // => 'post'
-   * formattedType('post-comment'); // => 'post-comment'
-   * formattedType('post-comments'); // => 'post-comment'
-   * formattedType('post_comment'); // => 'post-comment'
-   * formattedType('postComment'); // => 'post-comment'
-   * formattedType('PostComment'); // => 'post-comment'
-   * ```
-   *
-   * @param {String} type the potentially un-normalized type
-   * @return {String} the normalized type
-   * @public
-   */
-  export function formattedType<T extends string>(type: T | string): T;
-  /**
-   * Format an id to the format expected by the EmberData Cache.
-   * Currently this means that id should be `string | null`.
-   *
-   * Asserts invalid IDs (undefined, '', 0, '0') in dev.
-   *
-   * **Usage**
-   *
-   * ```js
-   * import formattedId from 'client/utils/formatted-id';
-   *
-   * formattedId('1'); // => '1'
-   * formattedId(1); // => '1'
-   * formattedId(null); // => null
-   *	```
-   *
-   * @param {String | Number | null} id the potentially un-normalized id
-   * @return {String | null} the normalized id
-   * @public
-   */
-  export function formattedId(id: string | number): string;
-  export function formattedId(id: null): null;
-  export function formattedId(id: string | number | null): string | null;
-  export function expectId(id: string | number): string;
-  export function expectId(id: null): never;
-  /**
-   * Compares two types for strict equality, converting them to
-   * the format expected by the EmberData Cache to ensure
-   * differences in format are accounted for in the comparison.
-   *
-   * Asserts when expected or actual are invalid types in dev.
-   * Expected may never be null.
-   *
-   * ```js
-   * isEquivType('posts', 'post'); // true
-   * isEquivType('post', 'post'); // true
-   * isEquivType('posts', 'posts'); // true
-   * isEquivType('post-comment', 'postComment'); // true
-   * isEquivType('post-comment', 'PostComment'); // true
-   * isEquivType('post-comment', 'post_comment'); // true
-   * isEquivType('post-comment', 'post-comment'); // true
-   * isEquivType('post-comment', 'post'); // false
-   * isEquivType('posts', null); // false
-   * ```
-   *
-   * @param {String} expected a potentially unnormalized type to match against
-   * @param {String} actual a potentially unnormalized type to match against
-   * @return {Boolean} true if the types are equivalent
-   * @public
-   */
-  export function isEquivType(expected: string, actual: string): boolean;
-  /**
-   * Compares two IDs for strict equality, converting them to
-   * the format expected by the EmberData Cache to ensure
-   * differences in format are accounted for in the comparison.
-   *
-   * Asserts when expected or actual are invalid IDs in dev.
-   * Expected may never be null.
-   *
-   * ```js
-   * isEquivId('1', 1); // true
-   * isEquivId('2', '2'); // true
-   * isEquivId(3, '3'); // true
-   * isEquivId(4, '3'); // false
-   * isEquivId(1, null); // false
-   * ```
-   *
-   * @param {string | number} expected a potentially un-normalized id to match against
-   * @param {string | number} actual a potentially un-normalized id to match against
-   * @return {Boolean} true if the ids are equivalent
-   * @public
-   */
-  export function isEquivId(expected: string | number, actual: string | number | null): boolean;
-  export {};
-}
-//# sourceMappingURL=utils.d.ts.map
+  Utilities for helping to migrate to stricter
+  and more consistent use of IDs and types.
+  
+  @module
+  @deprecated
+  */
+  export * from "@warp-drive/legacy/compat/utils";
+  
+}