Skip to content

v0.4.1 — null env values on Coolify 4.7

Choose a tag to compare

@Coriou Coriou released this 16 Nov 09:29
· 49 commits to main since this release

Verified against Coolify 4.7.5 (two live instances, read-only).

Install from the attached tarball (no git needed, no script runs):

pnpm add -D https://github.com/Coriou/coolify-harness-api/releases/download/v0.4.1/coolify-harness-0.4.1.tgz
bun add -d https://github.com/Coriou/coolify-harness-api/releases/download/v0.4.1/coolify-harness-0.4.1.tgz

From the git tag: bun add -d coolify-harness@github:Coriou/coolify-harness-api#v0.4.1. pnpm refuses this
version from git (ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED: it still has a prepare script, removed in
0.5.0), so with pnpm use the tarball.

Fixed

  • env list / env diff / env apply / env delete failed with Coolify response (listEnvs) failed contract validation on Coolify 4.7. Coolify 4.7.5 stores a compose-declared blank
    variable (${VAR:-}) with no value and serialises value: null (also real_value: null,
    order: null); the read schema only accepted a string or an absent key. value is now
    nullish: a null value reads as '' and the row carries value_null: true.
    • A null value is not a withheld one. value_hidden still means only "the token lacks
      read:sensitive" (key absent); env diff / env apply are refused (exit 5) for withheld
      values only.
    • A null row compares equal to an empty desired value: KEY= in --from-file / --set KEY=
      against a null row is unchanged, never an update, and a null row next to an empty-string row
      of the same key and scope is not duplicate-key drift.
    • env list prints len=0 (null) and --json rows gain value_null (boolean, additive);
      value_length stays null for withheld values only.

Added

  • EnvVar.value_null (optional in the type, always set by the parser).
  • test/fixtures/coolify/v4.7/envs-compose-blank.json: synthetic, 4.7.5-shaped env payload.

Full changelog: v0.4.0...v0.4.1