@axinom/mosaic-db-common 0.11.0 → 0.12.0-rc.10

package/dist/auth/index.d.ts

@@ -1,2 +1,3 @@
+export * from './authentication-subject';
 export * from './helpers';
 //# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,WAAW,CAAC"}

package/dist/auth/index.js

@@ -10,5 +10,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./authentication-subject"), exports);
 __exportStar(require("./helpers"), exports);
 //# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2DAAyC;AACzC,4CAA0B"}

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 export * from './auth';
+export * from './common';
 export * from './constants';
 export * from './messaging';
 export * from './middleware';
 export * from './migrations';
+export * from './monitoring';
 export * from './zapatos';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -11,9 +11,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./auth"), exports);
+__exportStar(require("./common"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./messaging"), exports);
 __exportStar(require("./middleware"), exports);
 __exportStar(require("./migrations"), exports);
+__exportStar(require("./monitoring"), exports);
 __exportStar(require("./zapatos"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAuB;AACvB,8CAA4B;AAC5B,8CAA4B;AAC5B,+CAA6B;AAC7B,+CAA6B;AAC7B,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAuB;AACvB,2CAAyB;AACzB,8CAA4B;AAC5B,8CAA4B;AAC5B,+CAA6B;AAC7B,+CAA6B;AAC7B,+CAA6B;AAC7B,4CAA0B"}

package/dist/middleware/pg-pool.middleware.d.ts

@@ -1,21 +1,49 @@
 import { Application, Express } from 'express';
 import { Pool } from 'pg';
 import { DbLogger, DbShutdownActions } from '../common';
+/**
+ * Creates a PostgreSQL Pool for a given connection string, and returns it.
+ *
+ * @param connectionString
+ * @param poolLabel
+ * @param logger
+ * @param shutdownActions
+ * @returns
+ */
+export declare const createPgPool: (connectionString: string, poolLabel: string, logger: DbLogger, shutdownActions: DbShutdownActions) => Pool;
 /**
  * Returns the previously set up PostgreSQL pool for the database owner. The owner pool has full access to the database.
  * @param app express app
  */
 export declare const getOwnerPgPool: (app: Express | Application) => Pool;
+/**
+ * Sets a given pool as the Owner Pool for an Express Application
+ * @param app
+ * @param ownerPool
+ */
+export declare const setOwnerPgPool: (app: Application, ownerPool: Pool) => void;
 /**
  * Returns the previously set up PostgreSQL pool for the environment owner. The environment owner cannot bypass Row Level Security and database requests will only operate on specific tenant and environment rows.
  * @param app express app
  */
 export declare const getEnvOwnerPgPool: (app: Express | Application) => Pool;
+/**
+ * Sets a given pool as the Environment Owner Pool for an Express Application
+ * @param app
+ * @param envOwnerPool
+ */
+export declare const setEnvOwnerPgPool: (app: Application, envOwnerPool: Pool) => void;
 /**
  * Returns the previously set up PostgreSQL pool for the login user. The login pool is internally used by postgraphile to access the database via GraphQL API endpoints.
  * @param app express app
  */
 export declare const getLoginPgPool: (app: Express | Application) => Pool;
+/**
+ * Sets a given pool as the Login Pool for an Express Application
+ * @param app
+ * @param loginPool
+ */
+export declare const setLoginPgPool: (app: Application, loginPool: Pool) => void;
 /**
  * Sets up a PostgreSQL pool for the owner to be reused by other app components. The owner pool has full access to the database.
  * @param app express app

package/dist/middleware/pg-pool.middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pg-pool.middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/pg-pool.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAwCxD;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAS,OAAO,GAAG,WAAW,KAAG,IAE3D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAS,OAAO,GAAG,WAAW,KAAG,IAE9D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAS,OAAO,GAAG,WAAW,KAAG,IAE3D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,QACtB,OAAO,GAAG,WAAW,oBACR,MAAM,UAChB,QAAQ,mBACC,iBAAiB,KACjC,IASF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,QACzB,OAAO,GAAG,WAAW,oBACR,MAAM,UAChB,QAAQ,mBACC,iBAAiB,KACjC,IASF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,QACtB,OAAO,GAAG,WAAW,oBACR,MAAM,UAChB,QAAQ,mBACC,iBAAiB,KACjC,IASF,CAAC"}
+{"version":3,"file":"pg-pool.middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/pg-pool.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAoBxD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,qBACL,MAAM,aACb,MAAM,UACT,QAAQ,mBACC,iBAAiB,KACjC,IAyBF,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAS,OAAO,GAAG,WAAW,KAAG,IAE3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAS,WAAW,aAAa,IAAI,KAAG,IAElE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAS,OAAO,GAAG,WAAW,KAAG,IAE9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QACvB,WAAW,gBACF,IAAI,KACjB,IAEF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAS,OAAO,GAAG,WAAW,KAAG,IAE3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAS,WAAW,aAAa,IAAI,KAAG,IAElE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,QACtB,OAAO,GAAG,WAAW,oBACR,MAAM,UAChB,QAAQ,mBACC,iBAAiB,KACjC,IASF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,QACzB,OAAO,GAAG,WAAW,oBACR,MAAM,UAChB,QAAQ,mBACC,iBAAiB,KACjC,IASF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,QACtB,OAAO,GAAG,WAAW,oBACR,MAAM,UAChB,QAAQ,mBACC,iBAAiB,KACjC,IASF,CAAC"}

package/dist/middleware/pg-pool.middleware.js

@@ -1,8 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setupLoginPgPool = exports.setupEnvOwnerPgPool = exports.setupOwnerPgPool = exports.getLoginPgPool = exports.getEnvOwnerPgPool = exports.getOwnerPgPool = void 0;
+exports.setupLoginPgPool = exports.setupEnvOwnerPgPool = exports.setupOwnerPgPool = exports.setLoginPgPool = exports.getLoginPgPool = exports.setEnvOwnerPgPool = exports.getEnvOwnerPgPool = exports.setOwnerPgPool = exports.getOwnerPgPool = exports.createPgPool = void 0;
 const pg_1 = require("pg");
 const setupPgPool = (app, connectionString, poolKey, poolLabel, logger, shutdownActions) => {
+    const pgPool = (0, exports.createPgPool)(connectionString, poolLabel, logger, shutdownActions);
+    app.set(poolKey, pgPool);
+};
+/**
+ * Creates a PostgreSQL Pool for a given connection string, and returns it.
+ *
+ * @param connectionString
+ * @param poolLabel
+ * @param logger
+ * @param shutdownActions
+ * @returns
+ */
+const createPgPool = (connectionString, poolLabel, logger, shutdownActions) => {
     const pgPool = new pg_1.Pool({ connectionString });
     // If a pg pool error happens and triggers the exit of node process (e.g postgres server stopped while postgraphile service is running) -
     // it is possible for it to not be caught using this handler, because node process will close faster.
@@ -19,8 +32,9 @@ const setupPgPool = (app, connectionString, poolKey, poolLabel, logger, shutdown
         logger.debug(`Shutting down ${poolLabel} PostgreSQL connection Pool.`);
         pgPool.end();
     });
-    app.set(poolKey, pgPool);
+    return pgPool;
 };
+exports.createPgPool = createPgPool;
 const ownerPoolKey = 'ownerPool';
 const envOwnerPoolKey = 'envOwnerPool';
 const loginPoolKey = 'loginPool';
@@ -32,6 +46,15 @@ const getOwnerPgPool = (app) => {
     return app.get(ownerPoolKey);
 };
 exports.getOwnerPgPool = getOwnerPgPool;
+/**
+ * Sets a given pool as the Owner Pool for an Express Application
+ * @param app
+ * @param ownerPool
+ */
+const setOwnerPgPool = (app, ownerPool) => {
+    app.set(ownerPoolKey, ownerPool);
+};
+exports.setOwnerPgPool = setOwnerPgPool;
 /**
  * Returns the previously set up PostgreSQL pool for the environment owner. The environment owner cannot bypass Row Level Security and database requests will only operate on specific tenant and environment rows.
  * @param app express app
@@ -40,6 +63,15 @@ const getEnvOwnerPgPool = (app) => {
     return app.get(envOwnerPoolKey);
 };
 exports.getEnvOwnerPgPool = getEnvOwnerPgPool;
+/**
+ * Sets a given pool as the Environment Owner Pool for an Express Application
+ * @param app
+ * @param envOwnerPool
+ */
+const setEnvOwnerPgPool = (app, envOwnerPool) => {
+    app.set(envOwnerPoolKey, envOwnerPool);
+};
+exports.setEnvOwnerPgPool = setEnvOwnerPgPool;
 /**
  * Returns the previously set up PostgreSQL pool for the login user. The login pool is internally used by postgraphile to access the database via GraphQL API endpoints.
  * @param app express app
@@ -48,6 +80,15 @@ const getLoginPgPool = (app) => {
     return app.get(loginPoolKey);
 };
 exports.getLoginPgPool = getLoginPgPool;
+/**
+ * Sets a given pool as the Login Pool for an Express Application
+ * @param app
+ * @param loginPool
+ */
+const setLoginPgPool = (app, loginPool) => {
+    app.set(loginPoolKey, loginPool);
+};
+exports.setLoginPgPool = setLoginPgPool;
 /**
  * Sets up a PostgreSQL pool for the owner to be reused by other app components. The owner pool has full access to the database.
  * @param app express app

package/dist/middleware/pg-pool.middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"pg-pool.middleware.js","sourceRoot":"","sources":["../../src/middleware/pg-pool.middleware.ts"],"names":[],"mappings":";;;AAEA,2BAA0B;AAG1B,MAAM,WAAW,GAAG,CAClB,GAA0B,EAC1B,gBAAwB,EACxB,OAAe,EACf,SAAiB,EACjB,MAAgB,EAChB,eAAkC,EAC5B,EAAE;IACR,MAAM,MAAM,GAAG,IAAI,SAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAE9C,yIAAyI;IACzI,qGAAqG;IACrG,gFAAgF;IAChF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACzB,uEAAuE;QACvE,MAAM,WAAW,GAAG,GAA2B,CAAC;QAChD,IAAI,WAAW,CAAC,MAAM,EAAE;YACtB,OAAO,WAAW,CAAC,MAAM,CAAC;SAC3B;QAED,MAAM,CAAC,KAAK,CACV,GAAG,EACH,8BAA8B,SAAS,8BAA8B,CACtE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE;QACxB,MAAM,CAAC,KAAK,CAAC,iBAAiB,SAAS,8BAA8B,CAAC,CAAC;QACvE,MAAM,CAAC,GAAG,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,WAAW,CAAC;AACjC,MAAM,eAAe,GAAG,cAAc,CAAC;AACvC,MAAM,YAAY,GAAG,WAAW,CAAC;AAEjC;;;GAGG;AACI,MAAM,cAAc,GAAG,CAAC,GAA0B,EAAQ,EAAE;IACjE,OAAO,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC/B,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB;AAEF;;;GAGG;AACI,MAAM,iBAAiB,GAAG,CAAC,GAA0B,EAAQ,EAAE;IACpE,OAAO,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAClC,CAAC,CAAC;AAFW,QAAA,iBAAiB,qBAE5B;AAEF;;;GAGG;AACI,MAAM,cAAc,GAAG,CAAC,GAA0B,EAAQ,EAAE;IACjE,OAAO,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC/B,CAAC,CAAC;AAFW,QAAA,cAAc,kBAEzB;AAEF;;;;;;GAMG;AACI,MAAM,gBAAgB,GAAG,CAC9B,GAA0B,EAC1B,gBAAwB,EACxB,MAAgB,EAChB,eAAkC,EAC5B,EAAE;IACR,WAAW,CACT,GAAG,EACH,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,MAAM,EACN,eAAe,CAChB,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,gBAAgB,oBAc3B;AAEF;;;;;;GAMG;AACI,MAAM,mBAAmB,GAAG,CACjC,GAA0B,EAC1B,gBAAwB,EACxB,MAAgB,EAChB,eAAkC,EAC5B,EAAE;IACR,WAAW,CACT,GAAG,EACH,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,MAAM,EACN,eAAe,CAChB,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,mBAAmB,uBAc9B;AAEF;;;;;;GAMG;AACI,MAAM,gBAAgB,GAAG,CAC9B,GAA0B,EAC1B,gBAAwB,EACxB,MAAgB,EAChB,eAAkC,EAC5B,EAAE;IACR,WAAW,CACT,GAAG,EACH,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,MAAM,EACN,eAAe,CAChB,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,gBAAgB,oBAc3B"}
+{"version":3,"file":"pg-pool.middleware.js","sourceRoot":"","sources":["../../src/middleware/pg-pool.middleware.ts"],"names":[],"mappings":"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"}

package/dist/monitoring/index.d.ts

@@ -0,0 +1,2 @@
+export * from './postgres-metrics';
+//# sourceMappingURL=index.d.ts.map

package/dist/monitoring/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/monitoring/index.js

@@ -0,0 +1,14 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./postgres-metrics"), exports);
+//# sourceMappingURL=index.js.map

package/dist/monitoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAmC"}

package/dist/monitoring/postgres-metrics.d.ts

@@ -0,0 +1,14 @@
+import { Pool } from 'pg';
+import { Metric } from 'prom-client';
+/**
+ * Creates a `Gauge` metric with the name `ax_postgres_<pgPoolType>_connectivity` which can be added to a metric Registry.
+ * This metric will have a value of `1` if the Database can be reached via the corresponding Pool (within the given timeout),
+ * or a value of `0` otherwise.
+ *
+ * @param pgPool The Postgres Pool to use for checking the connectivity. The connectivity test will be done at the point of metric collection.
+ * @param pgPoolType The Postgres Pool to check connectivity for. The connectivity test will be done at the point of metric collection.
+ * @param timeoutInMilliSeconds The maximum time the connectivity check will run during metric collection. Defaults to `1000ms`.
+ * @returns A `Gauge` metric with a name `ax_postgres_<pgPoolType>_connectivity`.
+ */
+export declare const CreatePostgresPoolConnectivityMetric: (pgPool: Pool, pgPoolType: 'dbOwnerPool' | 'envOwnerPool' | 'loginPool', timeoutInMilliSeconds?: number) => Metric<string>;
+//# sourceMappingURL=postgres-metrics.d.ts.map

package/dist/monitoring/postgres-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-metrics.d.ts","sourceRoot":"","sources":["../../src/monitoring/postgres-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAS,MAAM,EAAE,MAAM,aAAa,CAAC;AAO5C;;;;;;;;;GASG;AACH,eAAO,MAAM,oCAAoC,WACvC,IAAI,cACA,aAAa,GAAG,cAAc,GAAG,WAAW,qCAEvD,OAAO,MAAM,CAiBf,CAAC"}

package/dist/monitoring/postgres-metrics.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreatePostgresPoolConnectivityMetric = void 0;
+const prom_client_1 = require("prom-client");
+const createTimeout = (timeoutInMilliSeconds) => new Promise((_, reject) => setTimeout(() => reject(), timeoutInMilliSeconds));
+/**
+ * Creates a `Gauge` metric with the name `ax_postgres_<pgPoolType>_connectivity` which can be added to a metric Registry.
+ * This metric will have a value of `1` if the Database can be reached via the corresponding Pool (within the given timeout),
+ * or a value of `0` otherwise.
+ *
+ * @param pgPool The Postgres Pool to use for checking the connectivity. The connectivity test will be done at the point of metric collection.
+ * @param pgPoolType The Postgres Pool to check connectivity for. The connectivity test will be done at the point of metric collection.
+ * @param timeoutInMilliSeconds The maximum time the connectivity check will run during metric collection. Defaults to `1000ms`.
+ * @returns A `Gauge` metric with a name `ax_postgres_<pgPoolType>_connectivity`.
+ */
+const CreatePostgresPoolConnectivityMetric = (pgPool, pgPoolType, timeoutInMilliSeconds = 1000) => {
+    return new prom_client_1.Gauge({
+        name: `ax_postgres_${pgPoolType}_connectivity`,
+        help: `Connection status from the service to the database via the ${pgPoolType}`,
+        async collect() {
+            try {
+                await Promise.race([
+                    pgPool.query(`SELECT NOW() AS PostgresPoolConnectivityMetric`),
+                    createTimeout(timeoutInMilliSeconds),
+                ]);
+                this.set(1);
+            }
+            catch (_a) {
+                this.set(0);
+            }
+        },
+    });
+};
+exports.CreatePostgresPoolConnectivityMetric = CreatePostgresPoolConnectivityMetric;
+//# sourceMappingURL=postgres-metrics.js.map

package/dist/monitoring/postgres-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-metrics.js","sourceRoot":"","sources":["../../src/monitoring/postgres-metrics.ts"],"names":[],"mappings":";;;AACA,6CAA4C;AAE5C,MAAM,aAAa,GAAG,CAAC,qBAA6B,EAAiB,EAAE,CACrE,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC9B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAClD,CAAC;AAEJ;;;;;;;;;GASG;AACI,MAAM,oCAAoC,GAAG,CAClD,MAAY,EACZ,UAAwD,EACxD,qBAAqB,GAAG,IAAI,EACZ,EAAE;IAClB,OAAO,IAAI,mBAAK,CAAC;QACf,IAAI,EAAE,eAAe,UAAU,eAAe;QAC9C,IAAI,EAAE,8DAA8D,UAAU,EAAE;QAEhF,KAAK,CAAC,OAAO;YACX,IAAI;gBACF,MAAM,OAAO,CAAC,IAAI,CAAC;oBACjB,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC;oBAC9D,aAAa,CAAC,qBAAqB,CAAC;iBACrC,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aACb;YAAC,WAAM;gBACN,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aACb;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC;AArBW,QAAA,oCAAoC,wCAqB/C"}

package/migrations/before-migration/005-created-updated-triggers.sql

@@ -44,11 +44,17 @@ DECLARE
   ignore_multitenancy text = current_setting('mosaic.ignore_multitenancy', TRUE);
 BEGIN
   IF tenant_id <> '' THEN   -- Not null and not empty
+    IF NEW.tenant_id::TEXT <> 'ffffffff-ffff-ffff-ffff-ffffffffffff' AND NEW.tenant_id::TEXT <> tenant_id THEN
+      perform ax_utils.raise_error('The "mosaic.tenant_id" set via set_config must match the updated/inserted row.', 'TENAN');
+    END IF;
     NEW.tenant_id = tenant_id;
   ELSIF is_superuser <> 'on' AND ignore_multitenancy <> 'on' THEN
     perform ax_utils.raise_error('The "mosaic.tenant_id" must be set via set_config value.', 'TENAN');
   END IF;
   IF environment_id <> '' THEN   -- Not null and not empty
+    IF NEW.environment_id::TEXT <> 'ffffffff-ffff-ffff-ffff-ffffffffffff' AND NEW.environment_id::TEXT <> environment_id THEN
+      perform ax_utils.raise_error('The "mosaic.environment_id" set via set_config must match the updated/inserted row.', 'ENVVV');
+    END IF;
     NEW.environment_id = environment_id;
   ELSIF is_superuser <> 'on' AND ignore_multitenancy <> 'on' THEN
     perform ax_utils.raise_error('The "mosaic.environment_id" must be set via set_config value.', 'ENVVV');

package/migrations/define/define-functions.sql

@@ -83,7 +83,7 @@ CREATE OR REPLACE FUNCTION ax_define.define_timestamps_trigger(tableName text, s
 BEGIN
   PERFORM ax_define.drop_timestamps_trigger(tableName, schemaName);
   EXECUTE 'CREATE trigger _100_timestamps BEFORE UPDATE ON ' || schemaName || '.' || tableName ||
-          ' for each ROW EXECUTE PROCEDURE ax_utils.tg__timestamps();';
+          ' for each ROW when (old.* is distinct from new.*) EXECUTE PROCEDURE ax_utils.tg__timestamps();';
 END;
 $$;
 
@@ -123,7 +123,7 @@ CREATE OR REPLACE FUNCTION ax_define.define_users_trigger(tableName text, schema
 BEGIN
   PERFORM ax_define.drop_users_trigger(tableName, schemaName);
   EXECUTE 'CREATE trigger _200_username BEFORE INSERT OR UPDATE ON ' || schemaName || '.' || tableName ||
-          ' for each ROW EXECUTE PROCEDURE ax_utils.tg__username();';
+          ' for each ROW when (old.* is distinct from new.*) EXECUTE PROCEDURE ax_utils.tg__username();';
 END;
 $$;
 

package/migrations/define/define-multitenancy-functions.sql

@@ -260,3 +260,114 @@ BEGIN
   perform ax_define.define_multitenant_authentication(readPermissions, '', tableName, schemaName);
 END;
 $$;
+
+/*-snippet
+{
+  "body": [
+    "SELECT ax_define.drop_multitenancy_timestamp_propagation('${1:fk_column}', '${2:table_name}', '${3:app_public}', '${4:id}', '${5:parent_table}', '${6:app_public}');"
+  ],
+  "description": [
+    "Removes a function and trigger created by 'ax_define.define_multitenancy_timestamp_propagation' in an idempotent way.\n",
+    "The call signature mirrors 'ax_define.define_multitenancy_timestamp_propagation' and should be applied with the same arguments.\n",
+  ]
+}
+snippet-*/
+CREATE OR REPLACE FUNCTION ax_define.drop_multitenancy_timestamp_propagation(
+  idColumnName text,
+  tableName text,
+  schemaName text,
+  foreignIdColumnName text,
+  foreignTableName text,
+  foreignSchemaName text,
+  functionName text default NULL
+  ) RETURNS void
+    LANGUAGE plpgsql
+    AS $$
+BEGIN
+  SELECT COALESCE(functionName, 'tg_' || tableName || '__' || foreignTableName || '_mt_ts_propagation') INTO functionName;
+  IF LENGTH(functionName) > 63 THEN
+    perform ax_utils.raise_error('Invalid parameters provided to "ax_define.drop_multitenancy_timestamp_propagation". Function name "%s" exceeds 63 bytes. If the auto-generated name exceeds 63 bytes then a "functionName" argument must be provided.', 'SETUP', functionName);
+  END IF;
+  EXECUTE  'DROP TRIGGER IF EXISTS _200_propogate_timestamps on ' || schemaName || '.' || tableName;
+  EXECUTE  'DROP FUNCTION IF EXISTS ' || schemaName || '.' || functionName || '()';
+END;
+$$;
+
+/*-snippet
+{
+  "body": [
+    "SELECT ax_define.define_multitenancy_timestamp_propagation('${1:fk_column}', '${2:table_name}', '${3:app_public}', '${4:id}', '${5:parent_table}', '${6:app_public}');"
+  ],
+  "description": [
+    "Defines a function and trigger to propagate 'updated_date' changes to related entities.\n",
+    "Propagation can trigger 'UPDATED' triggers on the target entity including chained timestamp propagation.\n",
+    "The call signature mirrors ax_define.define_multitenancy_relation and can generally be applied with the same arguments.\n",
+    "First parameter: a column name from the \"table_name\" table that the trigger should be associated with.",
+    "Fourth parameter: a column name from the \"parent_table\" that 'updated_date' should be propagated to.",
+    "Seventh (optional) parameter: a unique name for the generated function. If the value is NULL then a name will be generated from the table names."
+  ]
+}
+snippet-*/
+CREATE OR REPLACE FUNCTION ax_define.define_multitenancy_timestamp_propagation(
+  idColumnName text,
+  tableName text,
+  schemaName text,
+  foreignIdColumnName text,
+  foreignTableName text,
+  foreignSchemaName text,
+  functionName text default NULL
+  ) RETURNS void
+    LANGUAGE plpgsql
+    AS $a$
+BEGIN
+  SELECT COALESCE(functionName, 'tg_' || tableName || '__' || foreignTableName || '_mt_ts_propagation') INTO functionName;
+  IF LENGTH(functionName) > 63 THEN
+    perform ax_utils.raise_error('Invalid parameters provided to "ax_define.define_multitenancy_timestamp_propagation". Function name "%s" exceeds 63 bytes. If the auto-generated name exceeds 63 bytes then a "functionName" argument must be provided.', 'SETUP', functionName);
+  END IF;
+  -- Set updated_date=now() on the foreign table. This will propogate UPDATE triggers.
+  --
+  -- A new function is created for each table to do this.
+  --     It *may* be possible to use a stock function with trigger arguments but its not easy as NEW and OLD cannot be accessed with dynamic column names. A possible 
+  --     solution to that is described here: https://itectec.com/database/postgresql-assignment-of-a-column-with-dynamic-column-name/. But even there the advise is 
+  --     to: "Just write a new trigger function for each table. Less hassle, better performance. Byte the bullet on code duplication:"
+  --
+  -- !! WARNING !!: This function uses "SECURITY DEFINER". This is required to ensure that update to the target table is allowed. This means that the function is 
+  --                executed with role "DB_OWNER". Extra care must be taken to ensure multitenancy integrity is preserved. Any propogated trigger functions will also 
+  --                execute with role "DB_OWNER".
+  EXECUTE  '
+            CREATE OR REPLACE FUNCTION ' || schemaName || '.' || functionName || '() RETURNS TRIGGER
+            LANGUAGE plpgsql 
+            SECURITY DEFINER
+            SET search_path = pg_temp
+            AS $b$
+            BEGIN
+                if (OLD.updated_date = NEW.updated_date) THEN
+                   RETURN NULL;
+                END IF;
+                -- UPDATE (where relationship is unchanged, or changed to another entity in which case a change is triggered on both the old and new relation)
+                IF (OLD.' || idColumnName || ' IS NOT NULL AND NEW.' || idColumnName || ' IS NOT NULL) THEN
+                    UPDATE ' || foreignSchemaName || '.' || foreignTableName || ' SET updated_date=now()
+                        WHERE (' || foreignIdColumnName || ' = OLD.' || idColumnName || ' AND tenant_id = OLD.tenant_id AND environment_id = OLD.environment_id)
+                        OR (' || foreignIdColumnName || ' = NEW.' || idColumnName || ' AND tenant_id = NEW.tenant_id AND environment_id = NEW.environment_id);
+                -- INSERT (or UPDATE which sets nullable relationship)
+                ELSIF (NEW.' || idColumnName || ' IS NOT NULL) THEN
+                    UPDATE ' || foreignSchemaName || '.' || foreignTableName || ' SET updated_date=now()
+                        WHERE ' || foreignIdColumnName || ' = NEW.' || idColumnName || ' AND tenant_id = NEW.tenant_id AND environment_id = NEW.environment_id;
+                -- DELETE (or UPDATE which removes nullable relationship)
+                ELSIF (OLD.' || idColumnName || ' IS NOT NULL) THEN
+                    UPDATE ' || foreignSchemaName || '.' || foreignTableName || ' SET updated_date=now()
+                        WHERE ' || foreignIdColumnName || ' = OLD.' || idColumnName || ' AND tenant_id = OLD.tenant_id AND environment_id = OLD.environment_id;
+                    
+                END IF;
+                RETURN NULL;
+            END $b$;
+            REVOKE EXECUTE ON FUNCTION ' || schemaName || '.' || functionName || '() FROM public;
+            ';
+  
+  -- Function runs *AFTER* INSERT, UPDATE, DELETE. Propogated queries can still raise error and rollback the transaction
+  EXECUTE  'DROP TRIGGER IF EXISTS _200_propogate_timestamps on ' || schemaName || '.' || tableName;
+  EXECUTE  'CREATE trigger _200_propogate_timestamps 
+            AFTER INSERT OR UPDATE OR DELETE ON ' || schemaName || '.' || tableName || '
+            FOR EACH ROW EXECUTE PROCEDURE ' || schemaName || '.' || functionName || '();';
+END;
+$a$;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axinom/mosaic-db-common",
-  "version": "0.11.0",
+  "version": "0.12.0-rc.10",
   "description": "This library encapsulates database-related functionality to develop Mosaic based services.",
   "author": "Axinom",
   "license": "PROPRIETARY",
@@ -34,6 +34,7 @@
     "express": "^4.17.1",
     "graphile-migrate": "^1.2.0-0",
     "pg": "^8.5.1",
+    "prom-client": "^13.0.0",
     "readdirp": "^3.4.0",
     "yargs": "^16.2.0",
     "zapatos": "3.6.0"
@@ -50,5 +51,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "f80cb6c17c7fe9993994473b513b568c7ae718d8"
+  "gitHead": "7edd5ca677e58aa6d26c2ca5d2fb62c4e441756c"
 }