@constructive-io/job-pg 0.3.5

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## 0.3.5 (2025-12-18)
+
+**Note:** Version bump only for package @constructive-io/job-pg
+
+## [0.3.4](https://github.com/constructive-io/jobs/compare/@launchql/job-pg@0.3.3...@launchql/job-pg@0.3.4) (2025-12-17)
+
+**Note:** Version bump only for package @launchql/job-pg

package/LICENSE

@@ -0,0 +1,23 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Dan Lynch <pyramation@gmail.com>
+Copyright (c) 2025 Constructive <developers@constructive.io>
+Copyright (c) 2020-present, Interweb, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# job-pg

package/dist/env.d.ts

@@ -0,0 +1,10 @@
+declare const _default: Readonly<{
+    PGUSER: string;
+    PGHOST: string;
+    PGPASSWORD: string;
+    PGPORT: number;
+    PGDATABASE: string;
+}> & import("envalid").CleanEnv & {
+    readonly [varName: string]: string;
+};
+export default _default;

package/dist/env.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const envalid_1 = require("envalid");
+exports.default = (0, envalid_1.cleanEnv)(process.env, {
+    PGUSER: (0, envalid_1.str)({ default: 'postgres' }),
+    PGHOST: (0, envalid_1.str)({ default: 'localhost' }),
+    PGPASSWORD: (0, envalid_1.str)({ default: 'password' }),
+    PGPORT: (0, envalid_1.port)({ default: 5432 }),
+    PGDATABASE: (0, envalid_1.str)({ default: 'jobs' })
+}, { dotEnvPath: null });

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { Pool } from 'pg';
+type PoolCloseCallback = (...args: any[]) => Promise<void> | void;
+declare class PoolManager {
+    private pgPool;
+    private callbacks;
+    private _closed;
+    constructor({ pgPool }?: {
+        pgPool?: Pool;
+    });
+    onClose(fn: PoolCloseCallback, context?: any, args?: any[]): void;
+    getPool(): Pool;
+    close(): Promise<void>;
+}
+declare const mngr: PoolManager;
+export default mngr;

package/dist/index.js

@@ -0,0 +1,78 @@
+"use strict";
+/* eslint-disable no-console */
+Object.defineProperty(exports, "__esModule", { value: true });
+const pg_1 = require("pg");
+const job_utils_1 = require("@constructive-io/job-utils");
+// k8s only does SIGINT
+// other events are bad for babel-watch
+const SYS_EVENTS = [
+    // 'SIGUSR2',
+    'SIGINT'
+    // 'SIGTERM',
+    // 'SIGPIPE',
+    // 'SIGHUP',
+    // 'SIGABRT'
+];
+function once(fn, context) {
+    let called = false;
+    let result;
+    return function (...args) {
+        if (!called && fn) {
+            // context is just forwarded through, it is not inspected
+            result = fn.apply((context ?? this), args);
+            called = true;
+        }
+        return result;
+    };
+}
+const pgPoolConfig = (0, job_utils_1.getJobPgConfig)();
+const end = (pool) => {
+    try {
+        // Pool has internal state flags, but they are not part of the public type
+        const state = pool;
+        if (state.ended || state.ending) {
+            console.error('DO NOT CLOSE pool, why are you trying to call end() when already ended?');
+            return;
+        }
+        void pool.end();
+        console.log('successfully closed pool.');
+    }
+    catch (e) {
+        process.stderr.write(String(e));
+    }
+};
+class PoolManager {
+    pgPool;
+    callbacks;
+    _closed;
+    constructor({ pgPool = new pg_1.Pool(pgPoolConfig) } = {}) {
+        this.pgPool = pgPool;
+        this.callbacks = [];
+        this._closed = false;
+        const closeOnce = once(async () => {
+            console.log('closing pg pool manager...');
+            await this.close();
+        }, this);
+        SYS_EVENTS.forEach((event) => {
+            process.on(event, closeOnce);
+        });
+    }
+    onClose(fn, context, args = []) {
+        this.callbacks.push([fn, context, args]);
+    }
+    getPool() {
+        return this.pgPool;
+    }
+    async close() {
+        if (this._closed)
+            return;
+        for (const [fn, context, args] of this.callbacks) {
+            console.log('closing fn', fn.name);
+            await fn.apply(context, args);
+        }
+        end(this.pgPool);
+        this._closed = true;
+    }
+}
+const mngr = new PoolManager();
+exports.default = mngr;

package/jest.config.js

@@ -0,0 +1,18 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  transform: {
+    '^.+\\.tsx?$': [
+      'ts-jest',
+      {
+        babelConfig: false,
+        tsconfig: 'tsconfig.json',
+      },
+    ],
+  },
+  transformIgnorePatterns: [`/node_modules/*`],
+  testRegex: '(/__tests__/.*|(\\.|/)(test|spec))\\.(jsx?|tsx?)$',
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+  modulePathIgnorePatterns: ['dist/*'],
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@constructive-io/job-pg",
+  "version": "0.3.5",
+  "description": "job pg",
+  "author": "Constructive <developers@constructive.io>",
+  "homepage": "https://github.com/constructive-io/jobs/tree/master/packages/job-pg#readme",
+  "license": "SEE LICENSE IN LICENSE",
+  "main": "dist/index.js",
+  "directories": {
+    "lib": "src",
+    "test": "__tests__"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/constructive-io/jobs"
+  },
+  "scripts": {
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:debug": "node --inspect node_modules/.bin/jest --runInBand",
+    "build": "tsc -p tsconfig.json",
+    "build:watch": "tsc -p tsconfig.json -w"
+  },
+  "bugs": {
+    "url": "https://github.com/constructive-io/jobs/issues"
+  },
+  "dependencies": {
+    "@constructive-io/job-utils": "^0.5.0",
+    "pg": "8.16.3"
+  },
+  "gitHead": "86d74dc4fce9051df0d2b5bcc163607aba42f009"
+}

package/src/index.ts

@@ -0,0 +1,103 @@
+/* eslint-disable no-console */
+
+import { Pool, PoolConfig } from 'pg';
+import { getJobPgConfig } from '@constructive-io/job-utils';
+
+// k8s only does SIGINT
+// other events are bad for babel-watch
+const SYS_EVENTS = [
+  // 'SIGUSR2',
+  'SIGINT'
+  // 'SIGTERM',
+  // 'SIGPIPE',
+  // 'SIGHUP',
+  // 'SIGABRT'
+];
+
+function once<T extends (...args: unknown[]) => unknown>(
+  fn: T,
+  context?: unknown
+): (...args: Parameters<T>) => ReturnType<T> | undefined {
+  let called = false;
+  let result: ReturnType<T> | undefined;
+
+  return function (this: unknown, ...args: Parameters<T>) {
+    if (!called && fn) {
+      // context is just forwarded through, it is not inspected
+      result = fn.apply((context ?? this) as never, args) as ReturnType<T>;
+      called = true;
+    }
+    return result;
+  };
+}
+
+const pgPoolConfig: PoolConfig = getJobPgConfig() as PoolConfig;
+
+const end = (pool: Pool): void => {
+  try {
+    // Pool has internal state flags, but they are not part of the public type
+    const state = pool as unknown as {
+      ended?: boolean;
+      ending?: boolean;
+    };
+    if (state.ended || state.ending) {
+      console.error(
+        'DO NOT CLOSE pool, why are you trying to call end() when already ended?'
+      );
+      return;
+    }
+    void pool.end();
+    console.log('successfully closed pool.');
+  } catch (e) {
+    process.stderr.write(String(e));
+  }
+};
+
+// Callbacks registered for pool close events can accept arbitrary arguments
+// (we forward whatever was passed to `onClose`).
+type PoolCloseCallback = (...args: any[]) => Promise<void> | void;
+
+class PoolManager {
+  private pgPool: Pool;
+  private callbacks: Array<[PoolCloseCallback, any, any[]]>;
+  private _closed: boolean;
+
+  constructor({ pgPool = new Pool(pgPoolConfig) }: { pgPool?: Pool } = {}) {
+    this.pgPool = pgPool;
+    this.callbacks = [];
+    this._closed = false;
+
+    const closeOnce = once(async () => {
+      console.log('closing pg pool manager...');
+      await this.close();
+    }, this);
+
+    SYS_EVENTS.forEach((event) => {
+      process.on(event, closeOnce);
+    });
+  }
+
+  onClose(fn: PoolCloseCallback, context?: any, args: any[] = []): void {
+    this.callbacks.push([fn, context, args]);
+  }
+
+  getPool(): Pool {
+    return this.pgPool;
+  }
+
+  async close(): Promise<void> {
+    if (this._closed) return;
+
+    for (const [fn, context, args] of this.callbacks) {
+      console.log('closing fn', fn.name);
+      await fn.apply(context, args);
+    }
+
+    end(this.pgPool);
+    this._closed = true;
+  }
+}
+
+const mngr = new PoolManager();
+
+export default mngr;

package/tsconfig.esm.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist/esm",
+    "module": "es2022",
+    "rootDir": "src/",
+    "declaration": false
+  }
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src/"
+  },
+  "include": ["src/**/*.ts", "../../types/**/*.d.ts"],
+  "exclude": ["dist", "node_modules", "**/*.spec.*", "**/*.test.*"]
+}