@jskit-ai/database-runtime-postgres 0.1.4

package/package.descriptor.mjs

@@ -0,0 +1,160 @@
+export default Object.freeze({
+  packageVersion: 1,
+  packageId: "@jskit-ai/database-runtime-postgres",
+  version: "0.1.4",
+  options: {
+    "db-host": {
+      required: false,
+      values: [],
+      defaultValue: "localhost",
+      promptLabel: "Database host",
+      promptHint: "Postgres host (for example 127.0.0.1)"
+    },
+    "db-port": {
+      required: false,
+      values: [],
+      defaultValue: "5432",
+      promptLabel: "Database port",
+      promptHint: "Postgres port (usually 5432)"
+    },
+    "db-name": {
+      required: true,
+      values: [],
+      promptLabel: "Database name",
+      promptHint: "Database name to connect to"
+    },
+    "db-user": {
+      required: true,
+      values: [],
+      promptLabel: "Database user",
+      promptHint: "Database username"
+    },
+    "db-password": {
+      required: true,
+      values: [],
+      inputType: "password",
+      promptLabel: "Database password",
+      promptHint: "Database password"
+    }
+  },
+  dependsOn: [
+    "@jskit-ai/database-runtime"
+  ],
+  capabilities: {
+    provides: [
+      "runtime.database.driver",
+      "runtime.database.driver.postgres"
+    ],
+    requires: [
+      "runtime.database"
+    ]
+  },
+  runtime: {
+    server: {
+      providerEntrypoint: "src/server/providers/DatabaseRuntimePostgresServiceProvider.js",
+      providers: [
+        {
+          entrypoint: "src/server/providers/DatabaseRuntimePostgresServiceProvider.js",
+          export: "DatabaseRuntimePostgresServiceProvider"
+        }
+      ]
+    },
+    client: {
+      providers: []
+    }
+  },
+  metadata: {
+    apiSummary: {
+      surfaces: [
+        {
+          subpath: "./server",
+          summary: "Exports Postgres database runtime provider."
+        },
+        {
+          subpath: "./shared",
+          summary: "Exports Postgres dialect metadata helpers."
+        },
+        {
+          subpath: "./client",
+          summary: "Exports no runtime API today (reserved client entrypoint)."
+        }
+      ],
+      containerTokens: {
+        server: [
+          "runtime.database.driver.postgres"
+        ],
+        client: []
+      }
+    }
+  },
+  mutations: {
+    dependencies: {
+      runtime: {
+        "@jskit-ai/database-runtime": "0.1.4",
+        "pg": "^8.13.1"
+      },
+      dev: {}
+    },
+    packageJson: {
+      scripts: {}
+    },
+    procfile: {},
+    files: [],
+    text: [
+      {
+        file: ".env",
+        op: "upsert-env",
+        key: "DB_CLIENT",
+        value: "pg",
+        reason: "Configure database client driver for runtime wiring.",
+        category: "runtime-config",
+        id: "database-client-postgres"
+      },
+      {
+        file: ".env",
+        op: "upsert-env",
+        key: "DB_HOST",
+        value: "${option:db-host}",
+        reason: "Configure database host.",
+        category: "runtime-config",
+        id: "database-host"
+      },
+      {
+        file: ".env",
+        op: "upsert-env",
+        key: "DB_PORT",
+        value: "${option:db-port}",
+        reason: "Configure database port.",
+        category: "runtime-config",
+        id: "database-port"
+      },
+      {
+        file: ".env",
+        op: "upsert-env",
+        key: "DB_NAME",
+        value: "${option:db-name}",
+        reason: "Configure database name.",
+        category: "runtime-config",
+        id: "database-name"
+      },
+      {
+        file: ".env",
+        op: "upsert-env",
+        key: "DB_USER",
+        value: "${option:db-user}",
+        reason: "Configure database user.",
+        category: "runtime-config",
+        id: "database-user"
+      },
+      {
+        file: ".env",
+        op: "upsert-env",
+        key: "DB_PASSWORD",
+        value: "${option:db-password}",
+        reason: "Configure database password.",
+        category: "runtime-config",
+        id: "database-password"
+      }
+    ]
+  }
+});

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@jskit-ai/database-runtime-postgres",
+  "version": "0.1.4",
+  "type": "module",
+  "scripts": {
+    "test": "node --test"
+  },
+  "exports": {
+    "./client": "./src/client/index.js",
+    "./server/providers/DatabaseRuntimePostgresServiceProvider": "./src/server/providers/DatabaseRuntimePostgresServiceProvider.js",
+    "./shared": "./src/shared/index.js",
+    "./shared/dialect": "./src/shared/dialect.js"
+  },
+  "dependencies": {
+    "@jskit-ai/database-runtime": "0.1.4"
+  }
+}

package/src/client/index.js

@@ -0,0 +1 @@
+export {};

package/src/server/providers/DatabaseRuntimePostgresServiceProvider.js

@@ -0,0 +1,23 @@
+import * as postgresDialect from "../../shared/index.js";
+
+const DATABASE_DRIVER_POSTGRES_TOKEN = "runtime.database.driver.postgres";
+
+const POSTGRES_DATABASE_DRIVER_API = Object.freeze({
+  ...postgresDialect
+});
+
+class DatabaseRuntimePostgresServiceProvider {
+  static id = DATABASE_DRIVER_POSTGRES_TOKEN;
+
+  register(app) {
+    if (!app || typeof app.singleton !== "function") {
+      throw new Error("DatabaseRuntimePostgresServiceProvider requires application singleton().");
+    }
+
+    app.singleton(DATABASE_DRIVER_POSTGRES_TOKEN, () => POSTGRES_DATABASE_DRIVER_API);
+  }
+
+  boot() {}
+}
+
+export { DatabaseRuntimePostgresServiceProvider };

package/src/shared/dialect.js

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

package/src/shared/index.js

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

package/test/entrypoints.boundary.test.js

@@ -0,0 +1,32 @@
+import assert from "node:assert/strict";
+import { readFile } from "node:fs/promises";
+import test from "node:test";
+
+import * as clientApi from "../src/client/index.js";
+import * as sharedApi from "../src/shared/index.js";
+import { DatabaseRuntimePostgresServiceProvider } from "../src/server/providers/DatabaseRuntimePostgresServiceProvider.js";
+
+test("package exports include explicit shared and provider entrypoints", async () => {
+  const packageJson = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8"));
+  const exportsMap = packageJson && typeof packageJson === "object" ? packageJson.exports : {};
+  assert.equal(exportsMap["./server"], undefined);
+  assert.equal(
+    exportsMap["./server/providers/DatabaseRuntimePostgresServiceProvider"],
+    "./src/server/providers/DatabaseRuntimePostgresServiceProvider.js"
+  );
+  assert.equal(exportsMap["./shared"], "./src/shared/index.js");
+});
+
+test("client entrypoint exports no postgres runtime api", () => {
+  assert.deepEqual(Object.keys(clientApi), []);
+});
+
+test("server provider module exports postgres service provider only", () => {
+  assert.equal(typeof DatabaseRuntimePostgresServiceProvider, "function");
+});
+
+test("shared entrypoint exports postgres dialect helpers", () => {
+  assert.equal(sharedApi.DIALECT_ID, "pg");
+  assert.equal(sharedApi.getDialectId(), "pg");
+  assert.equal(typeof sharedApi.DatabaseRuntimePostgresServiceProvider, "undefined");
+});

package/test/providerRuntime.test.js

@@ -0,0 +1,33 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { DatabaseRuntimePostgresServiceProvider } from "../src/server/providers/DatabaseRuntimePostgresServiceProvider.js";
+
+function createSingletonApp() {
+  const singletons = new Map();
+
+  return {
+    has(token) {
+      return singletons.has(token);
+    },
+    singleton(token, factory) {
+      singletons.set(token, factory(this));
+    },
+    make(token) {
+      if (!singletons.has(token)) {
+        throw new Error(`Token ${String(token)} is not registered.`);
+      }
+      return singletons.get(token);
+    }
+  };
+}
+
+test("DatabaseRuntimePostgresServiceProvider registers postgres driver api", () => {
+  const app = createSingletonApp();
+  const provider = new DatabaseRuntimePostgresServiceProvider();
+  provider.register(app);
+
+  assert.equal(app.has("runtime.database.driver.postgres"), true);
+  const api = app.make("runtime.database.driver.postgres");
+  assert.equal(api.DIALECT_ID, "pg");
+  assert.equal(api.getDialectId(), "pg");
+});