chores: tsconfig module: node20 and import extensions

compat-test/quick-start.spec.ts

@@ -8,7 +8,7 @@ import {
   expect,
   test,
 } from "vitest";
-import { givePort } from "../tools/ports";
+import { givePort } from "../tools/ports.ts";
 
 describe("ESM Test", async () => {
   let out = "";

eslint.config.js

@@ -24,6 +24,10 @@ const importConcerns = [
     selector: "ImportDeclaration[source.value=/^zod/] > ImportDefaultSpecifier",
     message: "do import { z } instead",
   },
+  {
+    selector: "ImportDeclaration[source.value=/\\.js$/]",
+    message: "use .ts extension for relative imports",
+  },
   ...builtinModules.map((mod) => ({
     selector: `ImportDeclaration[source.value='${mod}']`,
     message: `use node:${mod} for the built-in module`,
@@ -64,6 +68,10 @@ const performanceConcerns = [
     selector: "MemberExpression[object.name='R'] > Identifier[name='union']", // #2599
     message: "R.union() is 1.5x slower than [...Set().add()]",
   },
+  {
+    selector: "ImportDeclaration[source.value=/package.json$/]", // #2974
+    message: "it can not be tree shaken, use tsdown and process.env instead",
+  },
 ];
 
 const tsFactoryConcerns = [

esm-test/quick-start.spec.ts

@@ -1,5 +1,5 @@
 import { spawn } from "node:child_process";
-import { givePort } from "../tools/ports";
+import { givePort } from "../tools/ports.ts";
 
 describe("ESM Test", async () => {
   let out = "";

example/config.ts

@@ -1,7 +1,7 @@
 import { BuiltinLogger, createConfig } from "express-zod-api";
 import ui from "swagger-ui-express";
 import createHttpError from "http-errors";
-import { givePort } from "../tools/ports";
+import { givePort } from "../tools/ports.ts";
 import qs from "qs";
 
 export const config = createConfig({

example/endpoints/create-user.ts

@@ -1,7 +1,7 @@
 import createHttpError from "http-errors";
 import assert from "node:assert/strict";
 import { z } from "zod";
-import { statusDependingFactory } from "../factories";
+import { statusDependingFactory } from "../factories.ts";
 
 const namePart = z.string().regex(/^\w+$/);
 

example/endpoints/delete-user.ts

@@ -1,7 +1,7 @@
 import createHttpError from "http-errors";
 import assert from "node:assert/strict";
 import { z } from "zod";
-import { noContentFactory } from "../factories";
+import { noContentFactory } from "../factories.ts";
 
 /** @desc The endpoint demonstrates no content response established by its factory */
 export const deleteUserEndpoint = noContentFactory.buildVoid({

example/endpoints/list-users.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { arrayRespondingFactory } from "../factories";
+import { arrayRespondingFactory } from "../factories.ts";
 
 const roleSchema = z.enum(["manager", "operator", "admin"]);
 

example/endpoints/retrieve-user.ts

@@ -2,7 +2,7 @@ import createHttpError from "http-errors";
 import assert from "node:assert/strict";
 import { z } from "zod";
 import { defaultEndpointsFactory } from "express-zod-api";
-import { methodProviderMiddleware } from "../middlewares";
+import { methodProviderMiddleware } from "../middlewares.ts";
 
 // Demonstrating circular schemas using z.object()
 const feature = z.object({

example/endpoints/send-avatar.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { fileSendingEndpointsFactory } from "../factories";
+import { fileSendingEndpointsFactory } from "../factories.ts";
 import { readFile } from "node:fs/promises";
 
 export const sendAvatarEndpoint = fileSendingEndpointsFactory.build({

example/endpoints/stream-avatar.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { fileStreamingEndpointsFactory } from "../factories";
+import { fileStreamingEndpointsFactory } from "../factories.ts";
 
 export const streamAvatarEndpoint = fileStreamingEndpointsFactory.build({
   shortDescription: "Streams a file content.",

example/endpoints/time-subscription.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { setTimeout } from "node:timers/promises";
-import { eventsFactory } from "../factories";
+import { eventsFactory } from "../factories.ts";
 
 /** @desc The endpoint demonstrates emitting server-sent events (SSE) */
 export const subscriptionEndpoint = eventsFactory.buildVoid({

example/endpoints/update-user.ts

@@ -2,7 +2,7 @@ import createHttpError from "http-errors";
 import assert from "node:assert/strict";
 import { z } from "zod";
 import { ez } from "express-zod-api";
-import { keyAndTokenAuthenticatedEndpointsFactory } from "../factories";
+import { keyAndTokenAuthenticatedEndpointsFactory } from "../factories.ts";
 
 export const updateUserEndpoint =
   keyAndTokenAuthenticatedEndpointsFactory.build({

example/factories.ts

@@ -7,7 +7,7 @@ import {
   EventStreamFactory,
   defaultEndpointsFactory,
 } from "express-zod-api";
-import { authMiddleware } from "./middlewares";
+import { authMiddleware } from "./middlewares.ts";
 import { createReadStream } from "node:fs";
 import { z } from "zod";
 import { stat } from "node:fs/promises";

example/generate-client.ts

@@ -1,7 +1,7 @@
 import { writeFile } from "node:fs/promises";
 import { Integration } from "express-zod-api";
-import { routing } from "./routing";
-import { config } from "./config";
+import { routing } from "./routing.ts";
+import { config } from "./config.ts";
 
 await writeFile(
   "example.client.ts",

example/generate-documentation.ts

@@ -1,8 +1,8 @@
 import { writeFile } from "node:fs/promises";
 import { Documentation } from "express-zod-api";
-import { config } from "./config";
-import { routing } from "./routing";
-import manifest from "./package.json";
+import { config } from "./config.ts";
+import { routing } from "./routing.ts";
+import manifest from "./package.json" with { type: "json" };
 
 await writeFile(
   "example.documentation.yaml",

example/index.spec.ts

@@ -1,8 +1,8 @@
 import assert from "node:assert/strict";
 import { spawn } from "node:child_process";
 import { createReadStream, readFileSync } from "node:fs";
-import { Client, Subscription } from "./example.client";
-import { givePort } from "../tools/ports";
+import { Client, Subscription } from "./example.client.ts";
+import { givePort } from "../tools/ports.ts";
 import { createHash } from "node:crypto";
 import { readFile } from "node:fs/promises";
 import { fail } from "node:assert";

example/index.ts

@@ -1,6 +1,6 @@
 import { createServer } from "express-zod-api";
-import { config } from "./config";
-import { routing } from "./routing";
+import { config } from "./config.ts";
+import { routing } from "./routing.ts";
 
 /**
  * "await" is only needed for using entities returned from this method.

example/routing.ts

@@ -1,15 +1,15 @@
 import { DependsOnMethod, Routing, ServeStatic } from "express-zod-api";
-import { rawAcceptingEndpoint } from "./endpoints/accept-raw";
-import { createUserEndpoint } from "./endpoints/create-user";
-import { deleteUserEndpoint } from "./endpoints/delete-user";
-import { listUsersEndpoint } from "./endpoints/list-users";
-import { submitFeedbackEndpoint } from "./endpoints/submit-feedback";
-import { subscriptionEndpoint } from "./endpoints/time-subscription";
-import { uploadAvatarEndpoint } from "./endpoints/upload-avatar";
-import { retrieveUserEndpoint } from "./endpoints/retrieve-user";
-import { sendAvatarEndpoint } from "./endpoints/send-avatar";
-import { updateUserEndpoint } from "./endpoints/update-user";
-import { streamAvatarEndpoint } from "./endpoints/stream-avatar";
+import { rawAcceptingEndpoint } from "./endpoints/accept-raw.ts";
+import { createUserEndpoint } from "./endpoints/create-user.ts";
+import { deleteUserEndpoint } from "./endpoints/delete-user.ts";
+import { listUsersEndpoint } from "./endpoints/list-users.ts";
+import { submitFeedbackEndpoint } from "./endpoints/submit-feedback.ts";
+import { subscriptionEndpoint } from "./endpoints/time-subscription.ts";
+import { uploadAvatarEndpoint } from "./endpoints/upload-avatar.ts";
+import { retrieveUserEndpoint } from "./endpoints/retrieve-user.ts";
+import { sendAvatarEndpoint } from "./endpoints/send-avatar.ts";
+import { updateUserEndpoint } from "./endpoints/update-user.ts";
+import { streamAvatarEndpoint } from "./endpoints/stream-avatar.ts";
 
 export const routing: Routing = {
   v1: {

example/tsconfig.json

@@ -1,7 +1,3 @@
 {
-  "extends": "../tsconfig.json",
-  "compilerOptions": {
-    "module": "ES2022",
-    "moduleResolution": "Bundler"
-  }
+  "extends": "../tsconfig.json"
 }

express-zod-api/src/builtin-logger.ts

@@ -1,14 +1,14 @@
 import ansis from "ansis";
 import { inspect } from "node:util";
 import { performance } from "node:perf_hooks";
-import { FlatObject, isProduction } from "./common-helpers";
+import { FlatObject, isProduction } from "./common-helpers.ts";
 import {
   AbstractLogger,
   formatDuration,
   isHidden,
   Severity,
   styles,
-} from "./logger-helpers";
+} from "./logger-helpers.ts";
 
 interface Context extends FlatObject {
   requestId?: string;

express-zod-api/src/common-helpers.ts

@@ -1,16 +1,16 @@
 import { Request } from "express";
 import * as R from "ramda";
 import { z } from "zod";
-import { CommonConfig, InputSource, InputSources } from "./config-type";
-import { contentTypes } from "./content-type";
+import { CommonConfig, InputSource, InputSources } from "./config-type.ts";
+import { contentTypes } from "./content-type.ts";
 import {
   ClientMethod,
   SomeMethod,
   isMethod,
   Method,
   CORSMethod,
-} from "./method";
-import { NormalizedResponse } from "./api-response";
+} from "./method.ts";
+import { NormalizedResponse } from "./api-response.ts";
 
 /** @since zod 3.25.61 output type fixed */
 export const emptySchema = z.object({});

express-zod-api/src/config-type.ts

@@ -2,13 +2,13 @@ import type compression from "compression";
 import { IRouter, Request, RequestHandler } from "express";
 import type fileUpload from "express-fileupload";
 import { ServerOptions } from "node:https";
-import { BuiltinLoggerConfig } from "./builtin-logger";
-import { AbstractEndpoint } from "./endpoint";
-import { AbstractLogger, ActualLogger } from "./logger-helpers";
-import { Method } from "./method";
-import { AbstractResultHandler } from "./result-handler";
+import { BuiltinLoggerConfig } from "./builtin-logger.ts";
+import { AbstractEndpoint } from "./endpoint.ts";
+import { AbstractLogger, ActualLogger } from "./logger-helpers.ts";
+import { Method } from "./method.ts";
+import { AbstractResultHandler } from "./result-handler.ts";
 import { ListenOptions } from "node:net";
-import { GetLogger } from "./server-helpers";
+import { GetLogger } from "./server-helpers.ts";
 
 export type InputSource = keyof Pick<
   Request,

express-zod-api/src/deep-checks.ts

@@ -1,15 +1,15 @@
 import * as R from "ramda";
 import { z } from "zod";
-import { ezBufferBrand } from "./buffer-schema";
-import { ezDateInBrand } from "./date-in-schema";
-import { ezDateOutBrand } from "./date-out-schema";
-import { DeepCheckError } from "./errors";
-import { ezFormBrand } from "./form-schema";
-import { IOSchema } from "./io-schema";
+import { ezBufferBrand } from "./buffer-schema.ts";
+import { ezDateInBrand } from "./date-in-schema.ts";
+import { ezDateOutBrand } from "./date-out-schema.ts";
+import { DeepCheckError } from "./errors.ts";
+import { ezFormBrand } from "./form-schema.ts";
+import { IOSchema } from "./io-schema.ts";
 import { getBrand } from "@express-zod-api/zod-plugin";
-import { FirstPartyKind } from "./schema-walker";
-import { ezUploadBrand } from "./upload-schema";
-import { ezRawBrand } from "./raw-schema";
+import { FirstPartyKind } from "./schema-walker.ts";
+import { ezUploadBrand } from "./upload-schema.ts";
+import { ezRawBrand } from "./raw-schema.ts";
 
 interface NestedSchemaLookupProps {
   io: "input" | "output";

express-zod-api/src/depends-on-method.ts

@@ -1,7 +1,7 @@
 import * as R from "ramda";
-import { AbstractEndpoint } from "./endpoint";
-import { Method } from "./method";
-import { Routable } from "./routable";
+import { AbstractEndpoint } from "./endpoint.ts";
+import { Method } from "./method.ts";
+import { Routable } from "./routable.ts";
 
 export class DependsOnMethod extends Routable {
   readonly #endpoints: ConstructorParameters<typeof DependsOnMethod>[0];

express-zod-api/src/diagnostics.ts

@@ -1,11 +1,11 @@
 import { z } from "zod";
-import { responseVariants } from "./api-response";
-import { FlatObject, getRoutePathParams } from "./common-helpers";
-import { contentTypes } from "./content-type";
-import { findJsonIncompatible } from "./deep-checks";
-import { AbstractEndpoint } from "./endpoint";
-import { flattenIO } from "./json-schema-helpers";
-import { ActualLogger } from "./logger-helpers";
+import { responseVariants } from "./api-response.ts";
+import { FlatObject, getRoutePathParams } from "./common-helpers.ts";
+import { contentTypes } from "./content-type.ts";
+import { findJsonIncompatible } from "./deep-checks.ts";
+import { AbstractEndpoint } from "./endpoint.ts";
+import { flattenIO } from "./json-schema-helpers.ts";
+import { ActualLogger } from "./logger-helpers.ts";
 
 export class Diagnostics {
   #verifiedEndpoints = new WeakSet<AbstractEndpoint>();

express-zod-api/src/documentation-helpers.ts

@@ -16,8 +16,8 @@ import {
 } from "openapi3-ts/oas31";
 import * as R from "ramda";
 import { z } from "zod";
-import { NormalizedResponse, ResponseVariant } from "./api-response";
-import { ezBufferBrand } from "./buffer-schema";
+import { NormalizedResponse, ResponseVariant } from "./api-response.ts";
+import { ezBufferBrand } from "./buffer-schema.ts";
 import {
   shouldHaveContent,
   FlatObject,
@@ -29,23 +29,23 @@ import {
   routePathParamsRegex,
   Tag,
   ucFirst,
-} from "./common-helpers";
-import { InputSource } from "./config-type";
-import { contentTypes } from "./content-type";
-import { ezDateInBrand } from "./date-in-schema";
-import { ezDateOutBrand } from "./date-out-schema";
-import { DocumentationError } from "./errors";
-import { IOSchema } from "./io-schema";
-import { flattenIO } from "./json-schema-helpers";
-import { Alternatives } from "./logical-container";
+} from "./common-helpers.ts";
+import { InputSource } from "./config-type.ts";
+import { contentTypes } from "./content-type.ts";
+import { ezDateInBrand } from "./date-in-schema.ts";
+import { ezDateOutBrand } from "./date-out-schema.ts";
+import { DocumentationError } from "./errors.ts";
+import { IOSchema } from "./io-schema.ts";
+import { flattenIO } from "./json-schema-helpers.ts";
+import { Alternatives } from "./logical-container.ts";
 import { getBrand } from "@express-zod-api/zod-plugin";
-import { ClientMethod } from "./method";
-import { ProprietaryBrand } from "./proprietary-schemas";
-import { ezRawBrand } from "./raw-schema";
-import { FirstPartyKind } from "./schema-walker";
-import { Security } from "./security";
-import { ezUploadBrand } from "./upload-schema";
-import wellKnownHeaders from "./well-known-headers.json";
+import { ClientMethod } from "./method.ts";
+import { ProprietaryBrand } from "./proprietary-schemas.ts";
+import { ezRawBrand } from "./raw-schema.ts";
+import { FirstPartyKind } from "./schema-walker.ts";
+import { Security } from "./security.ts";
+import { ezUploadBrand } from "./upload-schema.ts";
+import wellKnownHeaders from "./well-known-headers.json" with { type: "json" };
 
 interface ReqResCommons {
   makeRef: (