skuba 11.1.0-jest30-20250620003740 → 11.2.0-lfs-20250711064710

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skuba",
-  "version": "11.1.0-jest30-20250620003740",
+  "version": "11.2.0-lfs-20250711064710",
   "private": false,
   "description": "SEEK development toolkit for backend applications and packages",
   "homepage": "https://github.com/seek-oss/skuba#readme",
@@ -55,7 +55,7 @@
     "@jest/types": "^30.0.0",
     "@octokit/graphql": "^9.0.0",
     "@octokit/graphql-schema": "^15.3.0",
-    "@octokit/rest": "^21.0.0",
+    "@octokit/rest": "^22.0.0",
     "@octokit/types": "^14.0.0",
     "@types/jest": "^30.0.0",
     "@types/node": "^22.0.0",
@@ -85,7 +85,7 @@
     "npm-run-path": "^4.0.1",
     "npm-which": "^3.0.1",
     "picomatch": "^4.0.0",
-    "prettier": "~3.5.0",
+    "prettier": "~3.6.0",
     "prettier-plugin-packagejson": "^2.4.10",
     "read-pkg-up": "^7.0.1",
     "semantic-release": "^24.2.3",
@@ -97,37 +97,37 @@
     "tsconfig-seek": "2.0.0",
     "tsx": "^4.16.2",
     "typescript": "~5.8.0",
-    "zod": "^3.22.4",
-    "eslint-config-skuba": "6.1.0"
+    "zod": "^3.25.67",
+    "eslint-config-skuba": "6.1.1"
   },
   "devDependencies": {
-    "@changesets/cli": "2.29.3",
+    "@changesets/cli": "2.29.5",
     "@changesets/get-github-info": "0.6.0",
     "@jest/reporters": "30.0.2",
     "@jest/test-result": "30.0.2",
     "@types/ejs": "3.1.5",
-    "@types/express": "5.0.1",
+    "@types/express": "5.0.3",
     "@types/fs-extra": "11.0.4",
     "@types/koa": "2.15.0",
     "@types/lodash.mergewith": "4.6.9",
     "@types/minimist": "1.2.5",
     "@types/module-alias": "2.0.4",
-    "@types/npm-registry-fetch": "8.0.7",
-    "@types/npm-which": "3.0.3",
+    "@types/npm-registry-fetch": "8.0.8",
+    "@types/npm-which": "3.0.4",
     "@types/picomatch": "4.0.0",
     "@types/semver": "7.7.0",
     "@types/supertest": "6.0.3",
-    "enhanced-resolve": "5.18.1",
+    "enhanced-resolve": "5.18.2",
     "express": "5.1.0",
-    "fastify": "5.3.2",
-    "jest-diff": "30.0.2",
+    "fastify": "5.4.0",
+    "jest-diff": "30.0.3",
     "jsonfile": "6.1.0",
     "koa": "3.0.0",
-    "memfs": "4.17.1",
+    "memfs": "4.17.2",
     "remark-cli": "12.0.1",
     "remark-preset-lint-recommended": "7.0.1",
-    "semver": "7.7.1",
-    "supertest": "7.1.0",
+    "semver": "7.7.2",
+    "supertest": "7.1.1",
     "type-fest": "2.19.0"
   },
   "peerDependencies": {

package/template/express-rest-api/.buildkite/pipeline.yml

@@ -48,7 +48,7 @@ steps:
       GET_NPM_TOKEN: please
     plugins:
       - *docker-ecr-cache
-      - docker-compose#v5.9.0:
+      - docker-compose#v5.10.0:
           run: app
           environment:
             - GITHUB_API_TOKEN

package/template/express-rest-api/Dockerfile.dev-deps

@@ -1,4 +1,4 @@
-# syntax=docker/dockerfile:1.16
+# syntax=docker/dockerfile:1.17
 
 FROM public.ecr.aws/docker/library/node:22-alpine AS dev-deps
 

package/template/express-rest-api/package.json

@@ -28,7 +28,7 @@
     "skuba": "*",
     "supertest": "^7.0.0"
   },
-  "packageManager": "pnpm@10.12.1",
+  "packageManager": "pnpm@10.12.4",
   "engines": {
     "node": ">=22"
   }

package/template/greeter/.buildkite/pipeline.yml

@@ -29,7 +29,7 @@ steps:
       GET_NPM_TOKEN: please
     plugins:
       - *docker-ecr-cache
-      - docker-compose#v5.9.0:
+      - docker-compose#v5.10.0:
           run: app
           environment:
             - GITHUB_API_TOKEN

package/template/greeter/Dockerfile

@@ -1,4 +1,4 @@
-# syntax=docker/dockerfile:1.16
+# syntax=docker/dockerfile:1.17
 
 FROM public.ecr.aws/docker/library/node:22-alpine AS dev-deps
 

package/template/greeter/package.json

@@ -17,9 +17,9 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.10",
-    "skuba": "11.1.0-jest30-20250620003740"
+    "skuba": "11.2.0-lfs-20250711064710"
   },
-  "packageManager": "pnpm@10.12.1",
+  "packageManager": "pnpm@10.12.4",
   "engines": {
     "node": ">=22"
   }

package/template/koa-rest-api/.buildkite/pipeline.yml

@@ -48,7 +48,7 @@ steps:
       GET_NPM_TOKEN: please
     plugins:
       - *docker-ecr-cache
-      - docker-compose#v5.9.0:
+      - docker-compose#v5.10.0:
           run: app
           environment:
             - GITHUB_API_TOKEN

package/template/koa-rest-api/Dockerfile.dev-deps

@@ -1,4 +1,4 @@
-# syntax=docker/dockerfile:1.16
+# syntax=docker/dockerfile:1.17
 
 FROM public.ecr.aws/docker/library/node:22-alpine AS dev-deps
 

package/template/koa-rest-api/package.json

@@ -13,15 +13,15 @@
     "test:watch": "skuba test --watch"
   },
   "dependencies": {
-    "@koa/bodyparser": "^5.1.1",
+    "@koa/bodyparser": "^6.0.0",
     "@koa/router": "^13.0.0",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/core": "^2.0.0",
-    "@opentelemetry/exporter-trace-otlp-grpc": "^0.201.0",
-    "@opentelemetry/instrumentation-aws-sdk": "^0.53.0",
-    "@opentelemetry/instrumentation-http": "^0.201.0",
+    "@opentelemetry/exporter-trace-otlp-grpc": "^0.202.0",
+    "@opentelemetry/instrumentation-aws-sdk": "^0.54.0",
+    "@opentelemetry/instrumentation-http": "^0.202.0",
     "@opentelemetry/propagator-b3": "^2.0.0",
-    "@opentelemetry/sdk-node": "^0.201.0",
+    "@opentelemetry/sdk-node": "^0.202.0",
     "@seek/logger": "^10.0.0",
     "hot-shots": "^10.0.0",
     "koa": "^2.16.1",
@@ -29,7 +29,7 @@
     "seek-datadog-custom-metrics": "^4.6.3",
     "seek-koala": "^7.0.0",
     "skuba-dive": "^2.0.0",
-    "zod": "^3.19.1"
+    "zod": "^3.25.67"
   },
   "devDependencies": {
     "@types/chance": "^1.1.3",
@@ -44,7 +44,7 @@
     "skuba": "*",
     "supertest": "^7.0.0"
   },
-  "packageManager": "pnpm@10.12.1",
+  "packageManager": "pnpm@10.12.4",
   "engines": {
     "node": ">=22"
   }

package/template/koa-rest-api/src/api/jobs/postJob.test.ts

@@ -27,7 +27,7 @@ describe('postJobHandler', () => {
       .expect(422)
       .expect(({ text }) =>
         expect(text).toMatchInlineSnapshot(
-          `"{"message":"Input validation failed","invalidFields":{"/hirer":"Required"}}"`,
+          `"{"message":"Input validation failed","invalidFields":{"/hirer":"Invalid input: expected object, received undefined"}}"`,
         ),
       );
   });

package/template/koa-rest-api/src/config.ts

@@ -32,7 +32,7 @@ const configs: Record<Environment, () => Omit<Config, 'environment'>> = {
   }),
 
   test: () => ({
-    logLevel: Env.string('LOG_LEVEL', { default: 'silent' }),
+    logLevel: 'debug',
     name: '<%- serviceName %>',
     version: 'test',
 

package/template/koa-rest-api/src/framework/logging.ts

@@ -1,4 +1,4 @@
-import createLogger from '@seek/logger';
+import createLogger, { createDestination } from '@seek/logger';
 import { RequestLogging } from 'seek-koala';
 
 import { config } from 'src/config';
@@ -8,18 +8,27 @@ const { createContextMiddleware, mixin } =
 
 export const contextMiddleware = createContextMiddleware();
 
-export const logger = createLogger({
-  base: {
-    environment: config.environment,
-    version: config.version,
-  },
+const { destination, stdoutMock } = createDestination({
+  mock: config.environment === 'test',
+});
 
-  mixin,
+export { stdoutMock };
 
-  level: config.logLevel,
+export const logger = createLogger(
+  {
+    base: {
+      environment: config.environment,
+      version: config.version,
+    },
 
-  name: config.name,
+    mixin,
 
-  transport:
-    config.environment === 'local' ? { target: 'pino-pretty' } : undefined,
-});
+    level: config.logLevel,
+
+    name: config.name,
+
+    transport:
+      config.environment === 'local' ? { target: 'pino-pretty' } : undefined,
+  },
+  destination,
+);

package/template/koa-rest-api/src/framework/server.test.ts

@@ -1,11 +1,12 @@
 import Router from '@koa/router';
 
-import { logger } from 'src/testing/logging';
 import { metricsClient } from 'src/testing/metrics';
 import { agentFromRouter } from 'src/testing/server';
 import { chance } from 'src/testing/types';
 import type { Middleware } from 'src/types/koa';
 
+import { stdoutMock } from './logging';
+
 const middleware = jest.fn<void, Parameters<Middleware>>();
 
 const router = new Router()
@@ -15,10 +16,10 @@ const router = new Router()
 const agent = agentFromRouter(router);
 
 describe('createApp', () => {
-  beforeAll(logger.spy);
-
-  afterEach(metricsClient.clear);
-  afterEach(logger.clear);
+  afterEach(() => {
+    metricsClient.clear();
+    stdoutMock.clear();
+  });
 
   it('handles root route', async () => {
     middleware.mockImplementation((ctx) => (ctx.body = ''));
@@ -29,9 +30,7 @@ describe('createApp', () => {
       .expect('server', /.+/)
       .expect('x-api-version', /.+/);
 
-    expect(logger.error).not.toHaveBeenCalled();
-
-    expect(logger.info).not.toHaveBeenCalled();
+    expect(stdoutMock.calls).toHaveLength(0);
 
     metricsClient.expectTagSubset(['env:test', 'version:test']);
     metricsClient.expectTagSubset([
@@ -51,9 +50,7 @@ describe('createApp', () => {
       .expect('server', /.+/)
       .expect('x-api-version', /.+/);
 
-    expect(logger.error).not.toHaveBeenCalled();
-
-    expect(logger.info).not.toHaveBeenCalled();
+    expect(stdoutMock.calls).toHaveLength(0);
 
     metricsClient.expectTagSubset([
       'http_method:put',
@@ -72,13 +69,15 @@ describe('createApp', () => {
       .expect('server', /.+/)
       .expect('x-api-version', /.+/);
 
-    expect(logger.error).not.toHaveBeenCalled();
-
-    expect(logger.info).toHaveBeenNthCalledWith(
-      1,
-      expect.objectContaining({ status: 404 }),
-      'Client error',
-    );
+    expect(stdoutMock.calls).toMatchObject([
+      {
+        level: 30,
+        method: 'GET',
+        msg: 'Client error',
+        status: 404,
+        url: '/unknown',
+      },
+    ]);
 
     metricsClient.expectTagSubset([
       'http_method:get',
@@ -102,13 +101,16 @@ describe('createApp', () => {
       .expect('server', /.+/)
       .expect('x-api-version', /.+/);
 
-    expect(logger.error).not.toHaveBeenCalled();
-
-    expect(logger.info).toHaveBeenNthCalledWith(
-      1,
-      expect.objectContaining({ status: 400 }),
-      'Client error',
-    );
+    expect(stdoutMock.calls).toMatchObject([
+      {
+        level: 30,
+        method: 'GET',
+        msg: 'Client error',
+        route: '/',
+        status: 400,
+        url: '/',
+      },
+    ]);
 
     metricsClient.expectTagSubset([
       'http_method:get',
@@ -129,13 +131,20 @@ describe('createApp', () => {
       .expect('server', /.+/)
       .expect('x-api-version', /.+/);
 
-    expect(logger.error).not.toHaveBeenCalled();
-
-    expect(logger.info).toHaveBeenNthCalledWith(
-      1,
-      expect.objectContaining({ err: expect.any(Error), status: 400 }),
-      'Client error',
-    );
+    expect(stdoutMock.calls).toMatchObject([
+      {
+        err: {
+          statusCode: 400,
+          type: 'BadRequestError',
+        },
+        level: 30,
+        method: 'GET',
+        msg: 'Client error',
+        route: '/',
+        status: 400,
+        url: '/',
+      },
+    ]);
 
     metricsClient.expectTagSubset([
       'http_method:get',
@@ -156,13 +165,20 @@ describe('createApp', () => {
       .expect('server', /.+/)
       .expect('x-api-version', /.+/);
 
-    expect(logger.error).toHaveBeenNthCalledWith(
-      1,
-      expect.objectContaining({ err: expect.any(Error), status: 500 }),
-      'Server error',
-    );
-
-    expect(logger.info).not.toHaveBeenCalled();
+    expect(stdoutMock.calls).toMatchObject([
+      {
+        err: {
+          statusCode: 500,
+          type: 'InternalServerError',
+        },
+        level: 50,
+        method: 'GET',
+        msg: 'Server error',
+        route: '/',
+        status: 500,
+        url: '/',
+      },
+    ]);
 
     metricsClient.expectTagSubset([
       'http_method:get',
@@ -185,13 +201,20 @@ describe('createApp', () => {
       .expect('server', /.+/)
       .expect('x-api-version', /.+/);
 
-    expect(logger.error).toHaveBeenNthCalledWith(
-      1,
-      expect.objectContaining({ err, status: 500 }),
-      'Server error',
-    );
-
-    expect(logger.info).not.toHaveBeenCalled();
+    expect(stdoutMock.calls).toMatchObject([
+      {
+        err: {
+          message: err.message,
+          type: 'Error',
+        },
+        level: 50,
+        method: 'GET',
+        msg: 'Server error',
+        route: '/',
+        status: 500,
+        url: '/',
+      },
+    ]);
 
     metricsClient.expectTagSubset([
       'http_method:get',
@@ -212,13 +235,17 @@ describe('createApp', () => {
       .expect('server', /.+/)
       .expect('x-api-version', /.+/);
 
-    expect(logger.error).toHaveBeenNthCalledWith(
-      1,
-      expect.objectContaining({ err: null, status: 500 }),
-      'Server error',
-    );
-
-    expect(logger.info).not.toHaveBeenCalled();
+    expect(stdoutMock.calls).toMatchObject([
+      {
+        err: null,
+        level: 50,
+        method: 'GET',
+        msg: 'Server error',
+        route: '/',
+        status: 500,
+        url: '/',
+      },
+    ]);
 
     metricsClient.expectTagSubset([
       'http_method:get',
@@ -241,13 +268,17 @@ describe('createApp', () => {
       .expect('server', /.+/)
       .expect('x-api-version', /.+/);
 
-    expect(logger.error).toHaveBeenNthCalledWith(
-      1,
-      expect.objectContaining({ err, status: 500 }),
-      'Server error',
-    );
-
-    expect(logger.info).not.toHaveBeenCalled();
+    expect(stdoutMock.calls).toMatchObject([
+      {
+        err,
+        level: 50,
+        method: 'GET',
+        msg: 'Server error',
+        route: '/',
+        status: 500,
+        url: '/',
+      },
+    ]);
 
     metricsClient.expectTagSubset([
       'http_method:get',

package/template/koa-rest-api/src/framework/validation.test.ts

@@ -43,15 +43,15 @@ describe('validate', () => {
       .expect(422)
       .expect(({ body }) =>
         expect(body).toMatchInlineSnapshot(`
-{
-  "invalidFields": {
-    "~union0/id": "Expected string, received null",
-    "~union1/id": "Expected number, received null",
-    "~union1/summary": "Required",
-  },
-  "message": "Input validation failed",
-}
-`),
+          {
+            "invalidFields": {
+              "~union0/id": "Invalid input: expected string, received null",
+              "~union1/id": "Invalid input: expected number, received null",
+              "~union1/summary": "Invalid input: expected string, received undefined",
+            },
+            "message": "Input validation failed",
+          }
+        `),
       );
   });
 
@@ -62,17 +62,17 @@ describe('validate', () => {
       .expect(422)
       .expect(({ body }) =>
         expect(body).toMatchInlineSnapshot(`
-{
-  "invalidFields": {
-    "~union0/description~union0": "Required",
-    "~union0/description~union1": "Required",
-    "~union0/id": "Required",
-    "~union1/id": "Required",
-    "~union1/summary": "Required",
-  },
-  "message": "Input validation failed",
-}
-`),
+          {
+            "invalidFields": {
+              "~union0/description~union0": "Invalid input: expected string, received undefined",
+              "~union0/description~union1": "Invalid input: expected object, received undefined",
+              "~union0/id": "Invalid input: expected string, received undefined",
+              "~union1/id": "Invalid input: expected number, received undefined",
+              "~union1/summary": "Invalid input: expected string, received undefined",
+            },
+            "message": "Input validation failed",
+          }
+        `),
       ));
 
   it('blocks invalid nested union prop', () => {
@@ -89,17 +89,17 @@ describe('validate', () => {
       .expect(422)
       .expect(({ body }) =>
         expect(body).toMatchInlineSnapshot(`
-{
-  "invalidFields": {
-    "~union0/description~union0": "Expected string, received object",
-    "~union0/description~union1/content": "Required",
-    "~union0/id": "Expected string, received null",
-    "~union1/id": "Expected number, received null",
-    "~union1/summary": "Required",
-  },
-  "message": "Input validation failed",
-}
-`),
+          {
+            "invalidFields": {
+              "~union0/description~union0": "Invalid input: expected string, received object",
+              "~union0/description~union1/content": "Invalid input: expected string, received undefined",
+              "~union0/id": "Invalid input: expected string, received null",
+              "~union1/id": "Invalid input: expected number, received null",
+              "~union1/summary": "Invalid input: expected string, received undefined",
+            },
+            "message": "Input validation failed",
+          }
+        `),
       );
   });
 });

package/template/koa-rest-api/src/framework/validation.ts

@@ -1,5 +1,6 @@
 import { ErrorMiddleware } from 'seek-koala';
-import { ZodIssueCode, type z } from 'zod';
+import type * as z from 'zod/v4';
+import type * as core from 'zod/v4/core';
 
 import type { Context } from 'src/types/koa';
 
@@ -35,42 +36,39 @@ type InvalidFields = Record<string, string>;
  * @see [union error example](./validation.test.ts)
  */
 const parseInvalidFieldsFromError = (err: z.ZodError): InvalidFields =>
-  Object.fromEntries(parseTuples(err, {}));
+  Object.fromEntries(parseTuples(err.issues));
 
 const parseTuples = (
-  { errors }: z.ZodError,
-  unions: Record<number, number[]>,
+  errors: core.$ZodIssue[],
+  basePath: Array<string | number | symbol> = [],
+  unions: Record<number, number[]> = {},
 ): Array<readonly [string, string]> =>
   errors.flatMap((issue) => {
-    if (issue.code === ZodIssueCode.invalid_union) {
-      return issue.unionErrors.flatMap((err, idx) =>
-        parseTuples(err, {
+    if (issue.code === 'invalid_union') {
+      return issue.errors.flatMap((err, idx) =>
+        parseTuples(err, issue.path, {
           ...unions,
           [issue.path.length]: [...(unions[issue.path.length] ?? []), idx],
         }),
       );
     }
 
-    const path = ['', ...issue.path]
+    const path = ['', ...basePath, ...issue.path]
       .map((prop, idx) => [prop, ...(unions[idx] ?? [])].join('~union'))
       .join('/');
 
     return [[path, issue.message]] as const;
   });
 
-export const validate = <
-  Output,
-  Def extends z.ZodTypeDef = z.ZodTypeDef,
-  Input = Output,
->({
+export const validate = <T extends z.ZodType>({
   ctx,
   input,
   schema,
 }: {
   ctx: Context;
   input: unknown;
-  schema: z.ZodSchema<Output, Def, Input>;
-}): Output => {
+  schema: T;
+}): z.infer<T> => {
   const parseResult = schema.safeParse(input);
   if (parseResult.success === false) {
     const invalidFields = parseInvalidFieldsFromError(parseResult.error);
@@ -85,15 +83,11 @@ export const validate = <
   return parseResult.data;
 };
 
-export const validateRequestBody = <
-  Output,
-  Def extends z.ZodTypeDef = z.ZodTypeDef,
-  Input = Output,
->(
+export const validateRequestBody = <T extends z.ZodType>(
   ctx: Context,
-  schema: z.ZodSchema<Output, Def, Input>,
-): Output =>
-  validate<Output, Def, Input>({
+  schema: T,
+): z.infer<T> =>
+  validate({
     ctx,
     input: ctx.request.body as unknown,
     schema,

package/template/koa-rest-api/src/testing/types.ts

@@ -1,5 +1,5 @@
 import { Chance } from 'chance';
-import { z } from 'zod';
+import * as z from 'zod/v4';
 
 import type { JobInput } from 'src/types/jobs';
 

package/template/koa-rest-api/src/types/jobs.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import * as z from 'zod/v4';
 
 export interface Job {
   id: string;