feat: publish api-test-toolkit library (1.13.0) (#63)

* upgrade deps

* downgrade migrate

* library separation

* move tests

* upgrade node v24, use test docker

* esm export fix

* fix ci

* fix pg test

* fix test again

* fix ci test command

* update release script

* build all before tests

* fix release ci

* chore(release): 1.13.0 [skip ci]

Author: rafa-stacks

.eslintrc.js

@@ -1,15 +1,25 @@
 module.exports = {
   root: true,
   extends: ['@stacks/eslint-config', 'prettier'],
-  overrides: [],
+  overrides: [
+    {
+      files: ['**/*.test.ts', '**/tests/**/*.ts'],
+      rules: {
+        // node:test `describe` / `it` return promises that the runner consumes; awaiting them is optional/noisy.
+        '@typescript-eslint/no-floating-promises': 'off',
+        // Spies and SQL tagged templates often surface as `any` in tests.
+        '@typescript-eslint/no-unsafe-return': 'off',
+      },
+    },
+  ],
   parser: '@typescript-eslint/parser',
   parserOptions: {
     tsconfigRootDir: __dirname,
-    project: './tsconfig.json',
+    project: ['./packages/api-toolkit/tsconfig.json', './packages/api-test-toolkit/tsconfig.json'],
     ecmaVersion: 2020,
     sourceType: 'module',
   },
-  ignorePatterns: ['*.config.js', 'bin/*.js'],
+  ignorePatterns: ['*.config.js', '**/bin/*.js', '**/dist/**', '**/coverage/**'],
   plugins: ['@typescript-eslint', 'eslint-plugin-tsdoc', 'prettier'],
   rules: {
     'prettier/prettier': 'error',

.github/workflows/ci.yml

@@ -31,7 +31,7 @@ jobs:
         run: echo "dir=$(npm config get cache)" >> ${GITHUB_OUTPUT}
 
       - name: Cache node modules
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         id: npm-cache # use this to check for `cache-hit` ==> if: steps.npm-cache.outputs.cache-hit != 'true'
         with:
           path: ${{ steps.npm-cache-dir.outputs.dir }}
@@ -73,7 +73,7 @@ jobs:
         run: echo "dir=$(npm config get cache)" >> ${GITHUB_OUTPUT}
 
       - name: Cache node modules
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         id: npm-cache # use this to check for `cache-hit` ==> if: steps.npm-cache.outputs.cache-hit != 'true'
         with:
           path: ${{ steps.npm-cache-dir.outputs.dir }}
@@ -84,25 +84,13 @@ jobs:
       - name: Install deps
         run: npm ci --audit=false
 
-      - name: Setup integration environment
-        run: |
-          sudo ufw disable
-          npm run testenv:run -- -d
-          npm run testenv:logs -- --no-color &> docker-compose-logs.txt &
-
       - name: Run tests
-        run: npm run test -- --coverage
+        run: npx c8 --reporter=lcov npm run test -w @stacks/api-toolkit
 
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v5
-
-      - name: Print integration environment logs
-        run: cat docker-compose-logs.txt
-        if: failure()
-
-      - name: Teardown integration environment
-        run: npm run testenv:stop
-        if: always()
+        uses: codecov/codecov-action@v6
+        with:
+          files: packages/api-toolkit/coverage/lcov.info
 
   version:
     runs-on: ubuntu-latest

.github/workflows/release.yml

@@ -30,8 +30,11 @@ jobs:
       - name: Install deps
         run: npm ci --audit=false
 
-      - name: Publish to npm
-        run: npm publish --provenance --access public
+      - name: Publish @stacks/api-toolkit to npm
+        run: npm publish --provenance --access public -w @stacks/api-toolkit
+
+      - name: Publish @stacks/api-test-toolkit to npm
+        run: npm publish --provenance --access public -w @stacks/api-test-toolkit
 
   github-release:
     runs-on: ubuntu-latest

.gitignore

@@ -1,3 +1,4 @@
 node_modules
 dist
 .idea
+coverage

.nvmrc

@@ -1 +1 @@
-22
+24

README.md

@@ -1,74 +1,8 @@
+# API Toolkit Monorepo
 
-# API Toolkit
+Monorepo for Stacks Labs API libraries used for application runtime utilities and integration-test infrastructure.
 
-[![NPM Package](https://img.shields.io/npm/v/@stacks/api-toolkit.svg?style=flat-square)](https://www.npmjs.org/package/@stacks/api-toolkit)
+## Packages
 
-The API Toolkit Library is a comprehensive collection of tools designed by Stacks Labs to simplify
-common tasks in API development. This library provides functionalities for database management,
-application shutdown handlers, migration helpers, server version management, etc. It aims to
-streamline the development process and improve code quality by offering convenient and reusable
-modules.
-
-## Installation
-
-You can start by installing the API Toolkit Library using npm:
-
-```
-npm install @stacks/api-toolkit
-```
-
-You should also customize the following ENV variables that control how log messages are displayed:
-
-```env
-APPLICATION_NAME=your-api-name
-LOG_LEVEL=info
-```
-
-## Featured tools
-
-Please see each tool's source directory for additional documentation
-
-### Postgres
-
-* Superclass for connection support and SQL transaction management using
-  [postgres.js](https://github.com/porsager/postgres)
-* Connection helpers with automatic retry logic, using the standard postgres ENV variables
-* Migration tools for migration apply and rollback using
-  [node-pg-migrate](https://github.com/salsita/node-pg-migrate)
-* Type definitions and conversion helpers for postgres to node type management and viceversa
-
-### Shutdown handlers
-
-* Node.js signal handlers that provide a way to shut down long-running application components
-gracefully on unhandled exceptions or interrupt signals.
-
-### Profiler server
-
-* Fastify server that controls a profiler capable of generating:
-    * `.cpuprofile` files for CPU usage analysis
-    * `.heapsnapshot` files for memory usage analysis
-
-### Logger
-
-* Standardized logger configuration using [pino](https://github.com/pinojs/pino)
-
-### Server versioning
-
-* `api-toolkit-git-info` executable tool to generate API versioning information based on Git branch,
-  tag, and latest commit
-* Helpers to extract version info to display at runtime or on documentation
-
-### Fastify
-
-* API server creation with CORS, Typebox and Pino logging
-* OpenAPI generator plugin with YAML and JSON exports
-
-### Helpers
-
-* Value conversion functions (hex strings, hashes, etc.)
-* Timer tools (stopwatch, waiters, etc.)
-
-## License
-
-The API Toolkit Library is released under the Apache 2.0 License. See the LICENSE file for more
-details.
+- `@stacks/api-toolkit` (`packages/api-toolkit`): Core toolkit for API services (Postgres helpers, Fastify utilities, logging, shutdown hooks, and server version helpers).
+- `@stacks/api-test-toolkit` (`packages/api-test-toolkit`): Docker-based test utilities for bringing up/down service containers in automated test suites.