feat: enable publint and attw (#454)

mnahkies · web-flow · commit 4b24679e69ee · 2026-05-04T12:23:42.000Z
enables the linting options documented here https://tsdown.dev/options/lint
diff --git a/e2e/jest.config.cjs b/e2e/jest.config.cjs
@@ -0,0 +1,12 @@
+const base = require("../jest.base")
+const {name: displayName} = require("./package.json")
+
+/**
+ * @type { import('@jest/types').Config.ProjectConfig }
+ */
+const config = {
+  ...base,
+  displayName,
+}
+
+module.exports = config
diff --git a/e2e/jest.config.js b/e2e/jest.config.js
diff --git a/jest.config.js b/jest.config.js
@@ -4,7 +4,7 @@ const inspector = require("node:inspector")
  * @type { import('@jest/types').Config.GlobalConfig }
  */
 const config = {
-  projects: ["packages/*/jest.config.js"],
+  projects: ["packages/*/jest.config.cjs"],
   testTimeout: inspector.url() ? 5 * 60 * 1000 : 5 * 1000,
   reporters: ["./jest/reporter.js"],
 }
diff --git a/package.json b/package.json
@@ -11,7 +11,7 @@
   "homepage": "https://openapi-code-generator.nahkies.co.nz/",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mnahkies/openapi-code-generator.git"
+    "url": "git+https://github.com/mnahkies/openapi-code-generator.git"
   },
   "bugs": {
     "url": "https://github.com/mnahkies/openapi-code-generator/issues"
@@ -39,6 +39,7 @@
     "prepare": "husky"
   },
   "devDependencies": {
+    "@arethetypeswrong/core": "^0.18.2",
     "@biomejs/biome": "2.4.13",
     "@biomejs/js-api": "4.0.0",
     "@biomejs/wasm-nodejs": "2.4.13",
@@ -59,6 +60,7 @@
     "lerna": "^9.0.7",
     "lint-staged": "^16.4.0",
     "prettier": "^3.8.3",
+    "publint": "^0.3.18",
     "remark": "^15.0.1",
     "remark-toc": "^9.0.0",
     "typescript": "^6.0.3"
@@ -69,7 +71,7 @@
     "e2e"
   ],
   "lint-staged": {
-    "*.{ts,js,tsx,jsx}": [
+    "*.{ts,js,tsx,jsx,mts,mjs,cts,cjs}": [
       "pnpm biome lint --write --no-errors-on-unmatched",
       "pnpm biome check --write --no-errors-on-unmatched"
     ],
diff --git a/packages/documentation/package.json b/packages/documentation/package.json
@@ -10,7 +10,7 @@
   "type": "module",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mnahkies/openapi-code-generator.git",
+    "url": "git+https://github.com/mnahkies/openapi-code-generator.git",
     "directory": "packages/documentation"
   },
   "bugs": {
diff --git a/packages/openapi-code-generator/jest.config.cjs b/packages/openapi-code-generator/jest.config.cjs
diff --git a/packages/openapi-code-generator/package.json b/packages/openapi-code-generator/package.json
@@ -10,7 +10,7 @@
   "homepage": "https://openapi-code-generator.nahkies.co.nz/",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mnahkies/openapi-code-generator.git",
+    "url": "git+https://github.com/mnahkies/openapi-code-generator.git",
     "directory": "packages/openapi-code-generator"
   },
   "bugs": {
diff --git a/packages/typescript-axios-runtime/jest.config.cjs b/packages/typescript-axios-runtime/jest.config.cjs
diff --git a/packages/typescript-axios-runtime/package.json b/packages/typescript-axios-runtime/package.json
@@ -1,6 +1,7 @@
 {
   "name": "@nahkies/typescript-axios-runtime",
   "version": "0.22.0",
+  "type": "module",
   "description": "Runtime package for code generated by @nahkies/openapi-code-generator using the typescript-axios template",
   "license": "MIT",
   "author": {
@@ -10,7 +11,7 @@
   "homepage": "https://openapi-code-generator.nahkies.co.nz/",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mnahkies/openapi-code-generator.git",
+    "url": "git+https://github.com/mnahkies/openapi-code-generator.git",
     "directory": "packages/typescript-axios-runtime"
   },
   "bugs": {
diff --git a/packages/typescript-axios-runtime/src/main.spec.ts b/packages/typescript-axios-runtime/src/main.spec.ts
@@ -9,7 +9,7 @@ import {
   type AbstractAxiosConfig,
   type HeaderParams,
   type QueryParams,
-} from "./main"
+} from "./main.ts"
 
 class ConcreteAxiosClient extends AbstractAxiosClient {
   // biome-ignore lint/complexity/noUselessConstructor: make public
diff --git a/packages/typescript-axios-runtime/tsdown.config.mts b/packages/typescript-axios-runtime/tsdown.config.mts
@@ -8,6 +8,8 @@ export default defineConfig({
   target: "esnext",
   dts: true,
   sourcemap: true,
+  publint: true,
+  attw: {profile: "node16"},
 
   format: {
     esm: {
diff --git a/packages/typescript-common-runtime/jest.config.cjs b/packages/typescript-common-runtime/jest.config.cjs
diff --git a/packages/typescript-common-runtime/package.json b/packages/typescript-common-runtime/package.json
@@ -1,6 +1,7 @@
 {
   "name": "@nahkies/typescript-common-runtime",
   "version": "0.22.0",
+  "type": "module",
   "description": "Runtime package for code generated by @nahkies/openapi-code-generator using the typescript templates",
   "license": "MIT",
   "author": {
@@ -10,7 +11,7 @@
   "homepage": "https://openapi-code-generator.nahkies.co.nz/",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mnahkies/openapi-code-generator.git",
+    "url": "git+https://github.com/mnahkies/openapi-code-generator.git",
     "directory": "packages/typescript-common-runtime"
   },
   "bugs": {
diff --git a/packages/typescript-common-runtime/src/query-parser.spec.ts b/packages/typescript-common-runtime/src/query-parser.spec.ts
@@ -5,7 +5,7 @@ import {
   parseQueryParameter,
   parseQueryParameters,
   type Style,
-} from "./query-parser"
+} from "./query-parser.ts"
 
 // todo: nodejs v20 doesn't support Iterator.from - replace when v20 support dropped.
 function* toIterator<T>(arr: T[]): IterableIterator<T> {
diff --git a/packages/typescript-common-runtime/src/request-bodies/index.ts b/packages/typescript-common-runtime/src/request-bodies/index.ts
@@ -1,9 +1,9 @@
 // todo: parseOctetStreamRequestBody is only for server side, and requestBodyToUrlSearchParams is only for client side.
 //       probably need to split this package to avoid polluting client dependency tress.
-export {parseOctetStreamRequestBody, type SizeLimit} from "./octet-stream"
+export {parseOctetStreamRequestBody, type SizeLimit} from "./octet-stream.ts"
 
 export {
   type Encoding,
   requestBodyToUrlSearchParams,
   type Style,
-} from "./url-search-params"
+} from "./url-search-params.ts"
diff --git a/packages/typescript-common-runtime/src/request-bodies/url-search-params.spec.ts b/packages/typescript-common-runtime/src/request-bodies/url-search-params.spec.ts
@@ -1,5 +1,5 @@
 import {describe, expect, it} from "@jest/globals"
-import {requestBodyToUrlSearchParams} from "./url-search-params"
+import {requestBodyToUrlSearchParams} from "./url-search-params.ts"
 
 describe("typescript-fetch-runtime/request-bodies/requestBodyToUrlSearchParams", () => {
   it("encodes the basic example from the specification correctly", async () => {
diff --git a/packages/typescript-common-runtime/tsdown.config.mts b/packages/typescript-common-runtime/tsdown.config.mts
@@ -10,7 +10,12 @@ export default defineConfig({
     "./src/query-parser.ts",
     "./src/request-bodies/index.ts",
   ],
+
   target: "esnext",
+  dts: true,
+  sourcemap: true,
+  publint: true,
+  attw: {profile: "node16"},
 
   format: {
     esm: {
@@ -20,7 +25,4 @@ export default defineConfig({
       outDir: "./dist/cjs",
     },
   },
-
-  dts: true,
-  sourcemap: true,
 })
diff --git a/packages/typescript-express-runtime/jest.config.cjs b/packages/typescript-express-runtime/jest.config.cjs
diff --git a/packages/typescript-express-runtime/package.json b/packages/typescript-express-runtime/package.json
@@ -1,6 +1,7 @@
 {
   "name": "@nahkies/typescript-express-runtime",
   "version": "0.22.0",
+  "type": "module",
   "description": "Runtime package for code generated by @nahkies/openapi-code-generator using the typescript-express template",
   "license": "MIT",
   "author": {
@@ -10,7 +11,7 @@
   "homepage": "https://openapi-code-generator.nahkies.co.nz/",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mnahkies/openapi-code-generator.git",
+    "url": "git+https://github.com/mnahkies/openapi-code-generator.git",
     "directory": "packages/typescript-express-runtime"
   },
   "bugs": {
diff --git a/packages/typescript-express-runtime/src/joi.ts b/packages/typescript-express-runtime/src/joi.ts
@@ -1,7 +1,7 @@
 import {findMatchingSchema} from "@nahkies/typescript-common-runtime/validation"
 
 import type {Schema as JoiSchema} from "joi"
-import {ExpressRuntimeError, type RequestInputType} from "./errors"
+import {ExpressRuntimeError, type RequestInputType} from "./errors.ts"
 
 // Note: joi types don't appear to have an equivalent of z.infer,
 //       hence any seems about as good as we can do here.
diff --git a/packages/typescript-express-runtime/src/server.ts b/packages/typescript-express-runtime/src/server.ts
@@ -12,7 +12,7 @@ import express, {
   type RequestHandler,
   type Router,
 } from "express"
-import {ExpressRuntimeError} from "./errors"
+import {ExpressRuntimeError} from "./errors.ts"
 
 export {parseQueryParameters} from "@nahkies/typescript-common-runtime/query-parser"
 
diff --git a/packages/typescript-express-runtime/src/zod-v3.ts b/packages/typescript-express-runtime/src/zod-v3.ts
@@ -1,8 +1,8 @@
 import {findMatchingSchema} from "@nahkies/typescript-common-runtime/validation"
 
 import type {z} from "zod/v3"
-import {ExpressRuntimeError, type RequestInputType} from "./errors"
-import type {ResponseValidator} from "./server"
+import {ExpressRuntimeError, type RequestInputType} from "./errors.ts"
+import type {ResponseValidator} from "./server.ts"
 
 export function parseRequestInput<Schema extends z.ZodTypeAny>(
   schema: Schema,
diff --git a/packages/typescript-express-runtime/src/zod-v4.ts b/packages/typescript-express-runtime/src/zod-v4.ts
@@ -1,6 +1,6 @@
 import {findMatchingSchema} from "@nahkies/typescript-common-runtime/validation"
 import type {z} from "zod/v4"
-import {ExpressRuntimeError, type RequestInputType} from "./errors"
+import {ExpressRuntimeError, type RequestInputType} from "./errors.ts"
 
 export function parseRequestInput<Schema extends z.ZodTypeAny>(
   schema: Schema,
diff --git a/packages/typescript-express-runtime/tsdown.config.mts b/packages/typescript-express-runtime/tsdown.config.mts
@@ -14,6 +14,8 @@ export default defineConfig({
   target: "esnext",
   dts: true,
   sourcemap: true,
+  publint: true,
+  attw: {profile: "node16"},
 
   format: {
     esm: {
diff --git a/packages/typescript-fetch-runtime/jest.config.cjs b/packages/typescript-fetch-runtime/jest.config.cjs
diff --git a/packages/typescript-fetch-runtime/package.json b/packages/typescript-fetch-runtime/package.json
@@ -1,6 +1,7 @@
 {
   "name": "@nahkies/typescript-fetch-runtime",
   "version": "0.22.0",
+  "type": "module",
   "description": "Runtime package for code generated by @nahkies/openapi-code-generator using the typescript-fetch template",
   "license": "MIT",
   "author": {
@@ -10,7 +11,7 @@
   "homepage": "https://openapi-code-generator.nahkies.co.nz/",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mnahkies/openapi-code-generator.git",
+    "url": "git+https://github.com/mnahkies/openapi-code-generator.git",
     "directory": "packages/typescript-fetch-runtime"
   },
   "bugs": {
diff --git a/packages/typescript-fetch-runtime/src/common.ts b/packages/typescript-fetch-runtime/src/common.ts
@@ -1,6 +1,6 @@
 import {findMatchingSchema} from "@nahkies/typescript-common-runtime/validation"
 
-import type {Res, StatusCode} from "./types"
+import type {Res, StatusCode} from "./types.ts"
 
 export function responseValidationFactoryFactory<Schema>(
   // biome-ignore lint/suspicious/noExplicitAny: needed
diff --git a/packages/typescript-fetch-runtime/src/joi.ts b/packages/typescript-fetch-runtime/src/joi.ts
@@ -1,5 +1,5 @@
 import type {Schema as JoiSchema} from "joi"
-import {responseValidationFactoryFactory} from "./common"
+import {responseValidationFactoryFactory} from "./common.ts"
 
 export function responseValidationFactory(
   possibleResponses: [string, JoiSchema][],
diff --git a/packages/typescript-fetch-runtime/src/main.spec.ts b/packages/typescript-fetch-runtime/src/main.spec.ts
@@ -8,7 +8,7 @@ import {
   type HeaderParams,
   type HeadersInit,
   type QueryParams,
-} from "./main"
+} from "./main.ts"
 
 class ConcreteFetchClient extends AbstractFetchClient {
   // biome-ignore lint/complexity/noUselessConstructor: make public
diff --git a/packages/typescript-fetch-runtime/src/main.ts b/packages/typescript-fetch-runtime/src/main.ts
@@ -10,9 +10,9 @@ import type {
   QueryParams,
   Res,
   StatusCode,
-} from "./types"
+} from "./types.ts"
 
-export * from "./types"
+export * from "./types.ts"
 
 export abstract class AbstractFetchClient {
   protected readonly basePath: string
diff --git a/packages/typescript-fetch-runtime/src/zod-v3.ts b/packages/typescript-fetch-runtime/src/zod-v3.ts
@@ -1,5 +1,5 @@
 import type {z} from "zod/v3"
-import {responseValidationFactoryFactory} from "./common"
+import {responseValidationFactoryFactory} from "./common.ts"
 
 export function responseValidationFactory(
   possibleResponses: [string, z.ZodTypeAny][],
diff --git a/packages/typescript-fetch-runtime/src/zod-v4.ts b/packages/typescript-fetch-runtime/src/zod-v4.ts
@@ -1,5 +1,5 @@
 import type {z} from "zod/v4"
-import {responseValidationFactoryFactory} from "./common"
+import {responseValidationFactoryFactory} from "./common.ts"
 
 export function responseValidationFactory(
   possibleResponses: [string, z.ZodTypeAny][],
diff --git a/packages/typescript-fetch-runtime/tsdown.config.mts b/packages/typescript-fetch-runtime/tsdown.config.mts
@@ -13,6 +13,8 @@ export default defineConfig({
   target: "esnext",
   dts: true,
   sourcemap: true,
+  publint: true,
+  attw: {profile: "node16"},
 
   format: {
     esm: {
diff --git a/packages/typescript-koa-runtime/jest.config.cjs b/packages/typescript-koa-runtime/jest.config.cjs
diff --git a/packages/typescript-koa-runtime/package.json b/packages/typescript-koa-runtime/package.json
@@ -1,6 +1,7 @@
 {
   "name": "@nahkies/typescript-koa-runtime",
   "version": "0.22.0",
+  "type": "module",
   "description": "Runtime package for code generated by @nahkies/openapi-code-generator using the typescript-koa template",
   "license": "MIT",
   "author": {
@@ -10,7 +11,7 @@
   "homepage": "https://openapi-code-generator.nahkies.co.nz/",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mnahkies/openapi-code-generator.git",
+    "url": "git+https://github.com/mnahkies/openapi-code-generator.git",
     "directory": "packages/typescript-koa-runtime"
   },
   "bugs": {
@@ -83,7 +84,7 @@
     "@koa/router": "^13.0.0 || ^14.0.0",
     "joi": "^17.13.3 || ^18.0.1",
     "koa": "^2.16.1 || ^3.0.0",
-    "koa-body": "^6.0.1",
+    "koa-body": "^7.0.1",
     "zod": "^3.25.74 || ^4.1.12"
   },
   "peerDependenciesMeta": {
@@ -110,7 +111,7 @@
     "jest": "^30.3.0",
     "joi": "^18.1.2",
     "koa": "^3.2.0",
-    "koa-body": "^6.0.1",
+    "koa-body": "^7.0.1",
     "tsdown": "^0.21.10",
     "typescript": "^6.0.3",
     "zod": "^3.25.76"
diff --git a/packages/typescript-koa-runtime/src/joi.ts b/packages/typescript-koa-runtime/src/joi.ts
@@ -1,7 +1,7 @@
 import {findMatchingSchema} from "@nahkies/typescript-common-runtime/validation"
 
 import type {Schema as JoiSchema} from "joi"
-import {KoaRuntimeError, type RequestInputType} from "./errors"
+import {KoaRuntimeError, type RequestInputType} from "./errors.ts"
 
 // Note: joi types don't appear to have an equivalent of z.infer,
 //       hence any seems about as good as we can do here.
diff --git a/packages/typescript-koa-runtime/src/server.ts b/packages/typescript-koa-runtime/src/server.ts
@@ -6,9 +6,8 @@ import type {SizeLimit} from "@nahkies/typescript-common-runtime/request-bodies"
 import {parseOctetStreamRequestBody} from "@nahkies/typescript-common-runtime/request-bodies"
 import type {Res, StatusCode} from "@nahkies/typescript-common-runtime/types"
 import Koa, {type Context, type Middleware, type Next} from "koa"
-import type {KoaBodyMiddlewareOptions} from "koa-body"
-import KoaBody from "koa-body"
-import {KoaRuntimeError} from "./errors"
+import {type KoaBodyMiddlewareOptions, koaBody} from "koa-body"
+import {KoaRuntimeError} from "./errors.ts"
 
 export {parseQueryParameters} from "@nahkies/typescript-common-runtime/query-parser"
 export type {
@@ -149,7 +148,7 @@ export async function startServer({
   }
 
   if (body !== "disabled") {
-    app.use(KoaBody(body))
+    app.use(koaBody(body))
   }
 
   for (const it of middleware) {
diff --git a/packages/typescript-koa-runtime/src/zod-v3.ts b/packages/typescript-koa-runtime/src/zod-v3.ts
diff --git a/packages/typescript-koa-runtime/src/zod-v4.ts b/packages/typescript-koa-runtime/src/zod-v4.ts
diff --git a/packages/typescript-koa-runtime/tsdown.config.mts b/packages/typescript-koa-runtime/tsdown.config.mts
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/tsconfig.base.json b/tsconfig.base.json

Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@ const inspector = require("node:inspector")`
`4`	`4`	`* @type { import('@jest/types').Config.GlobalConfig }`
`5`	`5`	`*/`
`6`	`6`	`const config = {`
`7`		`- projects: ["packages/*/jest.config.js"],`
	`7`	`+ projects: ["packages/*/jest.config.cjs"],`
`8`	`8`	`testTimeout: inspector.url() ? 5 * 60 * 1000 : 5 * 1000,`
`9`	`9`	`reporters: ["./jest/reporter.js"],`
`10`	`10`	`}`