@medicine-wheel/data-store-postgres 0.2.2

package/README.md

@@ -0,0 +1,20 @@
+# @medicine-wheel/data-store-postgres
+
+Minimal PostgreSQL/Neon scaffold for the Medicine Wheel workspace.
+
+What it gives the local agent:
+- a workspace package placeholder for a Postgres backend
+- a shared `pg` Pool helper keyed by effective connection options
+- a typed seam that reuses `ontology-core` records
+- SSL only when explicitly requested via options, connection-string parameters, or `PGSSLMODE=require|verify-ca|verify-full`
+
+Convergence note:
+- the selected long-term provider abstraction lives in `src/storage-provider`
+- this package remains a small Postgres scaffold, not the primary backend-selection surface
+
+What it does not do yet:
+- no tables
+- no migrations
+- no CRUD beyond pool management
+- no app wiring
+

package/dist/connection.d.ts

@@ -0,0 +1,16 @@
+import { Pool, type PoolClient } from 'pg';
+import type { CeremonyLog, RelationalEdge, RelationalNode } from '@medicine-wheel/ontology-core';
+export type PostgresProviderRecord = RelationalNode | RelationalEdge | CeremonyLog;
+export interface PostgresConnectionOptions {
+    connectionString?: string;
+    ssl?: boolean;
+    max?: number;
+    idleTimeoutMillis?: number;
+    applicationName?: string;
+}
+export declare function createPostgresPool(options?: PostgresConnectionOptions): Pool;
+export declare function getPostgresPool(options?: PostgresConnectionOptions): Pool;
+export declare function withPostgresClient<T>(fn: (client: PoolClient) => Promise<T>, options?: PostgresConnectionOptions): Promise<T>;
+export declare function closePostgresPool(options?: PostgresConnectionOptions): Promise<void>;
+export declare function resetPostgresPoolForTests(): Promise<void>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,UAAU,EAAmB,MAAM,IAAI,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEjG,MAAM,MAAM,sBAAsB,GAAG,cAAc,GAAG,cAAc,GAAG,WAAW,CAAC;AAEnF,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAsBD,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAE5E;AAED,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAWzE;AAED,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,EAAE,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,EACtC,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,wBAAsB,iBAAiB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1F;AAED,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAO/D"}

package/dist/connection.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPostgresPool = createPostgresPool;
+exports.getPostgresPool = getPostgresPool;
+exports.withPostgresClient = withPostgresClient;
+exports.closePostgresPool = closePostgresPool;
+exports.resetPostgresPoolForTests = resetPostgresPoolForTests;
+const pg_1 = require("pg");
+const singletonPools = new Map();
+function resolvePoolConfig(options) {
+    const connectionString = options?.connectionString ??
+        process.env.DATABASE_URL ??
+        process.env.POSTGRES_URL ??
+        process.env.NEON_DATABASE_URL;
+    const useSsl = resolveSslEnabled(connectionString, options?.ssl);
+    return {
+        connectionString,
+        max: options?.max ?? 10,
+        idleTimeoutMillis: options?.idleTimeoutMillis ?? 30000,
+        application_name: options?.applicationName ?? '@medicine-wheel/data-store-postgres',
+        ssl: useSsl ? { rejectUnauthorized: true } : undefined,
+    };
+}
+function createPostgresPool(options) {
+    return new pg_1.Pool(resolvePoolConfig(options));
+}
+function getPostgresPool(options) {
+    const poolKey = getPoolKey(options);
+    const existingPool = singletonPools.get(poolKey);
+    if (existingPool) {
+        return existingPool;
+    }
+    const pool = createPostgresPool(options);
+    singletonPools.set(poolKey, pool);
+    return pool;
+}
+async function withPostgresClient(fn, options) {
+    const client = await getPostgresPool(options).connect();
+    try {
+        return await fn(client);
+    }
+    finally {
+        client.release();
+    }
+}
+async function closePostgresPool(options) {
+    if (options !== undefined) {
+        // Close only the pool that matches the given options, leaving others intact.
+        const poolKey = getPoolKey(options);
+        const pool = singletonPools.get(poolKey);
+        if (pool) {
+            await pool.end();
+            singletonPools.delete(poolKey);
+        }
+        return;
+    }
+    await Promise.all(Array.from(singletonPools.values(), (pool) => pool.end()));
+    singletonPools.clear();
+}
+async function resetPostgresPoolForTests() {
+    if (process.env.NODE_ENV === 'production') {
+        throw new Error('resetPostgresPoolForTests must not be called in production');
+    }
+    // Close all pools so connections are not leaked between test suites.
+    await Promise.all(Array.from(singletonPools.values(), (pool) => pool.end()));
+    singletonPools.clear();
+}
+function resolveSslEnabled(connectionString, explicitSsl) {
+    if (explicitSsl !== undefined) {
+        return explicitSsl;
+    }
+    const sslFromConnectionString = readSslFromConnectionString(connectionString);
+    if (sslFromConnectionString !== undefined) {
+        return sslFromConnectionString;
+    }
+    return isSslModeEnabled(process.env.PGSSLMODE);
+}
+function readSslFromConnectionString(connectionString) {
+    if (!connectionString) {
+        return undefined;
+    }
+    try {
+        const url = new URL(connectionString);
+        const ssl = url.searchParams.get('ssl');
+        if (ssl !== null) {
+            return isAffirmativeValue(ssl);
+        }
+        const sslMode = url.searchParams.get('sslmode');
+        if (sslMode !== null) {
+            return isSslModeEnabled(sslMode);
+        }
+    }
+    catch {
+        // Leave SSL disabled unless it was explicitly requested.
+    }
+    return undefined;
+}
+function isAffirmativeValue(value) {
+    switch (value.toLowerCase()) {
+        case '1':
+        case 'true':
+        case 'yes':
+        case 'on':
+            return true;
+        default:
+            return false;
+    }
+}
+function isSslModeEnabled(value) {
+    switch (value?.toLowerCase()) {
+        case 'require':
+        case 'verify-ca':
+        case 'verify-full':
+            return true;
+        default:
+            return false;
+    }
+}
+function getPoolKey(options) {
+    const config = resolvePoolConfig(options);
+    return JSON.stringify({
+        connectionString: config.connectionString ?? null,
+        max: config.max ?? null,
+        idleTimeoutMillis: config.idleTimeoutMillis ?? null,
+        application_name: config.application_name ?? null,
+        ssl: config.ssl === true,
+    });
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @medicine-wheel/data-store-postgres
+ *
+ * Minimal PostgreSQL/Neon provider scaffold for Medicine Wheel storage.
+ * This package only establishes pool management and a provider-ready surface.
+ */
+export { createPostgresPool, getPostgresPool, withPostgresClient, closePostgresPool, resetPostgresPoolForTests, } from './connection.js';
+export type { PostgresConnectionOptions, PostgresProviderRecord, } from './connection.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * @medicine-wheel/data-store-postgres
+ *
+ * Minimal PostgreSQL/Neon provider scaffold for Medicine Wheel storage.
+ * This package only establishes pool management and a provider-ready surface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetPostgresPoolForTests = exports.closePostgresPool = exports.withPostgresClient = exports.getPostgresPool = exports.createPostgresPool = void 0;
+var connection_js_1 = require("./connection.js");
+Object.defineProperty(exports, "createPostgresPool", { enumerable: true, get: function () { return connection_js_1.createPostgresPool; } });
+Object.defineProperty(exports, "getPostgresPool", { enumerable: true, get: function () { return connection_js_1.getPostgresPool; } });
+Object.defineProperty(exports, "withPostgresClient", { enumerable: true, get: function () { return connection_js_1.withPostgresClient; } });
+Object.defineProperty(exports, "closePostgresPool", { enumerable: true, get: function () { return connection_js_1.closePostgresPool; } });
+Object.defineProperty(exports, "resetPostgresPoolForTests", { enumerable: true, get: function () { return connection_js_1.resetPostgresPoolForTests; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iDAMyB;AALvB,mHAAA,kBAAkB,OAAA;AAClB,gHAAA,eAAe,OAAA;AACf,mHAAA,kBAAkB,OAAA;AAClB,kHAAA,iBAAiB,OAAA;AACjB,0HAAA,yBAAyB,OAAA"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@medicine-wheel/data-store-postgres",
+  "version": "0.2.2",
+  "description": "PostgreSQL/Neon provider scaffold for the Medicine Wheel Developer Suite — shared pool management and provider-ready storage entrypoints",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./connection": {
+      "import": "./dist/connection.js",
+      "types": "./dist/connection.d.ts",
+      "require": "./dist/connection.js",
+      "default": "./dist/connection.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "medicine-wheel",
+    "postgres",
+    "neon",
+    "data-store",
+    "provider",
+    "relational-memory"
+  ],
+  "author": "IAIP Collaborative - Shawinigan, QC",
+  "license": "MIT",
+  "dependencies": {
+    "@medicine-wheel/ontology-core": "^0.2.2",
+    "pg": "^8.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/pg": "^8.20.0",
+    "typescript": "^5.3.0"
+  }
+}