refactor: use full relative paths in imports (#552)

* refactor: use full relative paths

This should help bring ESM compatibility in the future

* chore: update jest config to correctly resolve modules

* fix: add some missing file extensions

* test: run the `validate:ts` script with `allowImportingTsExtensions`

* build: use `node:` specifier imports

* chore: switch to use `.js` imports in source

jest.config.ts

@@ -11,12 +11,17 @@ const config: Config.InitialOptions = {
     },
   },
   transform: {
-    "^.+\\.tsx?$": ["ts-jest",
+    "^.+\\.tsx?$": [
+      "ts-jest",
       {
         tsconfig: "test/tsconfig.json",
-      }
+      },
     ],
   },
+  moduleNameMapper: {
+    "ipaddr.js": "<rootDir>/node_modules/ipaddr.js/lib/ipaddr.js",
+    "^(.+)\\.jsx?$": "$1",
+  },
   restoreMocks: true,
   testEnvironment: "node",
   testRegex: /test\/.*\/.*.test.ts/u.source,

package.json

@@ -14,7 +14,7 @@
     "lint:fix": "prettier --write 'src/**/*.{ts,json}' 'scripts/**/*' 'test/**/*.ts' README.md package.json",
     "pretest": "npm run -s lint",
     "test": "jest --coverage",
-    "validate:ts": "tsc --noEmit --noImplicitAny --target es2020 --esModuleInterop --moduleResolution node test/typescript-validate.ts"
+    "validate:ts": "tsc --noEmit --noImplicitAny --target es2020 --esModuleInterop --moduleResolution node16 --module node16 --allowImportingTsExtensions test/typescript-validate.ts"
   },
   "prettier": {},
   "release": {

scripts/build.mjs

@@ -1,5 +1,5 @@
 import esbuild from "esbuild";
-import { copyFile, readFile, writeFile, rm } from "fs/promises";
+import { copyFile, readFile, writeFile, rm } from "node:fs/promises";
 import { glob } from "glob";
 
 const sharedOptions = {

scripts/generate-types.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env ts-node-transpile-only
 
-import { strict as assert } from "assert";
-import * as fs from "fs";
+import { strict as assert } from "node:assert";
+import * as fs from "node:fs";
 import type { JSONSchema7, JSONSchema7Definition } from "json-schema";
 import { format } from "prettier";
 

src/event-handler/index.ts

@@ -1,19 +1,19 @@
-import { createLogger } from "../createLogger";
+import { createLogger } from "../createLogger.js";
 import type {
   EmitterWebhookEvent,
   EmitterWebhookEventName,
   HandlerFunction,
   Options,
   State,
   WebhookEventHandlerError,
-} from "../types";
+} from "../types.js";
 import {
   receiverOn as on,
   receiverOnAny as onAny,
   receiverOnError as onError,
-} from "./on";
-import { receiverHandle as receive } from "./receive";
-import { removeListener } from "./remove-listener";
+} from "./on.js";
+import { receiverHandle as receive } from "./receive.js";
+import { removeListener } from "./remove-listener.js";
 
 interface EventHandler<TTransformed> {
   on<E extends EmitterWebhookEventName>(

src/event-handler/on.ts

@@ -1,10 +1,10 @@
-import { emitterEventNames } from "../generated/webhook-names";
+import { emitterEventNames } from "../generated/webhook-names.js";
 import type {
   EmitterWebhookEvent,
   EmitterWebhookEventName,
   State,
   WebhookEventHandlerError,
-} from "../types";
+} from "../types.js";
 
 function handleEventHandlers(
   state: State,

src/event-handler/receive.ts

@@ -6,8 +6,8 @@ import type {
   State,
   WebhookError,
   WebhookEventHandlerError,
-} from "../types";
-import { wrapErrorHandler } from "./wrap-error-handler";
+} from "../types.js";
+import { wrapErrorHandler } from "./wrap-error-handler.js";
 
 type EventAction = Extract<
   EmitterWebhookEvent["payload"],

src/event-handler/remove-listener.ts

@@ -1,4 +1,4 @@
-import type { EmitterWebhookEventName, State } from "../types";
+import type { EmitterWebhookEventName, State } from "../types.js";
 
 export function removeListener(
   state: State,

src/index.ts

@@ -1,7 +1,7 @@
-import { createLogger } from "./createLogger";
-import { createEventHandler } from "./event-handler/index";
+import { createLogger } from "./createLogger.js";
+import { createEventHandler } from "./event-handler/index.js";
 import { sign, verify } from "@octokit/webhooks-methods";
-import { verifyAndReceive } from "./verify-and-receive";
+import { verifyAndReceive } from "./verify-and-receive.js";
 import type {
   EmitterWebhookEvent,
   EmitterWebhookEventName,
@@ -12,10 +12,10 @@ import type {
   WebhookError,
   WebhookEventHandlerError,
   EmitterWebhookEventWithStringPayloadAndSignature,
-} from "./types";
+} from "./types.js";
 
-export { createNodeMiddleware } from "./middleware/node/index";
-export { emitterEventNames } from "./generated/webhook-names";
+export { createNodeMiddleware } from "./middleware/node/index.js";
+export { emitterEventNames } from "./generated/webhook-names.js";
 
 // U holds the return value of `transform` function in Options
 class Webhooks<TTransformed = unknown> {

src/middleware/node/index.ts

@@ -1,7 +1,7 @@
-import { createLogger } from "../../createLogger";
-import type { Webhooks } from "../../index";
-import { middleware } from "./middleware";
-import type { MiddlewareOptions } from "./types";
+import { createLogger } from "../../createLogger.js";
+import type { Webhooks } from "../../index.js";
+import { middleware } from "./middleware.js";
+import type { MiddlewareOptions } from "./types.js";
 
 export function createNodeMiddleware(
   webhooks: Webhooks,

src/middleware/node/middleware.ts

@@ -6,12 +6,12 @@ type ServerResponse = any;
 
 import type { WebhookEventName } from "@octokit/webhooks-types";
 
-import type { Webhooks } from "../../index";
-import type { WebhookEventHandlerError } from "../../types";
-import type { MiddlewareOptions } from "./types";
-import { getMissingHeaders } from "./get-missing-headers";
-import { getPayload } from "./get-payload";
-import { onUnhandledRequestDefault } from "./on-unhandled-request-default";
+import type { Webhooks } from "../../index.js";
+import type { WebhookEventHandlerError } from "../../types.js";
+import type { MiddlewareOptions } from "./types.js";
+import { getMissingHeaders } from "./get-missing-headers.js";
+import { getPayload } from "./get-payload.js";
+import { onUnhandledRequestDefault } from "./on-unhandled-request-default.js";
 
 export async function middleware(
   webhooks: Webhooks,

src/middleware/node/types.ts

@@ -1,4 +1,4 @@
-import type { Logger } from "../../createLogger";
+import type { Logger } from "../../createLogger.ts";
 
 export type MiddlewareOptions = {
   path?: string;

src/types.ts

@@ -3,8 +3,8 @@ import type {
   WebhookEventMap,
   WebhookEventName,
 } from "@octokit/webhooks-types";
-import type { Logger } from "./createLogger";
-import type { emitterEventNames } from "./generated/webhook-names";
+import type { Logger } from "./createLogger.ts";
+import type { emitterEventNames } from "./generated/webhook-names.ts";
 
 export type EmitterWebhookEventName = (typeof emitterEventNames)[number];
 export type EmitterWebhookEvent<

src/verify-and-receive.ts

@@ -6,7 +6,7 @@ import type {
   EmitterWebhookEvent,
   EmitterWebhookEventWithStringPayloadAndSignature,
   State,
-} from "./types";
+} from "./types.js";
 
 export async function verifyAndReceive(
   state: State & { secret: string },

test/integration/event-handler-test.ts

@@ -1,6 +1,12 @@
-import { createEventHandler } from "../../src/event-handler";
-import { EmitterWebhookEvent, WebhookEventHandlerError } from "../../src/types";
-import { installationCreatedPayload, pushEventPayload } from "../fixtures";
+import { createEventHandler } from "../../src/event-handler/index.ts";
+import type {
+  EmitterWebhookEvent,
+  WebhookEventHandlerError,
+} from "../../src/types.ts";
+import {
+  installationCreatedPayload,
+  pushEventPayload,
+} from "../fixtures/index.ts";
 
 test("events", async () => {
   const eventHandler = createEventHandler({});

test/integration/node-middleware.test.ts

@@ -1,12 +1,12 @@
-import { createServer } from "http";
-import { readFileSync } from "fs";
+import { createServer } from "node:http";
+import { readFileSync } from "node:fs";
 
 import { sign } from "@octokit/webhooks-methods";
 
 // import without types
 const express = require("express");
 
-import { createNodeMiddleware, Webhooks } from "../../src";
+import { createNodeMiddleware, Webhooks } from "../../src/index.ts";
 
 const pushEventPayload = readFileSync(
   "test/fixtures/push-payload.json",

test/integration/smoke-test.ts

@@ -1,4 +1,8 @@
-import { Webhooks, createEventHandler, emitterEventNames } from "../../src";
+import {
+  Webhooks,
+  createEventHandler,
+  emitterEventNames,
+} from "../../src/index.ts";
 
 test("@octokit/webhooks", () => {
   const emitWarningSpy = jest.spyOn(process, "emitWarning");

test/integration/webhooks.test.ts

@@ -1,8 +1,8 @@
-import { readFileSync } from "fs";
+import { readFileSync } from "node:fs";
 
 import { sign } from "@octokit/webhooks-methods";
 
-import { Webhooks } from "../../src";
+import { Webhooks } from "../../src/index.ts";
 
 const pushEventPayloadString = readFileSync(
   "test/fixtures/push-payload.json",

test/tsconfig.json

@@ -1,7 +1,8 @@
 {
   "extends": "..",
   "compilerOptions": {
-    "verbatimModuleSyntax": false
+    "verbatimModuleSyntax": false,
+    "allowImportingTsExtensions": true
   },
   "include": ["**/*.ts"]
 }

test/typescript-validate.ts

@@ -1,16 +1,16 @@
 import {
   Webhooks,
   createEventHandler,
-  EmitterWebhookEvent,
+  type EmitterWebhookEvent,
   WebhookError,
   createNodeMiddleware,
-} from "../src/index";
+} from "../src/index.ts";
 import { createServer } from "http";
-import {
+import type {
   HandlerFunction,
   RemoveHandlerFunction,
   EmitterWebhookEventName,
-} from "../src/types";
+} from "../src/types.ts";
 
 // ************************************************************
 // THIS CODE IS NOT EXECUTED. IT IS FOR TYPECHECKING ONLY

test/unit/createLogger-test.ts

@@ -1,4 +1,4 @@
-import { createLogger } from "../../src/createLogger";
+import { createLogger } from "../../src/createLogger.ts";
 
 const noop = () => {};
 

test/unit/event-handler-on-test.ts

@@ -1,5 +1,5 @@
-import { receiverOn } from "../../src/event-handler/on";
-import { State } from "../../src/types";
+import { receiverOn } from "../../src/event-handler/on.ts";
+import type { State } from "../../src/types.ts";
 
 function noop() {}
 

test/unit/event-handler-receive-test.ts

@@ -1,5 +1,5 @@
-import { receiverHandle as receive } from "../../src/event-handler/receive";
-import { State } from "../../src/types";
+import { receiverHandle as receive } from "../../src/event-handler/receive.ts";
+import type { State } from "../../src/types.ts";
 
 const state: State = {
   secret: "mysecret",

test/unit/event-handler-remove-listener-test.ts

@@ -1,5 +1,5 @@
-import { removeListener } from "../../src/event-handler/remove-listener";
-import { State } from "../../src/types";
+import { removeListener } from "../../src/event-handler/remove-listener.ts";
+import type { State } from "../../src/types.ts";
 
 test("remove-listener: single listener", () => {
   const push = () => {};

test/unit/event-handler-wrap-error-handler-test.ts

@@ -1,4 +1,4 @@
-import { wrapErrorHandler } from "../../src/event-handler/wrap-error-handler";
+import { wrapErrorHandler } from "../../src/event-handler/wrap-error-handler.ts";
 
 const noop = () => {};