feat: deprecate createWebhooksApi()

src/index.ts

@@ -65,7 +65,13 @@ class Webhooks<TTransformed> {
   }
 }
 
-const createWebhooksApi = Webhooks.prototype.constructor;
+/** @deprecated `createWebhooksApi()` is deprecated and will be removed in a future release of `@octokit/webhooks`, please use the `Webhooks` class instead */
+const createWebhooksApi = <TTransformed>(options: Options<TTransformed>) => {
+  console.error(
+    "[@octokit/webhooks] `createWebhooksApi()` is deprecated and will be removed in a future release of `@octokit/webhooks`, please use the `Webhooks` class instead"
+  );
+  return new Webhooks<TTransformed>(options);
+};
 
 export {
   createEventHandler,

test/typescript-validate.ts

@@ -2,7 +2,6 @@ import {
   Webhooks,
   createEventHandler,
   createMiddleware,
-  createWebhooksApi,
   sign,
   verify,
   EmitterWebhookEvent,
@@ -78,11 +77,6 @@ export default async function () {
     },
   });
 
-  // Check named exports of new API work
-  createWebhooksApi({
-    secret: "blah",
-  });
-
   createEventHandler({ secret: "blah" });
 
   createMiddleware({

test/unit/deprecation.test.ts

@@ -0,0 +1,12 @@
+import { createWebhooksApi } from "../../src";
+
+describe("Deprecated methods", () => {
+  test("createWebhooksApi", () => {
+    const spy = jest.spyOn(console, "error");
+    createWebhooksApi({ secret: "foo" });
+    expect(spy).toBeCalledWith(
+      "[@octokit/webhooks] `createWebhooksApi()` is deprecated and will be removed in a future release of `@octokit/webhooks`, please use the `Webhooks` class instead"
+    );
+    spy.mockClear();
+  });
+});