@zeroxsolutions/db 7.0.0 → 8.0.0

package/README.md

@@ -458,10 +458,14 @@ import {
 } from '@zeroxsolutions/db/testing';
 import * as schema from './lib/db/index.js';
 
+// The engine THIS package deploys, written down once here. It is asked for rather than defaulted:
+// only you know which major your deployment runs, and a container started on another one passes.
+const POSTGRES_IMAGE = 'postgres:17-alpine';
+
 let database: DisposablePostgres<typeof schema>;
 
 beforeAll(async () => {
-  database = await startDisposablePostgres(schema);
+  database = await startDisposablePostgres(schema, POSTGRES_IMAGE);
 }, CONTAINER_TIMEOUT_MS);
 
 afterAll(async () => {
@@ -474,8 +478,8 @@ binding - takes `database.connectionString` and hands that to its test pool inst
 
 | Export | What it is |
 | ------ | ---------- |
-| `startDisposablePostgres(schema, image?)` | Starts the container, creates `schema` in it, and returns a Drizzle client typed against it, the `connectionString` it dialled, and the `stop()` that tears it down |
-| `POSTGRES_IMAGE` | `postgres:18-alpine`, the default `image` - the one place the engine version is written down, so a container started by hand takes it from here too |
+| `startDisposablePostgres(schema, image)` | Starts the container, creates `schema` in it, and returns a Drizzle client typed against it, the `connectionString` it dialled, and the `stop()` that tears it down |
+| `POSTGRES_IMAGE` | `postgres:18-alpine`, the engine this package's own specs run on. Yours is your own to name: `image` takes no default, so a forgotten argument is a typecheck failure rather than a suite that quietly ran a major you do not deploy |
 | `CONTAINER_TIMEOUT_MS` | 180s, for the hook that starts a container: an image pull on a cold machine outruns vitest's 5s default |
 | `fakeUuidV7` | Random bits in a v7 layout: it passes a v7 check, and is not time-ordered like a minted id |
 

package/dist/testing/disposable-postgres.d.ts

@@ -1,7 +1,8 @@
 import { type PostgresJsDatabase } from 'drizzle-orm/postgres-js';
 /**
- * The Postgres engine every test starting a container runs against - the one place the version is written down.
- * The major tracks the deployed engine, which nothing in this workspace pins: iac carries only a connection string.
+ * The Postgres engine this package's own container-starting specs run against.
+ * A consumer names its own instead: which engine a context runs is that context's fact, and its major
+ * tracks what that context deploys, not what this package happens to test on.
  */
 export declare const POSTGRES_IMAGE = "postgres:18-alpine";
 /** Pulling the image on a cold machine costs far more than vitest's 5s default timeout. */
@@ -20,7 +21,9 @@ export interface DisposablePostgres<TSchema extends Record<string, unknown>> {
  * Starts a Postgres container, creates `schema` inside it, and returns a client typed against it
  * plus the address it dialled.
  * @param schema - the drizzle tables and relations to create; the module namespace of a schema barrel.
- * @param image - the Postgres image to run, defaulting to {@link POSTGRES_IMAGE}.
+ * @param image - the Postgres image to run. It carries no default because only the caller knows which
+ * engine its own deployment runs: a default would let a forgotten argument run a whole suite against
+ * another major, passing, and reading afterwards like the engine that caller chose.
  */
-export declare function startDisposablePostgres<TSchema extends Record<string, unknown>>(schema: TSchema, image?: string): Promise<DisposablePostgres<TSchema>>;
+export declare function startDisposablePostgres<TSchema extends Record<string, unknown>>(schema: TSchema, image: string): Promise<DisposablePostgres<TSchema>>;
 //# sourceMappingURL=disposable-postgres.d.ts.map

package/dist/testing/disposable-postgres.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disposable-postgres.d.ts","sourceRoot":"","sources":["../../src/testing/disposable-postgres.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG3E;;;GAGG;AACH,eAAO,MAAM,cAAc,uBAAuB,CAAC;AAEnD,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAE5C,8FAA8F;AAC9F,MAAM,WAAW,kBAAkB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzE,EAAE,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAChC;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnF,MAAM,EAAE,OAAO,EACf,KAAK,GAAE,MAAuB,GAC7B,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAiBtC"}
+{"version":3,"file":"disposable-postgres.d.ts","sourceRoot":"","sources":["../../src/testing/disposable-postgres.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG3E;;;;GAIG;AACH,eAAO,MAAM,cAAc,uBAAuB,CAAC;AAEnD,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAE5C,8FAA8F;AAC9F,MAAM,WAAW,kBAAkB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzE,EAAE,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAChC;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnF,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAiBtC"}

package/dist/testing/disposable-postgres.js

@@ -3,8 +3,9 @@ import { generateDrizzleJson, generateMigration } from 'drizzle-kit/api';
 import { drizzle } from 'drizzle-orm/postgres-js';
 import postgres from 'postgres';
 /**
- * The Postgres engine every test starting a container runs against - the one place the version is written down.
- * The major tracks the deployed engine, which nothing in this workspace pins: iac carries only a connection string.
+ * The Postgres engine this package's own container-starting specs run against.
+ * A consumer names its own instead: which engine a context runs is that context's fact, and its major
+ * tracks what that context deploys, not what this package happens to test on.
  */
 export const POSTGRES_IMAGE = 'postgres:18-alpine';
 /** Pulling the image on a cold machine costs far more than vitest's 5s default timeout. */
@@ -13,9 +14,11 @@ export const CONTAINER_TIMEOUT_MS = 180_000;
  * Starts a Postgres container, creates `schema` inside it, and returns a client typed against it
  * plus the address it dialled.
  * @param schema - the drizzle tables and relations to create; the module namespace of a schema barrel.
- * @param image - the Postgres image to run, defaulting to {@link POSTGRES_IMAGE}.
+ * @param image - the Postgres image to run. It carries no default because only the caller knows which
+ * engine its own deployment runs: a default would let a forgotten argument run a whole suite against
+ * another major, passing, and reading afterwards like the engine that caller chose.
  */
-export async function startDisposablePostgres(schema, image = POSTGRES_IMAGE) {
+export async function startDisposablePostgres(schema, image) {
     const container = await new PostgreSqlContainer(image).start();
     const connectionString = container.getConnectionUri();
     const client = postgres(connectionString);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeroxsolutions/db",
-  "version": "7.0.0",
+  "version": "8.0.0",
   "description": "Generic Drizzle toolkit - the id column and audit timestamps a table takes, a base repository, the unit-of-work and transactional outbox impls, and the filter/sort/pagination query helpers, for PostgreSQL (postgres-js) and Cloudflare D1; ships no domain schema. Shared across ZeroXSolutions services.",
   "private": false,
   "type": "module",
@@ -37,8 +37,8 @@
   "dependencies": {
     "tslib": "^2.3.0",
     "uuid": "^14.0.1",
-    "@zeroxsolutions/query": "0.5.1",
-    "@zeroxsolutions/cosmic": "0.3.4"
+    "@zeroxsolutions/cosmic": "0.3.4",
+    "@zeroxsolutions/query": "0.5.1"
   },
   "peerDependencies": {
     "@testcontainers/postgresql": "^12.1.0",