@shivaedev/local-postgres 0.14.1 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.16.0 - 2026-11-07
+
+### Added
+
+- Allow an explicit list of ports in `assertLocalDatabase` so test configuration can accept a loopback PostgreSQL CI service while shared development setup keeps port 55432 as its default.
+
+## 0.15.0 - 2026-11-05
+
+### Breaking
+
+- Require Effect 4.1.0 and its matching companion packages. Move `effect`, `@effect/platform-node`, `@effect/platform-node-shared`, `@effect/sql-pg`, `@effect/sql-sqlite-node`, `@effect/atom-react` and `@effect/vitest` to exactly 4.1.0 together.
+
 ## 0.14.1 - 2026-11-04
 
 ### Changed

package/README.md

@@ -71,6 +71,8 @@ const setup = Effect.gen(function* () {
 
 `assertLocalDatabase` applies the same local-target checks and also rejects a database name outside the caller's allowlist. The fixed names above provide an independent application policy.
 
+`assertLocalDatabase(value, names, ports)` accepts an explicit allowed-port list when validating test configuration. Repository CI and generated app tests read `TEST_DATABASE_URL` through Effect Config and validate it with ports `["55432", "5432"]`, accepting the shared development service or a loopback PostgreSQL CI service. Remote hosts and redirecting connection parameters are refused. Omitting `ports` retains the shared setup restriction to port 55432. Service preparation always retains that restriction.
+
 ### 2. Once per feature: prepare its schema in application tooling
 
 After `prepareDatabases`, run the application's own schema or migration entry point. This package provides no schema model, migration ledger, fixture catalogue or seed convention. `@shivaedev/sql` owns the SQL and migration APIs.

package/dist/server/assertLocalDatabase.d.ts

@@ -1,4 +1,4 @@
 import { Result } from "effect";
 import { LocalPostgresError } from "#server/LocalPostgresError.ts";
-export declare function assertLocalDatabase(value: string, names: readonly string[]): Result.Result<import("url").URL, LocalPostgresError>;
+export declare function assertLocalDatabase(value: string, names: readonly string[], ports?: readonly string[]): Result.Result<import("url").URL, LocalPostgresError>;
 //# sourceMappingURL=assertLocalDatabase.d.ts.map

package/dist/server/assertLocalDatabase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assertLocalDatabase.d.ts","sourceRoot":"","sources":["../../src/server/assertLocalDatabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,wDAc1E"}
+{"version":3,"file":"assertLocalDatabase.d.ts","sourceRoot":"","sources":["../../src/server/assertLocalDatabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,GAAE,SAAS,MAAM,EAAc,wDAiBhH"}

package/dist/server/assertLocalDatabase.js

@@ -1,13 +1,14 @@
 import { Result } from "effect";
 import { LocalPostgresError } from "#server/LocalPostgresError.ts";
-export function assertLocalDatabase(value, names) {
+export function assertLocalDatabase(value, names, ports = ["55432"]) {
     return Result.gen(function* () {
-        const message = `Use a local database on 127.0.0.1:55432 named ${names.join(" or ")}.`;
+        const message = `Use a local database on 127.0.0.1:${ports.join(" or ")} named ${names.join(" or ")}.`;
         const url = yield* Result.try({ catch: () => new LocalPostgresError({ message }), try: () => new URL(value) });
-        if (!(["postgres:", "postgresql:"].includes(url.protocol) && ["localhost", "127.0.0.1"].includes(url.hostname))
-            || url.port !== "55432"
-            || ["host", "hostaddr", "port", "dbname", "service"].some((key) => url.searchParams.has(key))
-            || !names.includes(url.pathname.slice(1))) {
+        if (!(["postgres:", "postgresql:"].includes(url.protocol)
+            && ["localhost", "127.0.0.1"].includes(url.hostname)
+            && ports.includes(url.port)
+            && names.includes(url.pathname.slice(1)))
+            || ["host", "hostaddr", "port", "dbname", "service"].some((key) => url.searchParams.has(key))) {
             return yield* Result.fail(new LocalPostgresError({ message }));
         }
         return url;

package/dist/server/assertLocalDatabase.js.map

@@ -1 +1 @@
-{"version":3,"file":"assertLocalDatabase.js","sourceRoot":"","sources":["../../src/server/assertLocalDatabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAwB;IAC1E,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC1B,MAAM,OAAO,GAAG,iDAAiD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;QACvF,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/G,IACC,CAAC,CAAC,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;eACxG,GAAG,CAAC,IAAI,KAAK,OAAO;eACpB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;eAC1F,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACxC,CAAC;YACF,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"assertLocalDatabase.js","sourceRoot":"","sources":["../../src/server/assertLocalDatabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAwB,EAAE,KAAK,GAAsB,CAAC,OAAO,CAAC;IAChH,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC1B,MAAM,OAAO,GAAG,qCAAqC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;QACvG,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/G,IACC,CAAC,CACA,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;eAChD,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;eACjD,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;eACxB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACxC;eACE,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAC5F,CAAC;YACF,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/local-postgres",
-  "version": "0.14.1",
+  "version": "0.16.0",
   "description": "Repeatable local PostgreSQL preparation with one shared persistent service",
   "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/local-postgres#readme",
   "bugs": {
@@ -40,16 +40,16 @@
     "README.md"
   ],
   "devDependencies": {
-    "@effect/platform-node": "4.0.7",
-    "@shivaedev/quality": "0.61.1",
-    "@shivaedev/test-story": "0.39.1",
+    "@effect/platform-node": "4.1.1",
+    "@shivaedev/quality": "0.69.5",
+    "@shivaedev/test-story": "0.45.1",
     "@types/node": "24.19.2",
-    "effect": "4.0.7",
+    "effect": "4.1.1",
     "typescript": "7.0.2",
     "vitest": "5.0.5"
   },
   "peerDependencies": {
-    "effect": "4.0.7"
+    "effect": "4.1.1"
   },
   "engines": {
     "node": ">=24"

package/src/server/assertLocalDatabase.ts

@@ -1,15 +1,18 @@
 import { Result } from "effect";
 import { LocalPostgresError } from "#server/LocalPostgresError.ts";
 
-export function assertLocalDatabase(value: string, names: readonly string[]) {
+export function assertLocalDatabase(value: string, names: readonly string[], ports: readonly string[] = ["55432"]) {
 	return Result.gen(function* () {
-		const message = `Use a local database on 127.0.0.1:55432 named ${names.join(" or ")}.`;
+		const message = `Use a local database on 127.0.0.1:${ports.join(" or ")} named ${names.join(" or ")}.`;
 		const url = yield* Result.try({ catch: () => new LocalPostgresError({ message }), try: () => new URL(value) });
 		if (
-			!(["postgres:", "postgresql:"].includes(url.protocol) && ["localhost", "127.0.0.1"].includes(url.hostname))
-			|| url.port !== "55432"
+			!(
+				["postgres:", "postgresql:"].includes(url.protocol)
+				&& ["localhost", "127.0.0.1"].includes(url.hostname)
+				&& ports.includes(url.port)
+				&& names.includes(url.pathname.slice(1))
+			)
 			|| ["host", "hostaddr", "port", "dbname", "service"].some((key) => url.searchParams.has(key))
-			|| !names.includes(url.pathname.slice(1))
 		) {
 			return yield* Result.fail(new LocalPostgresError({ message }));
 		}