Skip to content

04 Logger v5 Upgrades - #2

Merged
BboyAkers merged 4 commits into
04-loggerfrom
04-logger-v5-upgrade
Aug 21, 2026
Merged

04 Logger v5 Upgrades#2
BboyAkers merged 4 commits into
04-loggerfrom
04-logger-v5-upgrade

Conversation

@BboyAkers

@BboyAkers BboyAkers commented May 8, 2026

Copy link
Copy Markdown
Member

Summary

  • harper dependency bump: ^5.0.11^5.0.28
  • Dev deps added: @harperfast/integration-testing@^0.4.0, typescript@^6.0.3, @types/node
  • Integration tests (integrationTests/dog.test.ts): Dog table CRUD (PUT/GET/DELETE), DogWithHumanAge humanAge calculation coverage (age 1→15, 2→24, 3→29, 4→34), and explicit tests confirming logger.info() side-effects do not break response correctness
  • harperBinPath fix: createRequire resolution from the exported package root (harper's exports map only exposes ".", so require.resolve('harper/dist/bin/harper.js') throws ERR_PACKAGE_PATH_NOT_EXPORTED); passes harperBinPath explicitly to setupHarperWithFixture
  • CI: .github/workflows/integration-tests.yml with Node 22/24/26 matrix, actions pinned to commit hashes
  • Lockfile: regenerated with --os=linux --cpu=x64 --include=optional to record bufferutil, utf-8-validate, node-gyp-build for npm ci on Linux CI
  • Branding: HarperDB Inc.Harper in package.json author field

Migration items applied

Item Status
harperdbharper imports Already done in prior commit (import { tables, logger } from 'harper')
Table.get() return shape / frozen records N/A — no direct mutation in this step
Transaction/context changes N/A
Blob API changes N/A
Child process spawning N/A

Migration items N/A

All remaining items from the v5 migration guide (blob save(), transaction commits, wasLoadedFromSource(), harperdb global) are not used in this step-branch's codebase.

Known issues / workarounds

  • Local test execution blocked by macOS loopback: npm run test:integration fails locally with EADDRNOTAVAIL because macOS requires loopback aliases (127.0.0.2+) that need interactive sudo. Tests are validated by CI (ubuntu-latest supports the full 127.0.0.0/8 range without aliasing). This is environmental, not a code bug.
  • harperBinPath upstream issue: harper should export its bin path, or the harness should resolve via the package root. Flagged for upstream fix.

npm scope

Package is create-your-first-application (not scoped). No npm scope change attempted — flagged for human review per upgrade plan §11.1.

Test results

LOCAL: blocked by macOS loopback (EADDRNOTAVAIL) — environmental, not a code bug.
CI: running on push — see Actions tab for Node 22/24/26 results.

🤖 Generated with Claude Code

BboyAkers and others added 3 commits June 8, 2026 16:08
…sts, and CI

- Bump harper from ^5.0.11 to ^5.0.28
- Add @harperfast/integration-testing, typescript, @types/node dev deps
- Add test:integration script
- Add integrationTests/dog.test.ts with harperBinPath fix, Dog CRUD tests,
  DogWithHumanAge humanAge calculation tests, and logger-firing coverage
- Add .github/workflows/integration-tests.yml (Node 22/24/26 matrix)
- Regenerate package-lock.json with --os=linux --cpu=x64 --include=optional
  to include bufferutil, utf-8-validate, node-gyp-build for npm ci on Linux CI
- Fix branding: HarperDB Inc. -> Harper in package.json author field

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Bump the harper dependency to ^5.2.1 and regenerate the lockfile.
Regenerated in full so the optional native deps (bufferutil,
utf-8-validate, segfault-handler) stay in the tree for Linux CI.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The previous lockfile was generated with npm 11, which does not
auto-install the peer dependencies of an optional dependency. harper
5.2.1 pulls alasql, which optionally depends on react-native-fs, whose
peers (react-native, react) npm 12 installs and npm 11 does not. CI runs
npm 12 on Node 24/26, so npm ci failed there with those packages
"missing from lock file" while Node 22 (npm 11) passed.

Regenerated with npm 12 so the lockfile carries the full tree.
lockfileVersion stays 3; npm ci verified under both npm 11 and npm 12.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@BboyAkers
BboyAkers merged commit 03bdf43 into 04-logger Aug 21, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants