@axinom/mosaic-graphql-common 0.22.0-rc.6 → 0.22.0

package/dist/plugins/bulk-edit/bulk-edit-async-plugin-factory.d.ts

@@ -0,0 +1,13 @@
+import { MultiTenantMessagingSettings } from '@axinom/mosaic-message-bus-abstractions';
+import { BasicDBConfig } from '@axinom/mosaic-service-common';
+import { Plugin } from 'postgraphile';
+/**
+ * This factory will generate a Postgraphile plugin that adds a mutation to the selected entities allowing the user to perform a bulk edit operation on the specified entity and its relations.
+ *
+ * @param tableName Name of the table to enable the BulkEdit mutation
+ * @param bulkEditMutationName Name of the BulkEdit mutation to be generated
+ * @param messageSettings The settings for the MultiTenantMessaging for the service that implements the ItemChangeCommand (e.g. ImageServiceMultiTenantMessagingSettings.ImageServicePerformItemChange)
+ * @returns The Postgraphile plugin that enables the BulkEdit mutation.
+ */
+export declare const BulkEditAsyncPluginFactory: (tableName: string, bulkEditMutationName: string, messageSettings: MultiTenantMessagingSettings, getLongLivedToken: (originalToken: string, config: BasicDBConfig) => Promise<string>) => Plugin;
+//# sourceMappingURL=bulk-edit-async-plugin-factory.d.ts.map

package/dist/plugins/bulk-edit/bulk-edit-async-plugin-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-edit-async-plugin-factory.d.ts","sourceRoot":"","sources":["../../../src/plugins/bulk-edit/bulk-edit-async-plugin-factory.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,EAEL,aAAa,EAEd,MAAM,+BAA+B,CAAC;AAgBvC,OAAO,EAAqB,MAAM,EAAiB,MAAM,cAAc,CAAC;AA4BxE;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,cAC1B,MAAM,wBACK,MAAM,mBACX,4BAA4B,qCAE5B,MAAM,UACb,aAAa,KAClB,QAAQ,MAAM,CAAC,KACnB,MA0JF,CAAC"}

package/dist/plugins/bulk-edit/bulk-edit-async-plugin-factory.js

@@ -0,0 +1,278 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkEditAsyncPluginFactory = void 0;
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable @typescript-eslint/explicit-function-return-type */
+const mosaic_db_common_1 = require("@axinom/mosaic-db-common");
+const mosaic_message_bus_1 = require("@axinom/mosaic-message-bus");
+const graphile_utils_1 = require("graphile-utils");
+const graphql_1 = require("graphql");
+const pg_transactional_outbox_1 = require("pg-transactional-outbox");
+/**
+ * This factory will generate a Postgraphile plugin that adds a mutation to the selected entities allowing the user to perform a bulk edit operation on the specified entity and its relations.
+ *
+ * @param tableName Name of the table to enable the BulkEdit mutation
+ * @param bulkEditMutationName Name of the BulkEdit mutation to be generated
+ * @param messageSettings The settings for the MultiTenantMessaging for the service that implements the ItemChangeCommand (e.g. ImageServiceMultiTenantMessagingSettings.ImageServicePerformItemChange)
+ * @returns The Postgraphile plugin that enables the BulkEdit mutation.
+ */
+const BulkEditAsyncPluginFactory = (tableName, bulkEditMutationName, messageSettings, getLongLivedToken) => {
+    return (builder) => {
+        builder.hook('GraphQLObjectType:fields', (fields, build, ctx) => {
+            var _a;
+            const inflection = build.inflection;
+            if (ctx.scope.isRootMutation && fields !== undefined) {
+                const pgIntrospectionResultsByKind = build.pgIntrospectionResultsByKind;
+                const pgTable = pgIntrospectionResultsByKind.class.find((cls) => cls.name === tableName);
+                if (!pgTable) {
+                    // TODO: Log a warning for `Table "${tableName}" not found.`
+                    return fields;
+                }
+                if (((_a = pgTable.primaryKeyConstraint) === null || _a === void 0 ? void 0 : _a.keyAttributes.length) !== 1) {
+                    // TODO: Log a warning for `Table "${tableName}" skipped since the PK attribute count is not exactly 1.`
+                    return fields;
+                }
+                const graphQLObjectTypeName = inflection.tableType(pgTable);
+                const graphQLObjectType = build.getTypeByName(graphQLObjectTypeName);
+                const connectionFilterType = build.connectionFilterTypesByTypeName[`${graphQLObjectTypeName}Filter`];
+                const patchType = build.getTypeByName(inflection.patchType(graphQLObjectType.name));
+                const addInputTypeForFKs = generateInputTypeForFKs(build, pgTable, 'Add');
+                const removeInputTypeForFKs = generateInputTypeForFKs(build, pgTable, 'Remove');
+                // TODO: Handle this to work even when the same Payload type is used multiple times (i.e. per each table with BulkEdit feature)
+                const BulkEditPayloadType = new graphql_1.GraphQLObjectType({
+                    name: 'BulkEditAsyncPayloadType',
+                    fields: () => ({
+                        filterMatchedIds: {
+                            type: new graphql_1.GraphQLList(graphql_1.GraphQLString),
+                        },
+                    }),
+                });
+                const args = {
+                    filter: {
+                        type: connectionFilterType,
+                    },
+                    set: {
+                        type: patchType,
+                    },
+                    relatedEntitiesToRemove: {
+                        type: removeInputTypeForFKs,
+                    },
+                    relatedEntitiesToAdd: {
+                        type: addInputTypeForFKs,
+                    },
+                };
+                const operation = {
+                    type: BulkEditPayloadType,
+                    args,
+                    async resolve(parent, input, context, resolveInfo) {
+                        var _a;
+                        const { config, jwtToken, subject, ownerPool, envOwnerPool, storeInboxMessage, } = context;
+                        const longLivedToken = await getLongLivedToken(jwtToken, config);
+                        const entityIds = await getEntityIds({
+                            filterName: connectionFilterType.name,
+                            queryName: inflection.allRows(pgTable),
+                            primaryKeyFieldName: inflection.column((_a = pgTable.primaryKeyConstraint) === null || _a === void 0 ? void 0 : _a.keyAttributes[0]),
+                        }, build.graphql, input, context, resolveInfo.schema);
+                        const { set, relatedEntitiesToRemove, relatedEntitiesToAdd } = input;
+                        const { removals, additions } = getFkResolverPayload(build, pgTable, relatedEntitiesToRemove, relatedEntitiesToAdd);
+                        await asyncResolverImplementation(messageSettings, {
+                            set: getMainResolverPayload(build, pgTable, set),
+                            removals,
+                            additions,
+                        }, entityIds, config, ownerPool, envOwnerPool, longLivedToken, subject, storeInboxMessage);
+                        return {
+                            filterMatchedIds: entityIds,
+                        };
+                    },
+                };
+                build.extend(fields, {
+                    [bulkEditMutationName]: operation,
+                });
+            }
+            return fields;
+        });
+    };
+};
+exports.BulkEditAsyncPluginFactory = BulkEditAsyncPluginFactory;
+/**
+ * Get all the database IDs from the entities that were selected via the GraphQL filter
+ */
+const getEntityIds = async (metadata, graphql, args, context, schema) => {
+    var _a, _b;
+    const queryResult = await graphql.execute(schema, (0, graphile_utils_1.gql) `
+      query getEntityIds($filter: ${metadata.filterName}) {
+        entities: ${metadata.queryName}(filter: $filter) {
+          nodes {
+            ${metadata.primaryKeyFieldName}
+          }
+        }
+      }
+    `, undefined, context, args);
+    return (_b = (_a = queryResult === null || queryResult === void 0 ? void 0 : queryResult.data) === null || _a === void 0 ? void 0 : _a.entities) === null || _b === void 0 ? void 0 : _b.nodes.map((entity) => {
+        return entity[metadata.primaryKeyFieldName];
+    });
+};
+function getMainResolverPayload(build, pgTable, set) {
+    const inflection = build.inflection;
+    return {
+        mainTableName: pgTable.name,
+        gqlFieldNameToColumnNameMap: pgTable.attributes.reduce((map, curr) => {
+            map[inflection.column(curr)] = curr.name;
+            return map;
+        }, {}),
+        inputData: set,
+    };
+}
+// TODO: Can be potentially optimized (i.e. with getAffectedForeignKeyRelations or with asyncResolverImplementation)
+function getFkResolverPayload(build, pgTable, relatedEntitiesToRemove, relatedEntitiesToAdd) {
+    var _a, _b;
+    const inflection = build.inflection;
+    const foreignKeyRelations = getAffectedForeignKeyRelations(pgTable);
+    const fkProcessingMetadata = {};
+    for (const fkConstraint of foreignKeyRelations) {
+        const parentKey = fkConstraint.keyAttributes[fkConstraint.foreignKeyAttributeNums.indexOf((_b = (_a = pgTable.primaryKeyConstraint) === null || _a === void 0 ? void 0 : _a.keyAttributes[0].num) !== null && _b !== void 0 ? _b : -1)];
+        fkProcessingMetadata[fkConstraint.class.name] = {
+            fkGqlFieldNameToColumnNameMap: fkConstraint.class.attributes.reduce((map, curr) => {
+                map[inflection.column(curr)] = curr.name;
+                return map;
+            }, {}),
+            fkGqlFieldName: inflection.allRows(fkConstraint.class),
+            parentKeyFieldName: inflection.column(parentKey),
+            parentKeyColumnName: parentKey.name,
+        };
+    }
+    const additions = {};
+    const removals = {};
+    for (const fkProps of Object.keys(fkProcessingMetadata)) {
+        if (relatedEntitiesToAdd) {
+            additions[fkProps] = {
+                parentKeyColumnName: fkProcessingMetadata[fkProps].parentKeyColumnName,
+                inputData: relatedEntitiesToAdd[fkProcessingMetadata[fkProps].fkGqlFieldName],
+                fkGqlFieldNameToColumnNameMap: fkProcessingMetadata[fkProps].fkGqlFieldNameToColumnNameMap,
+            };
+        }
+        if (relatedEntitiesToRemove) {
+            removals[fkProps] = {
+                parentKeyColumnName: fkProcessingMetadata[fkProps].parentKeyColumnName,
+                inputData: relatedEntitiesToRemove[fkProcessingMetadata[fkProps].fkGqlFieldName],
+                fkGqlFieldNameToColumnNameMap: fkProcessingMetadata[fkProps].fkGqlFieldNameToColumnNameMap,
+            };
+        }
+    }
+    return { additions, removals };
+}
+async function asyncResolverImplementation(messageSettings, bulkItemChangePayload, entityIds, config, ownerPool, envOwnerPool, longLivedToken, subject, storeInboxMessage) {
+    const pool = envOwnerPool ? envOwnerPool : ownerPool;
+    const dbRole = envOwnerPool ? config.dbEnvOwner : config.dbOwner;
+    const pgSettings = (0, mosaic_db_common_1.buildPgSettings)(subject, dbRole, config.serviceId);
+    await (0, mosaic_db_common_1.transactionWithContext)(pool, pg_transactional_outbox_1.IsolationLevel.ReadCommitted, pgSettings, async (txn) => {
+        // Iterate all the entity IDs
+        for (const entity_id of entityIds) {
+            if (bulkItemChangePayload.set.inputData) {
+                // Generate the SET payload
+                const actionSetPayload = {
+                    table_name: bulkItemChangePayload.set.mainTableName,
+                    action: 'SET',
+                    stringified_condition: JSON.stringify({ id: entity_id }),
+                    stringified_payload: JSON.stringify(mapGqlInputObjectToSqlColumnNames(bulkItemChangePayload.set.inputData, bulkItemChangePayload.set.gqlFieldNameToColumnNameMap)),
+                };
+                // TODO: Add a DEBUG log for `actionSetPayload`
+                await sendMessage(storeInboxMessage, messageSettings, actionSetPayload, txn, longLivedToken);
+            }
+            if (bulkItemChangePayload.removals) {
+                const fkTableNames = Object.keys(bulkItemChangePayload.removals);
+                // Iterate each related FK table where entities will be removed
+                for (const fkTableName of fkTableNames) {
+                    const fkRemovalMetadata = bulkItemChangePayload.removals[fkTableName];
+                    if (fkRemovalMetadata.inputData) {
+                        // Generate the REMOVE payload per entity of the FK table
+                        for (const itemToRemove of fkRemovalMetadata.inputData) {
+                            const removePayload = {
+                                table_name: fkTableName,
+                                action: 'REMOVE',
+                                stringified_condition: '',
+                                stringified_payload: JSON.stringify(Object.assign({ [fkRemovalMetadata.parentKeyColumnName]: entity_id }, mapGqlInputObjectToSqlColumnNames(itemToRemove, fkRemovalMetadata.fkGqlFieldNameToColumnNameMap))),
+                            };
+                            // TODO: Add a DEBUG log for `removePayload`
+                            await sendMessage(storeInboxMessage, messageSettings, removePayload, txn, longLivedToken);
+                        }
+                    }
+                }
+            }
+            if (Object.keys(bulkItemChangePayload.additions).length > 0) {
+                const fkTables = Object.keys(bulkItemChangePayload.additions);
+                // Iterate each related FK table where entities will be added
+                for (const fkTable of fkTables) {
+                    const fkAdditionMetadata = bulkItemChangePayload.additions[fkTable];
+                    if (fkAdditionMetadata.inputData) {
+                        // Generate the ADD payload per entity of the FK table
+                        for (const itemToAdd of fkAdditionMetadata.inputData) {
+                            const addPayload = {
+                                table_name: fkTable,
+                                action: 'ADD',
+                                stringified_condition: '',
+                                stringified_payload: JSON.stringify(Object.assign({ [fkAdditionMetadata.parentKeyColumnName]: entity_id }, mapGqlInputObjectToSqlColumnNames(itemToAdd, fkAdditionMetadata.fkGqlFieldNameToColumnNameMap))),
+                            };
+                            // TODO: Add a DEBUG log for `addPayload`
+                            await sendMessage(storeInboxMessage, messageSettings, addPayload, txn, longLivedToken);
+                        }
+                    }
+                }
+            }
+        }
+    });
+}
+async function sendMessage(storeInboxMessage, messageSettings, changeSetPayload, client, longLivedToken) {
+    return storeInboxMessage(mosaic_message_bus_1.MULTIPLE_AGGREGATE_IDS, messageSettings, changeSetPayload, client, {
+        metadata: { authToken: longLivedToken },
+        concurrency: 'sequential',
+        segment: `${changeSetPayload.table_name}.${changeSetPayload.action}`,
+    });
+}
+function mapGqlInputObjectToSqlColumnNames(sourceGqlInputObject, gqlToSqlColumnNameMap) {
+    const gqlFiledNames = Object.keys(sourceGqlInputObject);
+    return gqlFiledNames.reduce((map, gqlFieldName) => {
+        map[gqlToSqlColumnNameMap[gqlFieldName]] =
+            sourceGqlInputObject[gqlFieldName];
+        return map;
+    }, {});
+}
+// TODO: Handle `insertable` | `deletable` GRANTS for FK Relations
+function generateInputTypeForFKs(build, pgTable, action) {
+    var _a, _b;
+    const inflection = build.inflection;
+    const allFkInputTypesFieldMap = {};
+    // Filter only the interesting FK relations
+    const foreignKeyRelations = getAffectedForeignKeyRelations(pgTable);
+    for (const fkConstraint of foreignKeyRelations) {
+        const parentPgTable = fkConstraint.foreignClass;
+        const parentKey = fkConstraint.keyAttributes[fkConstraint.foreignKeyAttributeNums.indexOf((_b = (_a = parentPgTable === null || parentPgTable === void 0 ? void 0 : parentPgTable.primaryKeyConstraint) === null || _a === void 0 ? void 0 : _a.keyAttributes[0].num) !== null && _b !== void 0 ? _b : -1)];
+        const parentKeyFieldName = inflection.column(parentKey);
+        const fkTableInput = build.pgGetGqlInputTypeByTypeIdAndModifier(fkConstraint.class.type.id, null);
+        const fkTableInputTypeGqlFieldMap = {};
+        for (const key of Object.keys(fkTableInput.getFields())) {
+            if (key !== parentKeyFieldName) {
+                fkTableInputTypeGqlFieldMap[key] = fkTableInput.getFields()[key];
+            }
+        }
+        allFkInputTypesFieldMap[inflection.allRows(fkConstraint.class)] = {
+            type: new graphql_1.GraphQLList(new graphql_1.GraphQLInputObjectType({
+                name: `BulkEditAsync${inflection.tableType(parentPgTable)}${action}${inflection.tableType(fkConstraint.class)}Input`,
+                fields: () => (Object.assign({}, fkTableInputTypeGqlFieldMap)),
+            })),
+        };
+    }
+    const BulkEditAddInputTypeForFK = new graphql_1.GraphQLInputObjectType({
+        name: `BulkEditAsync${inflection.tableType(pgTable)}${action}Input`,
+        fields: () => (Object.assign({}, allFkInputTypesFieldMap)),
+    });
+    build.addType(BulkEditAddInputTypeForFK);
+    return BulkEditAddInputTypeForFK;
+}
+function getAffectedForeignKeyRelations(pgTable) {
+    return pgTable.foreignConstraints.filter((constraint) => constraint.type === 'f' &&
+        (constraint.isFake === undefined || constraint.isFake === false) &&
+        !constraint.name.startsWith('multitenancy_relation_'));
+}
+//# sourceMappingURL=bulk-edit-async-plugin-factory.js.map

package/dist/plugins/bulk-edit/bulk-edit-async-plugin-factory.js.map

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

package/dist/plugins/index.d.ts

@@ -1,5 +1,6 @@
 export * from './add-error-codes-enum-plugin';
 export * from './annotate-types-with-permissions-plugin';
+export * from './bulk-edit/bulk-edit-async-plugin-factory';
 export * from './deprecate-stray-node-id-fields-plugin';
 export * from './generic-bulk-plugin-factory';
 export * from './graphiql-management-mode-plugin-hook';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,yCAAyC,CAAC;AACxD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,yCAAyC,CAAC;AACxD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC"}

package/dist/plugins/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./add-error-codes-enum-plugin"), exports);
 __exportStar(require("./annotate-types-with-permissions-plugin"), exports);
+__exportStar(require("./bulk-edit/bulk-edit-async-plugin-factory"), exports);
 __exportStar(require("./deprecate-stray-node-id-fields-plugin"), exports);
 __exportStar(require("./generic-bulk-plugin-factory"), exports);
 __exportStar(require("./graphiql-management-mode-plugin-hook"), exports);

package/dist/plugins/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,2EAAyD;AACzD,0EAAwD;AACxD,gEAA8C;AAC9C,yEAAuD;AACvD,gEAA8C;AAC9C,6EAA2D;AAC3D,iEAA+C;AAC/C,iEAA+C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,2EAAyD;AACzD,6EAA2D;AAC3D,0EAAwD;AACxD,gEAA8C;AAC9C,yEAAuD;AACvD,gEAA8C;AAC9C,6EAA2D;AAC3D,iEAA+C;AAC/C,iEAA+C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axinom/mosaic-graphql-common",
-  "version": "0.22.0-rc.6",
+  "version": "0.22.0",
   "description": "Common GraphQL and PostGraphile related functionality.",
   "author": "Axinom",
   "license": "PROPRIETARY",
@@ -31,6 +31,11 @@
     "lint": "eslint . --ext .ts,.tsx,.js --color --cache"
   },
   "dependencies": {
+    "@axinom/mosaic-db-common": "^0.46.0",
+    "@axinom/mosaic-message-bus": "^0.36.0",
+    "@axinom/mosaic-message-bus-abstractions": "^0.23.0",
+    "@axinom/mosaic-service-common": "^0.58.0",
+    "@axinom/mosaic-transactional-inbox-outbox": "^0.18.0",
     "@graphile/pg-pubsub": "^4.12.3",
     "endent": "^2.1.0",
     "express": "^4.17.1",
@@ -42,10 +47,11 @@
     "jest": "^29",
     "jest-expect-message": "^1.1.3",
     "pg": "^8.11.3",
+    "pg-transactional-outbox": "^0.5.7",
     "postgraphile": "^4.13.0"
   },
   "devDependencies": {
-    "@axinom/mosaic-dev-be-common": "^0.14.0-rc.6",
+    "@axinom/mosaic-dev-be-common": "^0.14.0",
     "@types/express": "^4.17.17",
     "@types/inflection": "^1.5.28",
     "@types/jest": "^29",
@@ -59,5 +65,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "deae548d43a743e376cfb53bc291fc95fea13946"
+  "gitHead": "c3802f0be74822f25268d4fdf7497a1c1577309d"
 }

package/src/plugins/bulk-edit/bulk-edit-async-plugin-factory.ts

@@ -0,0 +1,624 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable @typescript-eslint/explicit-function-return-type */
+import {
+  DbClient,
+  PgAuthenticatedManagementSubject,
+  buildPgSettings,
+  transactionWithContext,
+} from '@axinom/mosaic-db-common';
+import { MULTIPLE_AGGREGATE_IDS } from '@axinom/mosaic-message-bus';
+import { MultiTenantMessagingSettings } from '@axinom/mosaic-message-bus-abstractions';
+import {
+  BasicConfig,
+  BasicDBConfig,
+  BasicManagedServiceConfig,
+} from '@axinom/mosaic-service-common';
+import { StoreInboxMessage } from '@axinom/mosaic-transactional-inbox-outbox';
+import {
+  PgClass,
+  PgConstraint,
+  PgIntrospectionResultsByKind,
+} from 'graphile-build-pg';
+import { gql as gqlExtended } from 'graphile-utils';
+import GraphQL, {
+  GraphQLInputFieldMap,
+  GraphQLInputObjectType,
+  GraphQLList,
+  GraphQLObjectType,
+  GraphQLString,
+} from 'graphql';
+import { DatabaseClient, IsolationLevel } from 'pg-transactional-outbox';
+import { Build, Inflection, Plugin, SchemaBuilder } from 'postgraphile';
+
+type MinimalConfig = Pick<BasicConfig, 'serviceId'> &
+  (Pick<BasicDBConfig, 'dbOwner'> &
+    Pick<BasicManagedServiceConfig, 'dbEnvOwner'>);
+
+type BulkActionType = 'SET' | 'ADD' | 'REMOVE';
+
+// TODO: Consider reusable types generated from the messages-lib
+interface GenericServicePerformItemChangeCommand {
+  /**
+   * The string has a minimum length of one character and it cannot consist of only whitespace characters.
+   */
+  table_name: string;
+  /**
+   * The type of action to perform on the database table.
+   */
+  action: BulkActionType;
+  /**
+   * The string has a minimum length of one character and it cannot consist of only whitespace characters.
+   */
+  stringified_condition: string;
+  /**
+   * The string has a minimum length of one character and it cannot consist of only whitespace characters.
+   */
+  stringified_payload: string;
+}
+
+/**
+ * This factory will generate a Postgraphile plugin that adds a mutation to the selected entities allowing the user to perform a bulk edit operation on the specified entity and its relations.
+ *
+ * @param tableName Name of the table to enable the BulkEdit mutation
+ * @param bulkEditMutationName Name of the BulkEdit mutation to be generated
+ * @param messageSettings The settings for the MultiTenantMessaging for the service that implements the ItemChangeCommand (e.g. ImageServiceMultiTenantMessagingSettings.ImageServicePerformItemChange)
+ * @returns The Postgraphile plugin that enables the BulkEdit mutation.
+ */
+export const BulkEditAsyncPluginFactory = (
+  tableName: string,
+  bulkEditMutationName: string,
+  messageSettings: MultiTenantMessagingSettings,
+  getLongLivedToken: (
+    originalToken: string,
+    config: BasicDBConfig,
+  ) => Promise<string>,
+): Plugin => {
+  return (builder: SchemaBuilder): void => {
+    builder.hook('GraphQLObjectType:fields', (fields, build, ctx) => {
+      const inflection: Inflection = build.inflection;
+
+      if (ctx.scope.isRootMutation && fields !== undefined) {
+        const pgIntrospectionResultsByKind: PgIntrospectionResultsByKind =
+          build.pgIntrospectionResultsByKind;
+
+        const pgTable = pgIntrospectionResultsByKind.class.find(
+          (cls) => cls.name === tableName,
+        );
+
+        if (!pgTable) {
+          // TODO: Log a warning for `Table "${tableName}" not found.`
+          return fields;
+        }
+
+        if (pgTable.primaryKeyConstraint?.keyAttributes.length !== 1) {
+          // TODO: Log a warning for `Table "${tableName}" skipped since the PK attribute count is not exactly 1.`
+          return fields;
+        }
+
+        const graphQLObjectTypeName = inflection.tableType(pgTable);
+        const graphQLObjectType = build.getTypeByName(graphQLObjectTypeName);
+
+        const connectionFilterType: GraphQLInputObjectType =
+          build.connectionFilterTypesByTypeName[
+            `${graphQLObjectTypeName}Filter`
+          ];
+
+        const patchType: GraphQLInputObjectType = build.getTypeByName(
+          inflection.patchType(graphQLObjectType.name),
+        );
+
+        const addInputTypeForFKs = generateInputTypeForFKs(
+          build,
+          pgTable,
+          'Add',
+        );
+
+        const removeInputTypeForFKs = generateInputTypeForFKs(
+          build,
+          pgTable,
+          'Remove',
+        );
+
+        // TODO: Handle this to work even when the same Payload type is used multiple times (i.e. per each table with BulkEdit feature)
+        const BulkEditPayloadType = new GraphQLObjectType({
+          name: 'BulkEditAsyncPayloadType',
+          fields: () => ({
+            filterMatchedIds: {
+              type: new GraphQLList(GraphQLString),
+            },
+          }),
+        });
+
+        const args = {
+          filter: {
+            type: connectionFilterType,
+          },
+          set: {
+            type: patchType,
+          },
+          relatedEntitiesToRemove: {
+            type: removeInputTypeForFKs,
+          },
+          relatedEntitiesToAdd: {
+            type: addInputTypeForFKs,
+          },
+        };
+
+        const operation = {
+          type: BulkEditPayloadType,
+          args,
+          async resolve(
+            parent: unknown,
+            input: {
+              filter: { [key: string]: any };
+              set?: { [key: string]: any };
+              relatedEntitiesToRemove?: { [key: string]: [any] };
+              relatedEntitiesToAdd?: { [key: string]: [any] };
+            },
+            context: { [str: string]: unknown },
+            resolveInfo: GraphQL.GraphQLResolveInfo,
+          ) {
+            const {
+              config,
+              jwtToken,
+              subject,
+              ownerPool,
+              envOwnerPool,
+              storeInboxMessage,
+            } = context;
+
+            const longLivedToken = await getLongLivedToken(
+              jwtToken as string,
+              config as BasicDBConfig,
+            );
+
+            const entityIds = await getEntityIds(
+              {
+                filterName: connectionFilterType.name,
+                queryName: inflection.allRows(pgTable),
+                primaryKeyFieldName: inflection.column(
+                  pgTable.primaryKeyConstraint?.keyAttributes[0],
+                ),
+              },
+              build.graphql,
+              input,
+              context,
+              resolveInfo.schema,
+            );
+
+            const { set, relatedEntitiesToRemove, relatedEntitiesToAdd } =
+              input;
+
+            const { removals, additions } = getFkResolverPayload(
+              build,
+              pgTable,
+              relatedEntitiesToRemove,
+              relatedEntitiesToAdd,
+            );
+
+            await asyncResolverImplementation(
+              messageSettings,
+              {
+                set: getMainResolverPayload(build, pgTable, set),
+                removals,
+                additions,
+              },
+              entityIds,
+              config as MinimalConfig,
+              ownerPool as DbClient,
+              envOwnerPool as DbClient,
+              longLivedToken,
+              subject as PgAuthenticatedManagementSubject,
+              storeInboxMessage as StoreInboxMessage,
+            );
+
+            return {
+              filterMatchedIds: entityIds,
+            };
+          },
+        };
+
+        build.extend(fields, {
+          [bulkEditMutationName]: operation,
+        });
+      }
+
+      return fields;
+    });
+  };
+};
+
+/**
+ * Get all the database IDs from the entities that were selected via the GraphQL filter
+ */
+const getEntityIds = async (
+  metadata: {
+    filterName: string;
+    queryName: string;
+    primaryKeyFieldName: string;
+  },
+  graphql: typeof GraphQL,
+  args: { [argName: string]: unknown },
+  context: unknown,
+  schema: GraphQL.GraphQLSchema,
+): Promise<string[]> => {
+  const queryResult = await graphql.execute(
+    schema,
+    gqlExtended`
+      query getEntityIds($filter: ${metadata.filterName}) {
+        entities: ${metadata.queryName}(filter: $filter) {
+          nodes {
+            ${metadata.primaryKeyFieldName}
+          }
+        }
+      }
+    `,
+    undefined,
+    context,
+    args,
+  );
+
+  return queryResult?.data?.entities?.nodes.map(
+    (entity: Record<string, unknown>) => {
+      return entity[metadata.primaryKeyFieldName];
+    },
+  );
+};
+
+interface FKProcessingMetadata {
+  [fKTableName: string]: {
+    fkGqlFieldNameToColumnNameMap: { [key: string]: string };
+    fkGqlFieldName: string;
+    parentKeyFieldName: string;
+    parentKeyColumnName: string;
+  };
+}
+
+interface MainResolverPayload {
+  mainTableName: string;
+  gqlFieldNameToColumnNameMap: { [key: string]: string };
+  inputData?: { [key: string]: any };
+}
+
+interface FkResolverPayload {
+  [fKTableName: string]: {
+    parentKeyColumnName: string;
+    fkGqlFieldNameToColumnNameMap: { [key: string]: string };
+    inputData?: [{ [key: string]: any }];
+  };
+}
+
+interface BulkItemChangePayload {
+  set: MainResolverPayload;
+  removals: FkResolverPayload;
+  additions: FkResolverPayload;
+}
+
+function getMainResolverPayload(
+  build: Build,
+  pgTable: PgClass,
+  set: { [key: string]: any } | undefined,
+): MainResolverPayload {
+  const inflection: Inflection = build.inflection;
+
+  return {
+    mainTableName: pgTable.name,
+    gqlFieldNameToColumnNameMap: pgTable.attributes.reduce((map: any, curr) => {
+      map[inflection.column(curr)] = curr.name;
+
+      return map;
+    }, {}),
+    inputData: set,
+  };
+}
+
+// TODO: Can be potentially optimized (i.e. with getAffectedForeignKeyRelations or with asyncResolverImplementation)
+function getFkResolverPayload(
+  build: Build,
+  pgTable: PgClass,
+  relatedEntitiesToRemove:
+    | {
+        [key: string]: [any];
+      }
+    | undefined,
+  relatedEntitiesToAdd:
+    | {
+        [key: string]: [any];
+      }
+    | undefined,
+): {
+  additions: FkResolverPayload;
+  removals: FkResolverPayload;
+} {
+  const inflection: Inflection = build.inflection;
+  const foreignKeyRelations = getAffectedForeignKeyRelations(pgTable);
+
+  const fkProcessingMetadata: FKProcessingMetadata = {};
+
+  for (const fkConstraint of foreignKeyRelations) {
+    const parentKey =
+      fkConstraint.keyAttributes[
+        fkConstraint.foreignKeyAttributeNums.indexOf(
+          pgTable.primaryKeyConstraint?.keyAttributes[0].num ?? -1,
+        )
+      ];
+
+    fkProcessingMetadata[fkConstraint.class.name] = {
+      fkGqlFieldNameToColumnNameMap: fkConstraint.class.attributes.reduce(
+        (map: any, curr) => {
+          map[inflection.column(curr)] = curr.name;
+
+          return map;
+        },
+        {},
+      ),
+      fkGqlFieldName: inflection.allRows(fkConstraint.class),
+      parentKeyFieldName: inflection.column(parentKey),
+      parentKeyColumnName: parentKey.name,
+    };
+  }
+
+  const additions: FkResolverPayload = {};
+  const removals: FkResolverPayload = {};
+
+  for (const fkProps of Object.keys(fkProcessingMetadata)) {
+    if (relatedEntitiesToAdd) {
+      additions[fkProps] = {
+        parentKeyColumnName: fkProcessingMetadata[fkProps].parentKeyColumnName,
+        inputData:
+          relatedEntitiesToAdd[fkProcessingMetadata[fkProps].fkGqlFieldName],
+        fkGqlFieldNameToColumnNameMap:
+          fkProcessingMetadata[fkProps].fkGqlFieldNameToColumnNameMap,
+      };
+    }
+
+    if (relatedEntitiesToRemove) {
+      removals[fkProps] = {
+        parentKeyColumnName: fkProcessingMetadata[fkProps].parentKeyColumnName,
+        inputData:
+          relatedEntitiesToRemove[fkProcessingMetadata[fkProps].fkGqlFieldName],
+        fkGqlFieldNameToColumnNameMap:
+          fkProcessingMetadata[fkProps].fkGqlFieldNameToColumnNameMap,
+      };
+    }
+  }
+
+  return { additions, removals };
+}
+
+async function asyncResolverImplementation(
+  messageSettings: MultiTenantMessagingSettings,
+  bulkItemChangePayload: BulkItemChangePayload,
+  entityIds: string[],
+  config: MinimalConfig,
+  ownerPool: DbClient,
+  envOwnerPool: DbClient,
+  longLivedToken: string,
+  subject: PgAuthenticatedManagementSubject,
+  storeInboxMessage: StoreInboxMessage,
+) {
+  const pool = envOwnerPool ? envOwnerPool : ownerPool;
+  const dbRole = envOwnerPool ? config.dbEnvOwner : config.dbOwner;
+
+  const pgSettings = buildPgSettings(subject, dbRole, config.serviceId);
+
+  await transactionWithContext(
+    pool,
+    IsolationLevel.ReadCommitted,
+    pgSettings,
+    async (txn) => {
+      // Iterate all the entity IDs
+      for (const entity_id of entityIds) {
+        if (bulkItemChangePayload.set.inputData) {
+          // Generate the SET payload
+          const actionSetPayload: GenericServicePerformItemChangeCommand = {
+            table_name: bulkItemChangePayload.set.mainTableName,
+            action: 'SET',
+            stringified_condition: JSON.stringify({ id: entity_id }),
+            stringified_payload: JSON.stringify(
+              mapGqlInputObjectToSqlColumnNames(
+                bulkItemChangePayload.set.inputData,
+                bulkItemChangePayload.set.gqlFieldNameToColumnNameMap,
+              ),
+            ),
+          };
+
+          // TODO: Add a DEBUG log for `actionSetPayload`
+
+          await sendMessage(
+            storeInboxMessage,
+            messageSettings,
+            actionSetPayload,
+            txn,
+            longLivedToken,
+          );
+        }
+
+        if (bulkItemChangePayload.removals) {
+          const fkTableNames = Object.keys(bulkItemChangePayload.removals);
+
+          // Iterate each related FK table where entities will be removed
+          for (const fkTableName of fkTableNames) {
+            const fkRemovalMetadata =
+              bulkItemChangePayload.removals[fkTableName];
+            if (fkRemovalMetadata.inputData) {
+              // Generate the REMOVE payload per entity of the FK table
+              for (const itemToRemove of fkRemovalMetadata.inputData) {
+                const removePayload: GenericServicePerformItemChangeCommand = {
+                  table_name: fkTableName,
+                  action: 'REMOVE',
+                  stringified_condition: '',
+                  stringified_payload: JSON.stringify({
+                    [fkRemovalMetadata.parentKeyColumnName]: entity_id,
+                    ...mapGqlInputObjectToSqlColumnNames(
+                      itemToRemove,
+                      fkRemovalMetadata.fkGqlFieldNameToColumnNameMap,
+                    ),
+                  }),
+                };
+
+                // TODO: Add a DEBUG log for `removePayload`
+
+                await sendMessage(
+                  storeInboxMessage,
+                  messageSettings,
+                  removePayload,
+                  txn,
+                  longLivedToken,
+                );
+              }
+            }
+          }
+        }
+
+        if (Object.keys(bulkItemChangePayload.additions).length > 0) {
+          const fkTables = Object.keys(bulkItemChangePayload.additions);
+
+          // Iterate each related FK table where entities will be added
+          for (const fkTable of fkTables) {
+            const fkAdditionMetadata = bulkItemChangePayload.additions[fkTable];
+            if (fkAdditionMetadata.inputData) {
+              // Generate the ADD payload per entity of the FK table
+              for (const itemToAdd of fkAdditionMetadata.inputData) {
+                const addPayload: GenericServicePerformItemChangeCommand = {
+                  table_name: fkTable,
+                  action: 'ADD',
+                  stringified_condition: '',
+                  stringified_payload: JSON.stringify({
+                    [fkAdditionMetadata.parentKeyColumnName]: entity_id,
+                    ...mapGqlInputObjectToSqlColumnNames(
+                      itemToAdd,
+                      fkAdditionMetadata.fkGqlFieldNameToColumnNameMap,
+                    ),
+                  }),
+                };
+
+                // TODO: Add a DEBUG log for `addPayload`
+
+                await sendMessage(
+                  storeInboxMessage,
+                  messageSettings,
+                  addPayload,
+                  txn,
+                  longLivedToken,
+                );
+              }
+            }
+          }
+        }
+      }
+    },
+  );
+}
+
+async function sendMessage(
+  storeInboxMessage: StoreInboxMessage,
+  messageSettings: MultiTenantMessagingSettings,
+  changeSetPayload: GenericServicePerformItemChangeCommand,
+  client: DatabaseClient,
+  longLivedToken: string,
+): Promise<void> {
+  return storeInboxMessage(
+    MULTIPLE_AGGREGATE_IDS,
+    messageSettings,
+    changeSetPayload,
+    client,
+    {
+      metadata: { authToken: longLivedToken },
+      concurrency: 'sequential',
+      segment: `${changeSetPayload.table_name}.${changeSetPayload.action}`,
+    },
+  );
+}
+
+function mapGqlInputObjectToSqlColumnNames(
+  sourceGqlInputObject: {
+    [gqlFieldName: string]: any;
+  },
+  gqlToSqlColumnNameMap: {
+    [gqlFieldName: string]: string;
+  },
+): { [sqlColumnName: string]: any } {
+  const gqlFiledNames = Object.keys(sourceGqlInputObject);
+
+  return gqlFiledNames.reduce((map: any, gqlFieldName) => {
+    map[gqlToSqlColumnNameMap[gqlFieldName]] =
+      sourceGqlInputObject[gqlFieldName];
+
+    return map;
+  }, {});
+}
+
+// TODO: Handle `insertable` | `deletable` GRANTS for FK Relations
+function generateInputTypeForFKs(
+  build: Build,
+  pgTable: PgClass,
+  action: 'Add' | 'Remove',
+): GraphQLInputObjectType {
+  const inflection: Inflection = build.inflection;
+  const allFkInputTypesFieldMap: GraphQL.Thunk<GraphQL.GraphQLInputFieldConfigMap> =
+    {};
+
+  // Filter only the interesting FK relations
+  const foreignKeyRelations = getAffectedForeignKeyRelations(pgTable);
+
+  for (const fkConstraint of foreignKeyRelations) {
+    const parentPgTable = fkConstraint.foreignClass;
+
+    const parentKey =
+      fkConstraint.keyAttributes[
+        fkConstraint.foreignKeyAttributeNums.indexOf(
+          parentPgTable?.primaryKeyConstraint?.keyAttributes[0].num ?? -1,
+        )
+      ];
+
+    const parentKeyFieldName = inflection.column(parentKey);
+
+    const fkTableInput: GraphQLInputObjectType =
+      build.pgGetGqlInputTypeByTypeIdAndModifier(
+        fkConstraint.class.type.id,
+        null,
+      );
+
+    const fkTableInputTypeGqlFieldMap: GraphQLInputFieldMap = {};
+    for (const key of Object.keys(fkTableInput.getFields())) {
+      if (key !== parentKeyFieldName) {
+        fkTableInputTypeGqlFieldMap[key] = fkTableInput.getFields()[key];
+      }
+    }
+
+    allFkInputTypesFieldMap[inflection.allRows(fkConstraint.class)] = {
+      type: new GraphQLList(
+        new GraphQLInputObjectType({
+          name: `BulkEditAsync${inflection.tableType(
+            parentPgTable,
+          )}${action}${inflection.tableType(fkConstraint.class)}Input`,
+          fields: () => ({
+            ...fkTableInputTypeGqlFieldMap,
+          }),
+        }),
+      ),
+    };
+  }
+
+  const BulkEditAddInputTypeForFK = new GraphQLInputObjectType({
+    name: `BulkEditAsync${inflection.tableType(pgTable)}${action}Input`,
+    fields: () => ({
+      ...allFkInputTypesFieldMap,
+    }),
+  });
+
+  build.addType(BulkEditAddInputTypeForFK);
+
+  return BulkEditAddInputTypeForFK;
+}
+
+function getAffectedForeignKeyRelations(pgTable: PgClass) {
+  return pgTable.foreignConstraints.filter(
+    (constraint: PgConstraint & { isFake?: boolean }) =>
+      constraint.type === 'f' &&
+      (constraint.isFake === undefined || constraint.isFake === false) &&
+      !constraint.name.startsWith('multitenancy_relation_'),
+  );
+}

package/src/plugins/index.ts

@@ -1,5 +1,6 @@
 export * from './add-error-codes-enum-plugin';
 export * from './annotate-types-with-permissions-plugin';
+export * from './bulk-edit/bulk-edit-async-plugin-factory';
 export * from './deprecate-stray-node-id-fields-plugin';
 export * from './generic-bulk-plugin-factory';
 export * from './graphiql-management-mode-plugin-hook';