@zeroxsolutions/db 7.0.0 → 9.0.0

package/README.md

@@ -38,7 +38,7 @@ declares `"."`, but no `src/index.ts` exists for the build to emit it from, so
 | `@zeroxsolutions/db/postgres` | PostgreSQL entity, repository, view repository, unit of work, outbox, and types |
 | `@zeroxsolutions/db/d1`  | Cloudflare D1 (SQLite) entity, repository, unit of work, outbox, and types |
 | `@zeroxsolutions/db/utils` | Filter and order builders, `TableQuery` and the relational-read builder, the field-whitelist guard, the filter-value schema + operator enum, omit masks, pagination constants |
-| `@zeroxsolutions/db/testing` | A throwaway Postgres container carrying your schema, the image and timeout constants, and a fake uuid v7 |
+| `@zeroxsolutions/db/testing` | A throwaway Postgres container carrying your schema, on the engine you name, plus the container timeout and a fake uuid v7 |
 
 ---
 
@@ -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 () => {
@@ -472,10 +476,13 @@ afterAll(async () => {
 A suite that cannot use the client - a worker e2e reaching its database through a Hyperdrive
 binding - takes `database.connectionString` and hands that to its test pool instead.
 
+This package names no engine for you, and exports no constant standing in as that argument. Which
+major you run is your deployment's own fact, so `image` takes no default: a forgotten argument is a
+typecheck failure rather than a suite that quietly passed on a major you do not deploy.
+
 | 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 |
 | `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,9 +1,4 @@
 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.
- */
-export declare const POSTGRES_IMAGE = "postgres:18-alpine";
 /** Pulling the image on a cold machine costs far more than vitest's 5s default timeout. */
 export declare const CONTAINER_TIMEOUT_MS = 180000;
 /** A throwaway Postgres carrying one schema, and the handle that tears its container down. */
@@ -20,7 +15,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,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

@@ -2,20 +2,17 @@ import { PostgreSqlContainer } from '@testcontainers/postgresql';
 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.
- */
-export const POSTGRES_IMAGE = 'postgres:18-alpine';
 /** Pulling the image on a cold machine costs far more than vitest's 5s default timeout. */
 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/dist/testing/postgres-image.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The Postgres engine this package's own specs run on, named once for all of them.
+ * Deliberately outside `index.ts`, so no consumer can import it: which engine a context runs is that
+ * context's own fact, and a constant a consumer could pass would carry this package's answer under
+ * that consumer's name, exactly as a default parameter would.
+ */
+export declare const POSTGRES_IMAGE = "postgres:18-alpine";
+//# sourceMappingURL=postgres-image.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-image.d.ts","sourceRoot":"","sources":["../../src/testing/postgres-image.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,uBAAuB,CAAC"}

package/dist/testing/postgres-image.js

@@ -0,0 +1,7 @@
+/**
+ * The Postgres engine this package's own specs run on, named once for all of them.
+ * Deliberately outside `index.ts`, so no consumer can import it: which engine a context runs is that
+ * context's own fact, and a constant a consumer could pass would carry this package's answer under
+ * that consumer's name, exactly as a default parameter would.
+ */
+export const POSTGRES_IMAGE = 'postgres:18-alpine';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeroxsolutions/db",
-  "version": "7.0.0",
+  "version": "9.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",