@jskit-ai/database-runtime-postgres 0.1.249 → 0.1.251

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/database-runtime-postgres",
-  "version": "0.1.249",
+  "version": "0.1.251",
   "type": "module",
   "scripts": {
     "test": "node --test --test-concurrency=1"
@@ -12,11 +12,11 @@
     "./shared/dialect": "./src/shared/dialect.js"
   },
   "dependencies": {
-    "@jskit-ai/database-runtime": "0.1.252",
+    "@jskit-ai/database-runtime": "0.1.254",
     "pg": "^8.13.1"
   },
   "peerDependencies": {
-    "@jskit-ai/kernel": "0.2.3"
+    "@jskit-ai/kernel": "0.2.5"
   },
   "jskit": {
     "kind": "runtime",

package/patterns/postgres-application/PATTERN.md

@@ -38,7 +38,10 @@ decisions, not framework questions.
 ## Framework APIs
 
 Use `createKnexMigrationConfigFromApp()` from
-`@jskit-ai/database-runtime/server/knexMigrationConfig`. The running JSKIT
+`@jskit-ai/database-runtime/server/knexMigrationConfig`, and
+`prepareDatabaseFromApp()` from `@jskit-ai/database-runtime/server/databaseSetup`.
+Both take the dialect and the application's environment
+(`environment: process.env`), which they never read on their own. The running JSKIT
 application automatically selects the sole installed database driver, while
 Knex discovers package-owned migrations from the installed dependency graph.
 
@@ -50,6 +53,14 @@ dialect. `example/scripts/prepare-database.js` is the portable
 migrate-then-seed entrypoint for managed sessions and deployments.
 `example/.env.example` names the five connection values without a secret.
 
+`example/.github/workflows/verify.yml` is a normal app-owned CI workflow with
+exactly one database service: `postgres` (`postgres:17`, `POSTGRES_*`
+variables, port `5432`, a `pg_isready` health check). Copy it whole from this
+pattern and adapt it as source rather than generating it from package metadata.
+Do not combine it with the MySQL pattern's workflow: a PostgreSQL application's
+workflow has no `mariadb` service, `MARIADB_*` variables, port `3306`, or
+`healthcheck.sh` option.
+
 ## Variation points
 
 Change scripts, migration location, connection values, and secret injection to
@@ -66,10 +77,9 @@ it as `seed` to `prepareDatabaseFromApp()`.
 - Run `npm run db:migrate:status` and the application verification command.
 - Exercise one transaction and one negative connection case.
 - When a seed exists, run `db:prepare` twice and require the second run to be safe.
-
-`example/.github/workflows/verify.yml` is a normal app-owned CI workflow with
-an explicit PostgreSQL service. Adapt it as source rather than generating it
-from package metadata.
+- Confirm `.github/workflows/verify.yml` parses as YAML and declares only the
+  `postgres` service. GitHub reports an unparseable workflow only as a failed
+  run with "no jobs were run".
 
 ## Avoid
 
@@ -77,4 +87,5 @@ from package metadata.
 - generated `.env` secrets
 - depending on a live schema as the source contract
 - a second driver installed “just in case”
+- any file, service, port, or variable copied from the MySQL pattern
 - migration receipts, provenance, replay logs, or generator ownership

package/patterns/postgres-application/example/knexfile.js

@@ -1,11 +1,11 @@
 import { createKnexMigrationConfigFromApp } from "@jskit-ai/database-runtime/server/knexMigrationConfig";
 
 try {
-  process.loadEnvFile?.(".env");
+  process.loadEnvFile(".env");
 } catch (error) {
   if (error?.code !== "ENOENT") {
     throw error;
   }
 }
 
-export default await createKnexMigrationConfigFromApp({ client: "pg" });
+export default await createKnexMigrationConfigFromApp({ client: "pg", environment: process.env });

package/patterns/postgres-application/example/package.json

@@ -8,6 +8,6 @@
     "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
   },
   "dependencies": {
-    "@jskit-ai/database-runtime-postgres": "0.1.249"
+    "@jskit-ai/database-runtime-postgres": "0.1.251"
   }
 }

package/patterns/postgres-application/example/scripts/prepare-database.js

@@ -1,3 +1,3 @@
 import { prepareDatabaseFromApp } from "@jskit-ai/database-runtime/server/databaseSetup";
 
-await prepareDatabaseFromApp({ client: "pg" });
+await prepareDatabaseFromApp({ client: "pg", environment: process.env });

package/src/server/providers/PostgresDatabaseDriverProvider.js

@@ -1,5 +1,5 @@
 import { defineProvider } from "@jskit-ai/kernel/shared/capabilities";
-import * as postgresDriver from "../../shared/index.js";
+import { DIALECT_ID } from "../../shared/index.js";
 
 const PostgresDatabaseDriverProvider = defineProvider({
   id: "runtime.database.driver.postgres",
@@ -8,7 +8,7 @@ const PostgresDatabaseDriverProvider = defineProvider({
   },
   setup() {
     return {
-      driver: Object.freeze({ ...postgresDriver })
+      driver: Object.freeze({ DIALECT_ID })
     };
   }
 });

package/src/shared/dialect.js

@@ -1,7 +1,3 @@
 const DIALECT_ID = "pg";
 
-function getDialectId() {
-  return DIALECT_ID;
-}
-
-export { DIALECT_ID, getDialectId };
+export { DIALECT_ID };

package/src/shared/index.js

@@ -1 +1 @@
-export { DIALECT_ID, getDialectId } from "./dialect.js";
+export { DIALECT_ID } from "./dialect.js";

package/test/entrypoints.boundary.test.js

@@ -28,6 +28,5 @@ test("server provider module exports the declarative postgres driver provider",
 
 test("shared entrypoint exports postgres dialect helpers", () => {
   assert.equal(sharedApi.DIALECT_ID, "pg");
-  assert.equal(sharedApi.getDialectId(), "pg");
   assert.equal(typeof sharedApi.PostgresDatabaseDriverProvider, "undefined");
 });

package/test/providerRuntime.test.js

@@ -18,6 +18,5 @@ test("PostgresDatabaseDriverProvider provides the exclusive database driver capa
 
   await runtime.start();
   assert.equal(driver.DIALECT_ID, "pg");
-  assert.equal(driver.getDialectId(), "pg");
   await runtime.shutdown();
 });