@owlmeans/test-integration 0.1.18-rc.30 → 0.1.18-rc.32

package/README.md

@@ -19,7 +19,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.42
+npx @owlmeans/agent-skills@^0.1.18-rc.48
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/test-integration",
-  "version": "0.1.18-rc.30",
-  "generatedAt": "2026-09-29T08:01:58.123Z",
+  "version": "0.1.18-rc.32",
+  "generatedAt": "2026-10-05T08:32:19.106Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/testing-integration/SKILL.md

@@ -6,7 +6,7 @@ description: Category-C integration tests for OwlMeans Common packages that talk
 
 # Integration Tests — Category C
 
-**Install:** `"@owlmeans/test-integration": "^0.1.18-rc.30"` in `devDependencies`
+**Install:** `"@owlmeans/test-integration": "^0.1.18-rc.32"` in `devDependencies`
 
 Category C applies to packages that integrate with external services: `postgres`,
 `postgres-resource`, `mongo`, `mongo-resource`, `redis`, `redis-resource`, `redis-queue`,

package/build/cleanup.d.ts

@@ -1,4 +1,4 @@
-type CleanupFn = () => void | Promise<void>;
+import type { CleanupFn } from './types.local.js';
 /**
  * Register a cleanup function that `runCleanups()` will execute (LIFO).
  * Use from `tests/context.ts` `setup()` to schedule teardown of resources
@@ -8,9 +8,8 @@ type CleanupFn = () => void | Promise<void>;
 export declare const registerCleanup: (fn: CleanupFn) => void;
 /**
  * Run all pending cleanup functions in reverse registration order.
- * Errors are swallowed and reported to stderr so a failing cleanup
+ * Errors are swallowed and logged as warnings so a failing cleanup
  * cannot mask a test failure.
  */
 export declare const runCleanups: () => Promise<void>;
-export {};
 //# sourceMappingURL=cleanup.d.ts.map

package/build/cleanup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../src/cleanup.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAI3C;;;;;GAKG;AACH,eAAO,MAAM,eAAe,OAAQ,SAAS,KAAG,IAE/C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,IAAI,CAUhD,CAAA"}
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../src/cleanup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAMjD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,OAAQ,SAAS,KAAG,IAE/C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,IAAI,CAUhD,CAAA"}

package/build/cleanup.js

@@ -1,3 +1,5 @@
+import { logger } from '@owlmeans/log';
+const log = logger('test-integration');
 const queue = [];
 /**
  * Register a cleanup function that `runCleanups()` will execute (LIFO).
@@ -10,7 +12,7 @@ export const registerCleanup = (fn) => {
 };
 /**
  * Run all pending cleanup functions in reverse registration order.
- * Errors are swallowed and reported to stderr so a failing cleanup
+ * Errors are swallowed and logged as warnings so a failing cleanup
  * cannot mask a test failure.
  */
 export const runCleanups = async () => {
@@ -22,7 +24,7 @@ export const runCleanups = async () => {
             await fn();
         }
         catch (err) {
-            console.error('@owlmeans/test-integration cleanup failed:', err);
+            log.warn('Cleanup failed', err);
         }
     }
 };

package/build/cleanup.js.map

@@ -1 +1 @@
-{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../src/cleanup.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAgB,EAAE,CAAA;AAE7B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAa,EAAQ,EAAE;IACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAChB,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;IACnD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,EAAE,IAAI,IAAI;YAAE,SAAQ;QACxB,IAAI,CAAC;YACH,MAAM,EAAE,EAAE,CAAA;QACZ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAA;QAClE,CAAC;IACH,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../src/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAGtC,MAAM,GAAG,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAA;AAEtC,MAAM,KAAK,GAAgB,EAAE,CAAA;AAE7B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAa,EAAQ,EAAE;IACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAChB,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;IACnD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,EAAE,IAAI,IAAI;YAAE,SAAQ;QACxB,IAAI,CAAC;YACH,MAAM,EAAE,EAAE,CAAA;QACZ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;AACH,CAAC,CAAA"}

package/build/consts.local.d.ts

@@ -0,0 +1,6 @@
+/** How long one connect may take before the address counts as unreachable. */
+export declare const CONNECT_TIMEOUT_MS = 1500;
+/** The probe runs in a child process; this covers its own startup on a loaded machine. */
+export declare const SPAWN_GRACE_MS = 5000;
+export declare const PROBE_SCRIPT = "\nconst net = require('net')\nconst [targets, timeout] = JSON.parse(process.env.OWLMEANS_TEST_PROBE)\nlet pending = targets.length\nlet last = ''\nfor (const target of targets) {\n  let settled = false\n  const socket = net.connect({ host: target.host, port: target.port })\n  const fail = code => {\n    if (settled) return\n    settled = true\n    socket.destroy()\n    last = code\n    if (--pending === 0) { process.stdout.write(last); process.exit(1) }\n  }\n  socket.setTimeout(timeout)\n  socket.once('connect', () => process.exit(0))\n  socket.once('timeout', () => fail('ETIMEDOUT'))\n  socket.once('error', error => fail(error.code || String(error)))\n}\n";
+//# sourceMappingURL=consts.local.d.ts.map

package/build/consts.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../src/consts.local.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,OAAQ,CAAA;AAEvC,0FAA0F;AAC1F,eAAO,MAAM,cAAc,OAAQ,CAAA;AAInC,eAAO,MAAM,YAAY,8pBAoBxB,CAAA"}

package/build/consts.local.js

@@ -0,0 +1,28 @@
+/** How long one connect may take before the address counts as unreachable. */
+export const CONNECT_TIMEOUT_MS = 1_500;
+/** The probe runs in a child process; this covers its own startup on a loaded machine. */
+export const SPAWN_GRACE_MS = 5_000;
+// Runs under whichever runtime runs the suite (`process.execPath`), so it is plain CommonJS
+// that both `bun -e` and `node -e` evaluate.
+export const PROBE_SCRIPT = `
+const net = require('net')
+const [targets, timeout] = JSON.parse(process.env.OWLMEANS_TEST_PROBE)
+let pending = targets.length
+let last = ''
+for (const target of targets) {
+  let settled = false
+  const socket = net.connect({ host: target.host, port: target.port })
+  const fail = code => {
+    if (settled) return
+    settled = true
+    socket.destroy()
+    last = code
+    if (--pending === 0) { process.stdout.write(last); process.exit(1) }
+  }
+  socket.setTimeout(timeout)
+  socket.once('connect', () => process.exit(0))
+  socket.once('timeout', () => fail('ETIMEDOUT'))
+  socket.once('error', error => fail(error.code || String(error)))
+}
+`;
+//# sourceMappingURL=consts.local.js.map

package/build/consts.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../src/consts.local.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAA;AAEvC,0FAA0F;AAC1F,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAA;AAEnC,4FAA4F;AAC5F,6CAA6C;AAC7C,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;CAoB3B,CAAA"}

package/build/gates.d.ts

@@ -1,45 +1,8 @@
-export interface IntegrationGate<E> {
-    skip: boolean;
-    reason?: string;
-    env: Partial<E>;
-}
-export interface MongoEnv {
-    MONGO_URL: string;
-    MONGO_TEST_DB_PREFIX: string;
-}
+import type { IntegrationGate, KubeEnv, MongoEnv, PostgresEnv, RedisEnv, S3Env, SmtpEnv } from './types.js';
 export declare const mongoGate: () => IntegrationGate<MongoEnv>;
-export interface RedisEnv {
-    REDIS_URL: string;
-    REDIS_TEST_KEY_PREFIX: string;
-}
 export declare const redisGate: () => IntegrationGate<RedisEnv>;
-export interface S3Env {
-    S3_ENDPOINT: string;
-    S3_KEY: string;
-    S3_SECRET: string;
-    S3_TEST_BUCKET: string;
-    S3_REGION: string;
-}
 export declare const s3Gate: () => IntegrationGate<S3Env>;
-export interface KubeEnv {
-    KUBE_CONFIG: string;
-    KUBE_TEST_OK: string;
-}
 export declare const kubeGate: () => IntegrationGate<KubeEnv>;
-export interface PostgresEnv {
-    POSTGRES_URL: string;
-    POSTGRES_TEST_DB_PREFIX: string;
-}
 export declare const postgresGate: () => IntegrationGate<PostgresEnv>;
-export interface SmtpEnv {
-    SMTP_HOST: string;
-    SMTP_PORT: string;
-    SMTP_SECURE: string;
-    SMTP_USER: string;
-    SMTP_PASSWORD: string;
-    SMTP_FROM: string;
-    /** Mailbox the specs deliver to. Required — these tests send real mail. */
-    SMTP_TEST_TO: string;
-}
 export declare const smtpGate: () => IntegrationGate<SmtpEnv>;
 //# sourceMappingURL=gates.d.ts.map

package/build/gates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gates.d.ts","sourceRoot":"","sources":["../src/gates.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CAChB;AAqCD,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,oBAAoB,EAAE,MAAM,CAAA;CAC7B;AAED,eAAO,MAAM,SAAS,QAAO,eAAe,CAAC,QAAQ,CAC2D,CAAA;AAEhH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,EAAE,MAAM,CAAA;CAC9B;AAED,eAAO,MAAM,SAAS,QAAO,eAAe,CAAC,QAAQ,CAC2D,CAAA;AAEhH,MAAM,WAAW,KAAK;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,eAAO,MAAM,MAAM,QAAO,eAAe,CAAC,KAAK,CAI5C,CAAA;AAEH,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,eAAO,MAAM,QAAQ,QAAO,eAAe,CAAC,OAAO,CACU,CAAA;AAE7D,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,uBAAuB,EAAE,MAAM,CAAA;CAChC;AAED,eAAO,MAAM,YAAY,QAAO,eAAe,CAAC,WAAW,CACgE,CAAA;AAE3H,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,eAAO,MAAM,QAAQ,QAAO,eAAe,CAAC,OAAO,CAIhD,CAAA"}
+{"version":3,"file":"gates.d.ts","sourceRoot":"","sources":["../src/gates.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAyB3G,eAAO,MAAM,SAAS,QAAO,eAAe,CAAC,QAAQ,CAC2D,CAAA;AAEhH,eAAO,MAAM,SAAS,QAAO,eAAe,CAAC,QAAQ,CAC2D,CAAA;AAEhH,eAAO,MAAM,MAAM,QAAO,eAAe,CAAC,KAAK,CAI5C,CAAA;AAEH,eAAO,MAAM,QAAQ,QAAO,eAAe,CAAC,OAAO,CACU,CAAA;AAE7D,eAAO,MAAM,YAAY,QAAO,eAAe,CAAC,WAAW,CACgE,CAAA;AAE3H,eAAO,MAAM,QAAQ,QAAO,eAAe,CAAC,OAAO,CAIhD,CAAA"}

package/build/gates.js.map

@@ -1 +1 @@
-{"version":3,"file":"gates.js","sourceRoot":"","sources":["../src/gates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAQrD,MAAM,OAAO,GAAG,CAAI,IAA0B,EAAc,EAAE;IAC5D,MAAM,GAAG,GAA2B,EAAE,CAAA;IACtC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,MAAM,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAW,CAAA;IAClD,CAAC;IACD,OAAO,GAAiB,CAAA;AAC1B,CAAC,CAAA;AAcD,MAAM,iBAAiB,GAAG,CACxB,QAA8B,EAC9B,QAAQ,GAAyB,EAAE,EACnC,SAAwB,EACJ,EAAE;IACtB,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IACjC,MAAM,GAAG,GAAG,OAAO,CAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAA;IAClD,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAA;IACpE,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAW,EAAE,SAAS,CAAC,WAAW,CAAC,CAAA;QAC5G,IAAI,MAAM,IAAI,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;IACxD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;AAC7B,CAAC,CAAA;AAOD,MAAM,CAAC,MAAM,SAAS,GAAG,GAA8B,EAAE,CACvD,iBAAiB,CAAW,CAAC,WAAW,CAAC,EAAE,CAAC,sBAAsB,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAA;AAOhH,MAAM,CAAC,MAAM,SAAS,GAAG,GAA8B,EAAE,CACvD,iBAAiB,CAAW,CAAC,WAAW,CAAC,EAAE,CAAC,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;AAUhH,MAAM,CAAC,MAAM,MAAM,GAAG,GAA2B,EAAE,CACjD,iBAAiB,CACf,CAAC,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,CAAC,EACxD,CAAC,WAAW,CAAC,CACd,CAAA;AAOH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAA6B,EAAE,CACrD,iBAAiB,CAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAA;AAO7D,MAAM,CAAC,MAAM,YAAY,GAAG,GAAiC,EAAE,CAC7D,iBAAiB,CAAc,CAAC,cAAc,CAAC,EAAE,CAAC,yBAAyB,CAAC,EAAE,EAAE,GAAG,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;AAa3H,MAAM,CAAC,MAAM,QAAQ,GAAG,GAA6B,EAAE,CACrD,iBAAiB,CACf,CAAC,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,CAAC,EACxE,CAAC,WAAW,EAAE,aAAa,CAAC,CAC7B,CAAA"}
+{"version":3,"file":"gates.js","sourceRoot":"","sources":["../src/gates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAIrD,MAAM,OAAO,GAAG,CAAI,IAA0B,EAAc,EAAE;IAC5D,MAAM,GAAG,GAA2B,EAAE,CAAA;IACtC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,MAAM,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAW,CAAA;IAClD,CAAC;IACD,OAAO,GAAiB,CAAA;AAC1B,CAAC,CAAA;AAED,MAAM,iBAAiB,GAAG,CACxB,QAA8B,EAC9B,QAAQ,GAAyB,EAAE,EACnC,SAAwB,EACJ,EAAE;IACtB,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IACjC,MAAM,GAAG,GAAG,OAAO,CAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAA;IAClD,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAA;IACpE,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAW,EAAE,SAAS,CAAC,WAAW,CAAC,CAAA;QAC5G,IAAI,MAAM,IAAI,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;IACxD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;AAC7B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,GAA8B,EAAE,CACvD,iBAAiB,CAAW,CAAC,WAAW,CAAC,EAAE,CAAC,sBAAsB,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAA;AAEhH,MAAM,CAAC,MAAM,SAAS,GAAG,GAA8B,EAAE,CACvD,iBAAiB,CAAW,CAAC,WAAW,CAAC,EAAE,CAAC,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;AAEhH,MAAM,CAAC,MAAM,MAAM,GAAG,GAA2B,EAAE,CACjD,iBAAiB,CACf,CAAC,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,CAAC,EACxD,CAAC,WAAW,CAAC,CACd,CAAA;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAA6B,EAAE,CACrD,iBAAiB,CAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAA;AAE7D,MAAM,CAAC,MAAM,YAAY,GAAG,GAAiC,EAAE,CAC7D,iBAAiB,CAAc,CAAC,cAAc,CAAC,EAAE,CAAC,yBAAyB,CAAC,EAAE,EAAE,GAAG,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;AAE3H,MAAM,CAAC,MAAM,QAAQ,GAAG,GAA6B,EAAE,CACrD,iBAAiB,CACf,CAAC,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,CAAC,EACxE,CAAC,WAAW,EAAE,aAAa,CAAC,CAC7B,CAAA"}

package/build/index.d.ts

@@ -1,4 +1,5 @@
 export * from './gates.js';
+export type * from './types.js';
 export * from './naming.js';
 export * from './cleanup.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAE1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/build/reachability.d.ts

@@ -1,16 +1,4 @@
-/**
- * Whether the server a connection string names answers at all — asked synchronously, because
- * Bun decides `test` vs `test.skip` synchronously and every gate is read at module scope.
- *
- * A populated variable says where the service should be, not that it is there: a developer's
- * `.env` keeps the port-forward address long after the forward is gone, and a suite that trusts
- * it spends its whole `beforeAll` budget on a refused connection and FAILS. Only a TCP connect is
- * asked — never a login — so no driver is needed here and no credential leaves the variable.
- */
-export interface ProbeTarget {
-    host: string;
-    port: number;
-}
+import type { ProbeTarget } from './types.js';
 /**
  * Every `host:port` in the authority of a connection string, or `null` when the string names
  * nothing a TCP connect can check — an SRV record, a unix socket, or a shape this cannot read.

package/build/reachability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reachability.d.ts","sourceRoot":"","sources":["../src/reachability.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAWD;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAS,MAAM,eAAe,MAAM,KAAG,WAAW,EAAE,GAAG,IA6B/E,CAAA;AA0BD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,YAAa,WAAW,EAAE,KAAG,MAAM,GAAG,IAkB9D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAAc,MAAM,OAAO,MAAM,eAAe,MAAM,KAAG,MAAM,GAAG,IAiB/F,CAAA"}
+{"version":3,"file":"reachability.d.ts","sourceRoot":"","sources":["../src/reachability.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAiB7C;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAS,MAAM,eAAe,MAAM,KAAG,WAAW,EAAE,GAAG,IA6B/E,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,YAAa,WAAW,EAAE,KAAG,MAAM,GAAG,IAkB9D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAAc,MAAM,OAAO,MAAM,eAAe,MAAM,KAAG,MAAM,GAAG,IAiB/F,CAAA"}

package/build/reachability.js

@@ -1,8 +1,16 @@
 import { spawnSync } from 'node:child_process';
-/** How long one connect may take before the address counts as unreachable. */
-const CONNECT_TIMEOUT_MS = 1_500;
-/** The probe runs in a child process; this covers its own startup on a loaded machine. */
-const SPAWN_GRACE_MS = 5_000;
+import { logger } from '@owlmeans/log';
+import { CONNECT_TIMEOUT_MS, PROBE_SCRIPT, SPAWN_GRACE_MS } from './consts.local.js';
+const log = logger('test-integration');
+/**
+ * Whether the server a connection string names answers at all — asked synchronously, because
+ * Bun decides `test` vs `test.skip` synchronously and every gate is read at module scope.
+ *
+ * A populated variable says where the service should be, not that it is there: a developer's
+ * `.env` keeps the port-forward address long after the forward is gone, and a suite that trusts
+ * it spends its whole `beforeAll` budget on a refused connection and FAILS. Only a TCP connect is
+ * asked — never a login — so no driver is needed here and no credential leaves the variable.
+ */
 const answers = new Map();
 const warned = new Set();
 /**
@@ -39,29 +47,6 @@ export const parseTargets = (url, defaultPort) => {
     }
     return targets.length > 0 ? targets : null;
 };
-// Runs under whichever runtime runs the suite (`process.execPath`), so it is plain CommonJS
-// that both `bun -e` and `node -e` evaluate.
-const PROBE_SCRIPT = `
-const net = require('net')
-const [targets, timeout] = JSON.parse(process.env.OWLMEANS_TEST_PROBE)
-let pending = targets.length
-let last = ''
-for (const target of targets) {
-  let settled = false
-  const socket = net.connect({ host: target.host, port: target.port })
-  const fail = code => {
-    if (settled) return
-    settled = true
-    socket.destroy()
-    last = code
-    if (--pending === 0) { process.stdout.write(last); process.exit(1) }
-  }
-  socket.setTimeout(timeout)
-  socket.once('connect', () => process.exit(0))
-  socket.once('timeout', () => fail('ETIMEDOUT'))
-  socket.once('error', error => fail(error.code || String(error)))
-}
-`;
 /**
  * `null` when at least one target accepts a TCP connection, otherwise the reason none did.
  *
@@ -102,7 +87,7 @@ export const unreachableReason = (variable, url, defaultPort) => {
     const reason = `${variable} is set, but ${unreachable} — start the service (or its port-forward) to run these specs`;
     if (!warned.has(reason)) {
         warned.add(reason);
-        console.warn(`@owlmeans/test-integration: skipping — ${reason}`);
+        log.warn('Skipping integration specs: a configured service is unreachable', { variable, unreachable });
     }
     return reason;
 };

package/build/reachability.js.map

@@ -1 +1 @@
-{"version":3,"file":"reachability.js","sourceRoot":"","sources":["../src/reachability.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reachability.js","sourceRoot":"","sources":["../src/reachability.ts"],"names":[],"mappings":"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"}

package/build/types.d.ts

@@ -0,0 +1,43 @@
+export interface IntegrationGate<E> {
+    skip: boolean;
+    reason?: string;
+    env: Partial<E>;
+}
+export interface MongoEnv {
+    MONGO_URL: string;
+    MONGO_TEST_DB_PREFIX: string;
+}
+export interface RedisEnv {
+    REDIS_URL: string;
+    REDIS_TEST_KEY_PREFIX: string;
+}
+export interface S3Env {
+    S3_ENDPOINT: string;
+    S3_KEY: string;
+    S3_SECRET: string;
+    S3_TEST_BUCKET: string;
+    S3_REGION: string;
+}
+export interface KubeEnv {
+    KUBE_CONFIG: string;
+    KUBE_TEST_OK: string;
+}
+export interface PostgresEnv {
+    POSTGRES_URL: string;
+    POSTGRES_TEST_DB_PREFIX: string;
+}
+export interface SmtpEnv {
+    SMTP_HOST: string;
+    SMTP_PORT: string;
+    SMTP_SECURE: string;
+    SMTP_USER: string;
+    SMTP_PASSWORD: string;
+    SMTP_FROM: string;
+    /** Mailbox the specs deliver to. Required — these tests send real mail. */
+    SMTP_TEST_TO: string;
+}
+export interface ProbeTarget {
+    host: string;
+    port: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,oBAAoB,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,KAAK;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,uBAAuB,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/build/types.local.d.ts

@@ -0,0 +1,13 @@
+export type CleanupFn = () => void | Promise<void>;
+/**
+ * A connection-string variable whose server must answer a TCP connect for the gate to open.
+ *
+ * Only for a service a developer reaches through a local address that can go away — a
+ * port-forward, a container. A populated variable pointing at nothing then closes the gate with
+ * a printed reason instead of failing every suite behind it on a refused connection.
+ */
+export interface Reachable<E> {
+    key: keyof E & string;
+    defaultPort: number;
+}
+//# sourceMappingURL=types.local.d.ts.map

package/build/types.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.local.d.ts","sourceRoot":"","sources":["../src/types.local.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;CACpB"}

package/build/types.local.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.local.js.map

package/build/types.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.local.js","sourceRoot":"","sources":["../src/types.local.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/test-integration",
-  "version": "0.1.18-rc.30",
+  "version": "0.1.18-rc.32",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,11 +21,12 @@
     }
   },
   "dependencies": {
-    "@owlmeans/test": "^0.1.18-rc.33"
+    "@owlmeans/log": "^0.1.18-rc.1",
+    "@owlmeans/test": "^0.1.18-rc.34"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "^0.1.18-rc.6",
-    "@types/bun": "^1.4.0",
+    "@types/bun": "^1.4.2",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },

package/src/cleanup.ts

@@ -1,4 +1,7 @@
-type CleanupFn = () => void | Promise<void>
+import { logger } from '@owlmeans/log'
+import type { CleanupFn } from './types.local.js'
+
+const log = logger('test-integration')
 
 const queue: CleanupFn[] = []
 
@@ -14,7 +17,7 @@ export const registerCleanup = (fn: CleanupFn): void => {
 
 /**
  * Run all pending cleanup functions in reverse registration order.
- * Errors are swallowed and reported to stderr so a failing cleanup
+ * Errors are swallowed and logged as warnings so a failing cleanup
  * cannot mask a test failure.
  */
 export const runCleanups = async (): Promise<void> => {
@@ -24,7 +27,7 @@ export const runCleanups = async (): Promise<void> => {
     try {
       await fn()
     } catch (err) {
-      console.error('@owlmeans/test-integration cleanup failed:', err)
+      log.warn('Cleanup failed', err)
     }
   }
 }

package/src/consts.local.ts

@@ -0,0 +1,29 @@
+/** How long one connect may take before the address counts as unreachable. */
+export const CONNECT_TIMEOUT_MS = 1_500
+
+/** The probe runs in a child process; this covers its own startup on a loaded machine. */
+export const SPAWN_GRACE_MS = 5_000
+
+// Runs under whichever runtime runs the suite (`process.execPath`), so it is plain CommonJS
+// that both `bun -e` and `node -e` evaluate.
+export const PROBE_SCRIPT = `
+const net = require('net')
+const [targets, timeout] = JSON.parse(process.env.OWLMEANS_TEST_PROBE)
+let pending = targets.length
+let last = ''
+for (const target of targets) {
+  let settled = false
+  const socket = net.connect({ host: target.host, port: target.port })
+  const fail = code => {
+    if (settled) return
+    settled = true
+    socket.destroy()
+    last = code
+    if (--pending === 0) { process.stdout.write(last); process.exit(1) }
+  }
+  socket.setTimeout(timeout)
+  socket.once('connect', () => process.exit(0))
+  socket.once('timeout', () => fail('ETIMEDOUT'))
+  socket.once('error', error => fail(error.code || String(error)))
+}
+`

package/src/gates.ts

@@ -1,11 +1,7 @@
 import { hasEnv, requireEnv } from '@owlmeans/test'
 import { unreachableReason } from './reachability.js'
-
-export interface IntegrationGate<E> {
-  skip: boolean
-  reason?: string
-  env: Partial<E>
-}
+import type { Reachable } from './types.local.js'
+import type { IntegrationGate, KubeEnv, MongoEnv, PostgresEnv, RedisEnv, S3Env, SmtpEnv } from './types.js'
 
 const collect = <E>(keys: (keyof E & string)[]): Partial<E> => {
   const env: Record<string, string> = {}
@@ -15,18 +11,6 @@ const collect = <E>(keys: (keyof E & string)[]): Partial<E> => {
   return env as Partial<E>
 }
 
-/**
- * A connection-string variable whose server must answer a TCP connect for the gate to open.
- *
- * Only for a service a developer reaches through a local address that can go away — a
- * port-forward, a container. A populated variable pointing at nothing then closes the gate with
- * a printed reason instead of failing every suite behind it on a refused connection.
- */
-interface Reachable<E> {
-  key: keyof E & string
-  defaultPort: number
-}
-
 const toIntegrationGate = <E>(
   required: (keyof E & string)[],
   optional: (keyof E & string)[] = [],
@@ -42,63 +26,24 @@ const toIntegrationGate = <E>(
   return { skip: false, env }
 }
 
-export interface MongoEnv {
-  MONGO_URL: string
-  MONGO_TEST_DB_PREFIX: string
-}
-
 export const mongoGate = (): IntegrationGate<MongoEnv> =>
   toIntegrationGate<MongoEnv>(['MONGO_URL'], ['MONGO_TEST_DB_PREFIX'], { key: 'MONGO_URL', defaultPort: 27017 })
 
-export interface RedisEnv {
-  REDIS_URL: string
-  REDIS_TEST_KEY_PREFIX: string
-}
-
 export const redisGate = (): IntegrationGate<RedisEnv> =>
   toIntegrationGate<RedisEnv>(['REDIS_URL'], ['REDIS_TEST_KEY_PREFIX'], { key: 'REDIS_URL', defaultPort: 6379 })
 
-export interface S3Env {
-  S3_ENDPOINT: string
-  S3_KEY: string
-  S3_SECRET: string
-  S3_TEST_BUCKET: string
-  S3_REGION: string
-}
-
 export const s3Gate = (): IntegrationGate<S3Env> =>
   toIntegrationGate<S3Env>(
     ['S3_ENDPOINT', 'S3_KEY', 'S3_SECRET', 'S3_TEST_BUCKET'],
     ['S3_REGION']
   )
 
-export interface KubeEnv {
-  KUBE_CONFIG: string
-  KUBE_TEST_OK: string
-}
-
 export const kubeGate = (): IntegrationGate<KubeEnv> =>
   toIntegrationGate<KubeEnv>(['KUBE_CONFIG', 'KUBE_TEST_OK'])
 
-export interface PostgresEnv {
-  POSTGRES_URL: string
-  POSTGRES_TEST_DB_PREFIX: string
-}
-
 export const postgresGate = (): IntegrationGate<PostgresEnv> =>
   toIntegrationGate<PostgresEnv>(['POSTGRES_URL'], ['POSTGRES_TEST_DB_PREFIX'], { key: 'POSTGRES_URL', defaultPort: 5432 })
 
-export interface SmtpEnv {
-  SMTP_HOST: string
-  SMTP_PORT: string
-  SMTP_SECURE: string
-  SMTP_USER: string
-  SMTP_PASSWORD: string
-  SMTP_FROM: string
-  /** Mailbox the specs deliver to. Required — these tests send real mail. */
-  SMTP_TEST_TO: string
-}
-
 export const smtpGate = (): IntegrationGate<SmtpEnv> =>
   toIntegrationGate<SmtpEnv>(
     ['SMTP_HOST', 'SMTP_USER', 'SMTP_PASSWORD', 'SMTP_FROM', 'SMTP_TEST_TO'],

package/src/index.ts

@@ -1,3 +1,4 @@
 export * from './gates.js'
+export type * from './types.js'
 export * from './naming.js'
 export * from './cleanup.js'

package/src/reachability.ts

@@ -1,4 +1,9 @@
 import { spawnSync } from 'node:child_process'
+import { logger } from '@owlmeans/log'
+import { CONNECT_TIMEOUT_MS, PROBE_SCRIPT, SPAWN_GRACE_MS } from './consts.local.js'
+import type { ProbeTarget } from './types.js'
+
+const log = logger('test-integration')
 
 /**
  * Whether the server a connection string names answers at all — asked synchronously, because
@@ -10,17 +15,6 @@ import { spawnSync } from 'node:child_process'
  * asked — never a login — so no driver is needed here and no credential leaves the variable.
  */
 
-export interface ProbeTarget {
-  host: string
-  port: number
-}
-
-/** How long one connect may take before the address counts as unreachable. */
-const CONNECT_TIMEOUT_MS = 1_500
-
-/** The probe runs in a child process; this covers its own startup on a loaded machine. */
-const SPAWN_GRACE_MS = 5_000
-
 const answers = new Map<string, string | null>()
 const warned = new Set<string>()
 
@@ -60,30 +54,6 @@ export const parseTargets = (url: string, defaultPort: number): ProbeTarget[] |
   return targets.length > 0 ? targets : null
 }
 
-// Runs under whichever runtime runs the suite (`process.execPath`), so it is plain CommonJS
-// that both `bun -e` and `node -e` evaluate.
-const PROBE_SCRIPT = `
-const net = require('net')
-const [targets, timeout] = JSON.parse(process.env.OWLMEANS_TEST_PROBE)
-let pending = targets.length
-let last = ''
-for (const target of targets) {
-  let settled = false
-  const socket = net.connect({ host: target.host, port: target.port })
-  const fail = code => {
-    if (settled) return
-    settled = true
-    socket.destroy()
-    last = code
-    if (--pending === 0) { process.stdout.write(last); process.exit(1) }
-  }
-  socket.setTimeout(timeout)
-  socket.once('connect', () => process.exit(0))
-  socket.once('timeout', () => fail('ETIMEDOUT'))
-  socket.once('error', error => fail(error.code || String(error)))
-}
-`
-
 /**
  * `null` when at least one target accepts a TCP connection, otherwise the reason none did.
  *
@@ -128,7 +98,7 @@ export const unreachableReason = (variable: string, url: string, defaultPort: nu
   const reason = `${variable} is set, but ${unreachable} — start the service (or its port-forward) to run these specs`
   if (!warned.has(reason)) {
     warned.add(reason)
-    console.warn(`@owlmeans/test-integration: skipping — ${reason}`)
+    log.warn('Skipping integration specs: a configured service is unreachable', { variable, unreachable })
   }
 
   return reason

package/src/types.local.ts

@@ -0,0 +1,13 @@
+export type CleanupFn = () => void | Promise<void>
+
+/**
+ * A connection-string variable whose server must answer a TCP connect for the gate to open.
+ *
+ * Only for a service a developer reaches through a local address that can go away — a
+ * port-forward, a container. A populated variable pointing at nothing then closes the gate with
+ * a printed reason instead of failing every suite behind it on a refused connection.
+ */
+export interface Reachable<E> {
+  key: keyof E & string
+  defaultPort: number
+}

package/src/types.ts

@@ -0,0 +1,49 @@
+export interface IntegrationGate<E> {
+  skip: boolean
+  reason?: string
+  env: Partial<E>
+}
+
+export interface MongoEnv {
+  MONGO_URL: string
+  MONGO_TEST_DB_PREFIX: string
+}
+
+export interface RedisEnv {
+  REDIS_URL: string
+  REDIS_TEST_KEY_PREFIX: string
+}
+
+export interface S3Env {
+  S3_ENDPOINT: string
+  S3_KEY: string
+  S3_SECRET: string
+  S3_TEST_BUCKET: string
+  S3_REGION: string
+}
+
+export interface KubeEnv {
+  KUBE_CONFIG: string
+  KUBE_TEST_OK: string
+}
+
+export interface PostgresEnv {
+  POSTGRES_URL: string
+  POSTGRES_TEST_DB_PREFIX: string
+}
+
+export interface SmtpEnv {
+  SMTP_HOST: string
+  SMTP_PORT: string
+  SMTP_SECURE: string
+  SMTP_USER: string
+  SMTP_PASSWORD: string
+  SMTP_FROM: string
+  /** Mailbox the specs deliver to. Required — these tests send real mail. */
+  SMTP_TEST_TO: string
+}
+
+export interface ProbeTarget {
+  host: string
+  port: number
+}