@zeroxsolutions/db 8.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 |
 
 ---
 
@@ -476,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 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,10 +1,4 @@
 import { type PostgresJsDatabase } from 'drizzle-orm/postgres-js';
-/**
- * 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. */
 export declare const CONTAINER_TIMEOUT_MS = 180000;
 /** A throwaway Postgres carrying one schema, and the handle that tears its container down. */

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;;;;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"}
+{"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,12 +2,6 @@ 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 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. */
 export const CONTAINER_TIMEOUT_MS = 180_000;
 /**

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": "8.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",