feat: assert|warn|deprecate macros

packages/-ember-data/addon-test-support/index.js

@@ -1,9 +1,9 @@
-import { assert } from '@ember/debug';
 import { render as renderTemplate, settled } from '@ember/test-helpers';
 
 import * as QUnit from 'qunit';
 
 import { PRODUCTION } from '@ember-data/env';
+import { assert } from '@ember-data/macros';
 
 /*
   Temporary replacement for the render test helper

packages/active-record/src/-private/builders/save-record.ts

@@ -1,8 +1,8 @@
-import { assert } from '@ember/debug';
 import { underscore } from '@ember/string';
 
 import { pluralize } from 'ember-inflector';
 
+import { assert } from '@ember-data/macros';
 import {
   buildBaseURL,
   type CreateRecordUrlOptions,

packages/adapter/src/-private/utils/fetch.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 type FetchFunction = (input: RequestInfo, init?: RequestInit | undefined) => Promise<Response>;
 

packages/adapter/src/-private/utils/serialize-into-hash.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 import { type Snapshot, upgradeStore } from '@ember-data/legacy-compat/-private';
 import type {

packages/adapter/src/-private/utils/serialize-query-params.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 const RBRACKET = /\[\]$/;
 

packages/adapter/src/error.js

@@ -1,7 +1,7 @@
 /**
   @module @ember-data/adapter/error
  */
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 /**
   ## Overview

packages/adapter/src/index.ts

@@ -187,7 +187,7 @@ By default when using with Ember you only need to implement this hook if you wan
   @main @ember-data/adapter
 */
 
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 import EmberObject from '@ember/object';
 import { inject as service } from '@ember/service';
 

packages/adapter/src/json-api.ts

@@ -1,7 +1,7 @@
 /**
   @module @ember-data/adapter/json-api
  */
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 import { dasherize } from '@ember/string';
 
 import { pluralize } from 'ember-inflector';

packages/debug/addon/index.js

@@ -24,7 +24,7 @@
   @main @ember-data/debug
 */
 import { A } from '@ember/array';
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 import DataAdapter from '@ember/debug/data-adapter';
 import { addObserver, removeObserver } from '@ember/object/observers';
 import { inject as service } from '@ember/service';

packages/graph/src/-private/-edge-definition.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 import { DEBUG } from '@ember-data/env';
 import type Store from '@ember-data/store';

packages/graph/src/-private/debug/assert-polymorphic-type.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 import { DEBUG } from '@ember-data/env';
 import type { UpgradedMeta } from '../-edge-definition';
 import type { StableRecordIdentifier } from '@warp-drive/core-types';

packages/graph/src/-private/graph.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 import { LOG_GRAPH } from '@ember-data/debugging';
 import { DEBUG } from '@ember-data/env';

packages/graph/src/-private/operations/add-to-related-records.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 import type { StableRecordIdentifier } from '@warp-drive/core-types';
 import type { AddToRelatedRecordsOperation } from '@warp-drive/core-types/graph';

packages/graph/src/-private/operations/remove-from-related-records.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 import type { StableRecordIdentifier } from '@warp-drive/core-types';
 import type { RemoveFromRelatedRecordsOperation } from '@warp-drive/core-types/graph';

packages/json-api/src/-private/builders/save-record.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 import { pluralize } from 'ember-inflector';
 

packages/json-api/src/-private/cache.ts

@@ -1,7 +1,7 @@
 /**
  * @module @ember-data/json-api
  */
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 import { LOG_MUTATIONS, LOG_OPERATIONS, LOG_REQUESTS } from '@ember-data/debugging';
 import { DEPRECATE_RELATIONSHIP_REMOTE_UPDATE_CLEARING_LOCAL_STATE } from '@ember-data/deprecations';

packages/json-api/src/-private/serialize.ts

@@ -1,7 +1,7 @@
 /**
  * @module @ember-data/json-api/request
  */
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 import type { AttributesHash, JsonApiResource } from '@ember-data/store/-types/q/record-data-json-api';
 import type { StableRecordIdentifier } from '@warp-drive/core-types';

packages/legacy-compat/src/index.ts

@@ -1,6 +1,6 @@
 import { getOwner } from '@ember/application';
-import { assert } from '@ember/debug';
 
+import { assert } from '@ember-data/macros';
 import type Store from '@ember-data/store';
 import { recordIdentifierFor } from '@ember-data/store';
 import { _deprecatingNormalize } from '@ember-data/store/-private';

packages/legacy-compat/src/legacy-network-handler/identifier-has-id.ts

@@ -1,5 +1,4 @@
-import { assert } from '@ember/debug';
-
+import { assert } from '@ember-data/macros';
 import type { StableExistingRecordIdentifier } from '@warp-drive/core-types/identifier';
 
 export function assertIdentifierHasId(identifier: unknown): asserts identifier is StableExistingRecordIdentifier {

packages/legacy-compat/src/legacy-network-handler/legacy-data-fetch.js

@@ -1,6 +1,5 @@
-import { assert } from '@ember/debug';
-
 import { DEBUG } from '@ember-data/env';
+import { assert } from '@ember-data/macros';
 
 import { iterateData, payloadIsNotBlank } from './legacy-data-utils';
 import { normalizeResponseHelper } from './serializer-response';

packages/legacy-compat/src/legacy-network-handler/legacy-network-handler.ts

@@ -1,9 +1,8 @@
-import { assert } from '@ember/debug';
-
 import { importSync } from '@embroider/macros';
 
 import { LOG_PAYLOADS } from '@ember-data/debugging';
 import { DEBUG, TESTING } from '@ember-data/env';
+import { assert } from '@ember-data/macros';
 import type { Future, Handler, NextFn, StructuredDataDocument } from '@ember-data/request';
 import type Store from '@ember-data/store';
 import type { StoreRequestContext, StoreRequestInfo } from '@ember-data/store/-private/cache-handler';

packages/legacy-compat/src/legacy-network-handler/serializer-response.ts

@@ -1,6 +1,5 @@
-import { assert } from '@ember/debug';
-
 import { DEBUG } from '@ember-data/env';
+import { assert } from '@ember-data/macros';
 import type Store from '@ember-data/store';
 import type { ModelSchema } from '@ember-data/store/-types/q/ds-model';
 import type { JsonApiDocument } from '@warp-drive/core-types/spec/raw';

packages/legacy-compat/src/legacy-network-handler/snapshot.ts

@@ -1,13 +1,12 @@
 /**
   @module @ember-data/store
 */
-import { assert } from '@ember/debug';
-
 import { importSync } from '@embroider/macros';
 
 import { DEBUG } from '@ember-data/env';
 import type { CollectionEdge } from '@ember-data/graph/-private/edges/collection';
 import type { ResourceEdge } from '@ember-data/graph/-private/edges/resource';
+import { assert } from '@ember-data/macros';
 import { HAS_JSON_API_PACKAGE } from '@ember-data/packages';
 import type Store from '@ember-data/store';
 import type { RecordInstance } from '@ember-data/store/-types/q/record-instance';

packages/model/src/-private/attr.js

@@ -1,7 +1,7 @@
-import { assert } from '@ember/debug';
 import { computed } from '@ember/object';
 
 import { DEBUG } from '@ember-data/env';
+import { assert } from '@ember-data/macros';
 import { recordIdentifierFor } from '@ember-data/store';
 import { peekCache } from '@ember-data/store/-private';
 

packages/model/src/-private/debug/assert-polymorphic-type.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 import { DEBUG } from '@ember-data/env';
 import type { StableRecordIdentifier } from '@warp-drive/core-types';
 import type Store from '@ember-data/store';

packages/model/src/-private/hooks.ts

@@ -1,6 +1,6 @@
 import { getOwner, setOwner } from '@ember/application';
-import { assert } from '@ember/debug';
 
+import { assert } from '@ember-data/macros';
 import { setCacheFor, setRecordIdentifier, type Store, StoreMap } from '@ember-data/store/-private';
 import type { StableRecordIdentifier } from '@warp-drive/core-types';
 import type { Cache } from '@warp-drive/core-types/cache';

packages/model/src/-private/legacy-relationships-support.ts

@@ -1,5 +1,3 @@
-import { assert } from '@ember/debug';
-
 import { importSync } from '@embroider/macros';
 
 import { DEBUG } from '@ember-data/env';
@@ -8,6 +6,7 @@ import type { CollectionEdge } from '@ember-data/graph/-private/edges/collection
 import type { ResourceEdge } from '@ember-data/graph/-private/edges/resource';
 import type { Graph, GraphEdge } from '@ember-data/graph/-private/graph';
 import { upgradeStore } from '@ember-data/legacy-compat/-private';
+import { assert } from '@ember-data/macros';
 import { HAS_JSON_API_PACKAGE } from '@ember-data/packages';
 import type Store from '@ember-data/store';
 import {

packages/model/src/-private/many-array.ts

@@ -1,7 +1,7 @@
 /**
   @module @ember-data/store
 */
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 import type Store from '@ember-data/store';
 import {

packages/model/src/-private/model-methods.ts

@@ -1,8 +1,7 @@
-import { assert } from '@ember/debug';
-
 import { importSync } from '@embroider/macros';
 
 import { upgradeStore } from '@ember-data/legacy-compat/-private';
+import { assert } from '@ember-data/macros';
 import type Store from '@ember-data/store';
 import { recordIdentifierFor } from '@ember-data/store';
 import { peekCache } from '@ember-data/store/-private';

packages/model/src/-private/notify-changes.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 import { cacheFor } from '@ember/object/internals';
 
 import type Store from '@ember-data/store';

packages/model/src/-private/promise-belongs-to.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 import { computed } from '@ember/object';
 import type PromiseProxyMixin from '@ember/object/promise-proxy-mixin';
 import type ObjectProxy from '@ember/object/proxy';

packages/model/src/-private/promise-many-array.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 import { DEPRECATE_COMPUTED_CHAINS } from '@ember-data/deprecations';
 import type { FindOptions } from '@ember-data/store/-types/q/store';

packages/model/src/-private/record-state.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 import type Store from '@ember-data/store';
 import { storeFor } from '@ember-data/store';

packages/model/src/-private/references/has-many.ts

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert } from '@ember-data/macros';
 
 import { DEBUG } from '@ember-data/env';
 import type { CollectionEdge } from '@ember-data/graph/-private/edges/collection';

packages/model/src/migration-support.ts

@@ -1,5 +1,4 @@
-import { assert } from '@ember/debug';
-
+import { assert } from '@ember-data/macros';
 import { recordIdentifierFor } from '@ember-data/store';
 import type { FieldSchema } from '@ember-data/store/-types/q/schema-service';
 

packages/private-build-infra/src/transforms/babel-plugin-transform-debug-macros/index.js

@@ -0,0 +1,72 @@
+const { ImportUtil } = require('babel-import-util');
+
+const Utils = new Set(['assert']);
+
+function buildAssertFn(t) {
+  return t.functionDeclaration(
+    t.identifier('assert'),
+    [t.identifier('desc'), t.identifier('test')],
+    t.blockStatement([
+      t.ifStatement(
+        t.unaryExpression('!', t.identifier('test')),
+        t.blockStatement([
+          t.throwStatement(
+            t.newExpression(t.identifier('Error'), [
+              t.identifier('desc')
+            ])
+          ),
+        ])
+      ),
+    ])
+  );
+}
+
+function findInsertionPoint(path) {
+  const program = path.parent;
+  let lastNode = null;
+  for (const node of program.body) {
+    if (node.type !== 'ImportDeclaration') {
+      return lastNode;
+    }
+    lastNode = node;
+  }
+  return lastNode;
+}
+
+module.exports = function (babel) {
+  const { types: t } = babel;
+
+  return {
+    name: 'ast-transform', // not required
+    visitor: {
+      ImportDeclaration(path, state) {
+        const importPath = path.node.source.value;
+
+        if (importPath === '@ember-data/macros') {
+          const specifiers = path.get('specifiers');
+          const insertLocation = findInsertionPoint(path);
+
+          specifiers.forEach((specifier) => {
+            const name = specifier.node.imported.name;
+            if (!Utils.has(name)) {
+              throw new Error(`Unexpected import '${name}' imported from '@ember-data/macros'`);
+            }
+
+            if (name === 'assert') {
+              const fn = buildAssertFn(t);
+              const index = path.parent.body.indexOf(insertLocation) + 1;
+              path.parent.body.splice(index, 0, fn);
+              specifier.remove();
+            }
+          });
+
+          if (specifiers.length === 0) path.remove();
+        }
+      },
+
+      Program(path, state) {
+        state.importer = new ImportUtil(t, path);
+      },
+    },
+  };
+};

packages/private-build-infra/virtual-packages/macros.d.ts

@@ -0,0 +1,24 @@
+
+export function assert(message: string): never;
+export function assert(message: string, condition: unknown): asserts condition;
+
+interface Available {
+  available: string;
+}
+interface Enabled extends Available {
+  enabled: string;
+}
+interface DeprecationOptions {
+  id: string;
+  until: string;
+  url?: string;
+  for: string;
+  since: Available | Enabled;
+}
+
+// not available yet so not exported
+function deprecate(
+  message: string,
+  test?: boolean,
+  options?: DeprecationOptions
+): void;

packages/request-utils/src/index.ts

@@ -1,5 +1,6 @@
-import { assert, deprecate } from '@ember/debug';
+import { deprecate } from '@ember/debug';
 
+import { assert } from '@ember-data/macros';
 import type { Cache } from '@warp-drive/core-types/cache';
 import type { StableDocumentIdentifier } from '@warp-drive/core-types/identifier';
 import type { QueryParamsSerializationOptions, QueryParamsSource, Serializable } from '@warp-drive/core-types/params';

packages/rest/src/-private/builders/save-record.ts

@@ -1,8 +1,8 @@
-import { assert } from '@ember/debug';
 import { camelize } from '@ember/string';
 
 import { pluralize } from 'ember-inflector';
 
+import { assert } from '@ember-data/macros';
 import {
   buildBaseURL,
   type CreateRecordUrlOptions,