@saws/postgres-client 2.0.0-beta.3

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@saws/postgres-client",
+  "version": "2.0.0-beta.3",
+  "description": "",
+  "license": "ISC",
+  "author": "",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@types/pg": "^8.15.5",
+    "pg": "^8.16.3"
+  }
+}

package/src/PostgresClient.ts

@@ -0,0 +1,57 @@
+import { Pool, type PoolConfig } from "pg";
+
+export interface PostgresClientOptions extends PoolConfig {
+  /** Explicit environment source for application adapters. */
+  environment?: Record<string, string | undefined>;
+}
+
+export class PostgresClient extends Pool {
+  constructor(serviceName: string, options: PostgresClientOptions = {}) {
+    const { environment, ...poolOptions } = options;
+
+    super({
+      connectionString: resolvePostgresServiceUrl(serviceName, environment),
+      ...poolOptions,
+    });
+  }
+}
+
+export function resolvePostgresServiceUrl(
+  serviceName: string,
+  environment?: Record<string, string | undefined>,
+) {
+  const variableName = postgresServiceUrlEnvironmentVariable(serviceName);
+  const value =
+    environment?.[variableName] ??
+    getRuntimeEnvironment()?.[variableName] ??
+    getProcessEnvironment()?.[variableName];
+
+  if (value == null || value.trim().length === 0) {
+    throw new Error(
+      `Postgres service "${serviceName}" is not configured: ` +
+        `${variableName} must be present in the SAWS environment`,
+    );
+  }
+
+  return value;
+}
+
+export function postgresServiceUrlEnvironmentVariable(serviceName: string) {
+  return `${serviceName.replace(/[^a-zA-Z\d]/g, "_").toUpperCase()}_DATABASE_URL`;
+}
+
+function getRuntimeEnvironment() {
+  return (
+    globalThis as typeof globalThis & {
+      ENV?: Record<string, string | undefined>;
+    }
+  ).ENV;
+}
+
+function getProcessEnvironment() {
+  return (
+    globalThis as typeof globalThis & {
+      process?: { env?: Record<string, string | undefined> };
+    }
+  ).process?.env;
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./PostgresClient.js";
+export * from "pg";

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig-node.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "tsBuildInfoFile": "./dist/.tsbuildinfo"
+  }
+}