add script to deprecate AS2/AS3 packages (#7154)

Author: glasser

cspell-dict.txt

@@ -81,6 +81,7 @@ graphqlcodegenerator
 GraphQLJSON
 gzipped
 hackily
+hapi
 herokuapp
 Hofmann
 hrtime

scripts/deprecate-old-versions.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+
+# As far as we can tell, `npm deprecate` only deprecates currently existing
+# package versions. Whenever we publish a backport to AS2/AS3, the latest
+# version will end up not deprecated! So after publishing backport versions, we
+# run this script (with apollo-bot credentials). As far as we can tell you can't
+# use npm tokens for this so it requires you to enter a ton of OTPs. Fun!
+# https://stackoverflow.com/questions/74466186/keeping-npm-deprecated-packages-deprecated
+
+set -e
+
+with_replacement() {
+  npm deprecate $1 'The `'"$1"'` package is part of Apollo Server v2 and v3, which are now deprecated (end-of-life October 22nd 2023). This package'"'"'s functionality is now found in the `'"$2"'` package. See https://www.apollographql.com/docs/apollo-server/previous-versions/ for more details.'
+}
+
+with_replacement apollo-server @apollo/server
+with_replacement apollo-server-core @apollo/server
+with_replacement apollo-server-express @apollo/server
+with_replacement apollo-server-errors @apollo/server
+with_replacement apollo-server-plugin-base @apollo/server
+with_replacement apollo-server-types @apollo/server
+with_replacement apollo-datasource-rest @apollo/datasource-rest
+with_replacement apollo-reporting-protobuf @apollo/usage-reporting-protobuf
+with_replacement apollo-server-env @apollo/utils.fetcher
+with_replacement apollo-server-plugin-response-cache @apollo/server-plugin-response-cache
+with_replacement apollo-server-azure-functions @apollo/server
+with_replacement apollo-server-cloud-functions @apollo/server
+with_replacement apollo-server-cloudflare @apollo/server
+with_replacement apollo-server-fastify @apollo/server
+with_replacement apollo-server-hapi @apollo/server
+with_replacement apollo-server-koa @apollo/server
+with_replacement apollo-server-lambda @apollo/server
+with_replacement apollo-server-micro @apollo/server
+
+# This package isn't exactly replaced, so leave that sentence off.
+npm deprecate apollo-datasource 'The `apollo-datasource` package is part of Apollo Server v2 and v3, which are now deprecated (end-of-life October 22nd 2023). See https://www.apollographql.com/docs/apollo-server/previous-versions/ for more details.'
+
+caching() {
+  npm deprecate $1 'This package is part of the legacy caching implementation used by Apollo Server v2 and v3, and is no longer maintained. We recommend you switch to the newer Keyv-based implementation (which is compatible with all versions of Apollo Server). See https://www.apollographql.com/docs/apollo-server/v3/performance/cache-backends#legacy-caching-implementation for more details.'
+}
+
+caching apollo-server-caching
+caching apollo-server-cache-memcached
+caching apollo-server-cache-redis