Warn consumers about incorrect usage

packages/core-data/package.json

@@ -47,6 +47,7 @@
 		"@wordpress/sync": "file:../sync",
 		"@wordpress/undo-manager": "file:../undo-manager",
 		"@wordpress/url": "file:../url",
+		"@wordpress/warning": "file:../warning",
 		"change-case": "^4.1.2",
 		"equivalent-key-map": "^0.2.2",
 		"fast-deep-equal": "^3.1.3",

packages/core-data/src/hooks/test/use-resource-permissions.js

@@ -164,4 +164,26 @@ describe( 'useResourcePermissions', () => {
 			} )
 		);
 	} );
+
+	it( 'should warn when called with incorrect arguments signature', () => {
+		const TestComponent = () => {
+			useResourcePermissions(
+				{
+					kind: 'root',
+					name: 'media',
+				},
+				1
+			);
+			return null;
+		};
+		render(
+			<RegistryProvider value={ registry }>
+				<TestComponent />
+			</RegistryProvider>
+		);
+
+		expect( console ).toHaveWarnedWith(
+			`When 'resource' is an entity object, passing 'id' as a separate argument isn't supported.`
+		);
+	} );
 } );

packages/core-data/src/hooks/use-resource-permissions.ts

@@ -2,6 +2,7 @@
  * WordPress dependencies
  */
 import deprecated from '@wordpress/deprecated';
+import warning from '@wordpress/warning';
 
 /**
  * Internal dependencies
@@ -134,9 +135,15 @@ function useResourcePermissions< IdType = void >(
 	const resourceAsString =
 		typeof resource === 'object' ? JSON.stringify( resource ) : resource;
 
+	const isEntity = typeof resource === 'object';
+	if ( isEntity && typeof id !== 'undefined' ) {
+		warning(
+			`When 'resource' is an entity object, passing 'id' as a separate argument isn't supported.`
+		);
+	}
+
 	return useQuerySelect(
 		( resolve ) => {
-			const isEntity = typeof resource === 'object';
 			const hasId = isEntity ? !! resource.id : !! id;
 			const { canUser } = resolve( coreStore );
 			const create = canUser(