@postxl/generators 0.2.2

package/dist/backend-import/import.generator.js

@@ -0,0 +1,255 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generator = exports.generatorId = void 0;
+const node_path_1 = require("node:path");
+const Generator = __importStar(require("@postxl/generator"));
+const backend_actions_1 = require("../backend-actions");
+const backend_core_1 = require("../backend-core");
+const backend_repositories_1 = require("../backend-repositories");
+const backend_update_1 = require("../backend-update");
+const base_1 = require("../base");
+const decoders_1 = require("../decoders");
+const types_1 = require("../types");
+const convert_functions_generator_1 = require("./generators/convert-functions.generator");
+const detect_delta_all_models_generator_1 = require("./generators/detect-delta/detect-delta-all-models.generator");
+const detect_delta_functions_generator_1 = require("./generators/detect-delta/detect-delta-functions.generator");
+const model_function_generator_1 = require("./generators/detect-delta/model-function.generator");
+const types_generator_1 = require("./generators/detect-delta/types.generator");
+const import_module_generator_1 = require("./generators/import-module.generator");
+const import_service_generator_1 = require("./generators/import-service.generator");
+exports.generatorId = Generator.toGeneratorInterfaceId('backend-import');
+exports.generator = {
+    id: exports.generatorId,
+    requires: [
+        types_1.typesGeneratorId,
+        backend_core_1.backendGeneratorId,
+        base_1.baseGeneratorId,
+        types_1.typesGeneratorId,
+        backend_actions_1.backendActionsGeneratorId,
+        backend_repositories_1.backendRepositoriesGeneratorId,
+        decoders_1.decodersGeneratorId,
+        backend_update_1.backendUpdateGeneratorId,
+    ],
+    register: (context) => {
+        const module = {
+            name: Generator.toClassName('ImportModule'),
+            location: Generator.toBackendModuleLocation(`@import/import.module`),
+        };
+        const importModule = {
+            name: Generator.toBackendModuleName('import'),
+            moduleClass: module,
+        };
+        context.backend.modules.push(importModule);
+        const convertFunctionLocation = Generator.toBackendModuleLocation(`@import/convert-import.functions`);
+        const serviceLocation = Generator.toBackendModuleLocation(`@import/import.service`);
+        const allModelsLocation = Generator.toBackendModuleLocation(`@import/detect-delta/models.detect-delta`);
+        const typeLocation = Generator.toBackendModuleLocation(`@import/detect-delta/types`);
+        const utilsLocation = Generator.toBackendModuleLocation(`@import/detect-delta/utils`);
+        const actionScope = (0, backend_actions_1.toScopeName)('import');
+        const importContext = {
+            module: importModule,
+            service: {
+                name: Generator.toClassName('ImportService'),
+                location: serviceLocation,
+                variableName: Generator.toVariableName(`importService`),
+            },
+            actionScope,
+            scopes: new Set([actionScope]),
+            actions: {
+                summary: {
+                    action: { name: Generator.toTypeName(`Action_Import`), location: serviceLocation },
+                    result: { name: Generator.toTypeName(`ActionResult_Import`), location: serviceLocation },
+                },
+                excel: {
+                    action: { name: Generator.toTypeName(`Action_Import_Excel`), location: serviceLocation },
+                    result: { name: Generator.toTypeName(`ActionResult_Import_Excel`), location: serviceLocation },
+                },
+                excelSeed: {
+                    action: { name: Generator.toTypeName(`Action_Import_ExcelSeed`), location: serviceLocation },
+                    result: { name: Generator.toTypeName(`ActionResult_Import_ExcelSeed`), location: serviceLocation },
+                },
+                data: {
+                    action: { name: Generator.toTypeName(`Action_Import_Data`), location: serviceLocation },
+                    result: { name: Generator.toTypeName(`ActionResult_Import_Data`), location: serviceLocation },
+                },
+                dataSeed: {
+                    action: { name: Generator.toTypeName(`Action_Import_DataSeed`), location: serviceLocation },
+                    result: { name: Generator.toTypeName(`ActionResult_Import_DataSeed`), location: serviceLocation },
+                },
+            },
+            detectDelta: {
+                allModels: {
+                    name: Generator.toFunctionName(`detectDelta`),
+                    location: allModelsLocation,
+                    type: {
+                        name: Generator.toTypeName(`Delta`),
+                        location: allModelsLocation,
+                    },
+                    idMapType: {
+                        name: Generator.toTypeName(`IdMap`),
+                        location: allModelsLocation,
+                    },
+                    extractErrors: {
+                        name: Generator.toFunctionName(`extractErrors`),
+                        location: allModelsLocation,
+                    },
+                    summarizeErrors: {
+                        name: Generator.toFunctionName(`summarizeErrors`),
+                        location: allModelsLocation,
+                    },
+                },
+                _utils: {
+                    detectModelDelta: { name: Generator.toFunctionName(`detectModelDelta`), location: utilsLocation },
+                    validation: {
+                        params: { name: Generator.toTypeName(`ValidationFunctions`), location: utilsLocation },
+                        referenceField: { name: Generator.toFunctionName(`validateReferenceField`), location: utilsLocation },
+                        requiredFields: { name: Generator.toFunctionName(`validateRequiredFields`), location: utilsLocation },
+                        requiredDependency: {
+                            name: Generator.toFunctionName(`validateRequiredDependency`),
+                            location: utilsLocation,
+                        },
+                        uniqueField: { name: Generator.toFunctionName(`validateUniqueField`), location: utilsLocation },
+                        int: { name: Generator.toFunctionName(`validateInt`), location: utilsLocation },
+                    },
+                    getDelta: { name: Generator.toFunctionName(`getDelta`), location: utilsLocation },
+                    keepErrors: { name: Generator.toFunctionName(`keepErrors`), location: utilsLocation },
+                },
+                types: {
+                    generic: {
+                        modelType: { name: Generator.toTypeName(`Delta_Model`), location: typeLocation },
+                        create: {
+                            type: { name: Generator.toTypeName(`Delta_Model_Create`), location: typeLocation },
+                            discriminant: Generator.toDiscriminantValue(`create`),
+                            typeGuard: { name: Generator.toFunctionName(`isDelta_Model_Create`), location: typeLocation },
+                        },
+                        update: {
+                            type: { name: Generator.toTypeName(`Delta_Model_Update`), location: typeLocation },
+                            discriminant: Generator.toDiscriminantValue(`update`),
+                            typeGuard: { name: Generator.toFunctionName(`isDelta_Model_Update`), location: typeLocation },
+                        },
+                        delete: {
+                            type: { name: Generator.toTypeName(`Delta_Model_Delete`), location: typeLocation },
+                            discriminant: Generator.toDiscriminantValue(`delete`),
+                            typeGuard: { name: Generator.toFunctionName(`isDelta_Model_Delete`), location: typeLocation },
+                        },
+                        unchanged: {
+                            type: { name: Generator.toTypeName(`Delta_Model_Unchanged`), location: typeLocation },
+                            discriminant: Generator.toDiscriminantValue(`unchanged`),
+                            typeGuard: { name: Generator.toFunctionName(`isDelta_Model_Unchanged`), location: typeLocation },
+                        },
+                        errors: {
+                            type: { name: Generator.toTypeName(`Delta_Model_Errors`), location: typeLocation },
+                            discriminant: Generator.toDiscriminantValue(`errors`),
+                            typeGuard: { name: Generator.toFunctionName(`isDelta_Model_Errors`), location: typeLocation },
+                            missingField: {
+                                type: { name: Generator.toTypeName(`Delta_Model_Errors_MissingField`), location: typeLocation },
+                                discriminant: Generator.toDiscriminantValue(`required-field-missing`),
+                            },
+                            invalidReference: {
+                                type: { name: Generator.toTypeName(`Delta_Model_Errors_InvalidReference`), location: typeLocation },
+                                discriminant: Generator.toDiscriminantValue(`invalid-reference`),
+                            },
+                            nonUnique: {
+                                type: { name: Generator.toTypeName(`Delta_Model_Errors_NonUnique`), location: typeLocation },
+                                discriminant: Generator.toDiscriminantValue(`non-unique`),
+                            },
+                            invalidType: {
+                                type: { name: Generator.toTypeName(`Delta_Model_Errors_InvalidType`), location: typeLocation },
+                                discriminant: Generator.toDiscriminantValue(`invalid-type`),
+                            },
+                            isRequiredDependency: {
+                                type: { name: Generator.toTypeName(`Delta_Model_Errors_IsRequiredDependency`), location: typeLocation },
+                                discriminant: Generator.toDiscriminantValue(`is-required-dependency`),
+                            },
+                        },
+                        delta_Fields: { name: Generator.toTypeName(`Delta_Fields`), location: typeLocation },
+                    },
+                },
+            },
+            converterFunctions: {
+                importedDataToBulkMutations: {
+                    location: convertFunctionLocation,
+                    name: Generator.toFunctionName(`importedDataToBulkMutations`),
+                },
+                deltaToBulkMutations: {
+                    location: convertFunctionLocation,
+                    name: Generator.toFunctionName(`deltaToBulkMutations`),
+                },
+            },
+        };
+        context.actions.providers.push(importContext);
+        const models = new Map();
+        for (const [modelName, model] of context.models) {
+            const modelWithImport = registerModelImport(model);
+            models.set(modelName, modelWithImport);
+        }
+        return { ...context, import: importContext, models };
+    },
+    generate: async (context) => {
+        const srcVfs = new Generator.VirtualFileSystem();
+        srcVfs.write(Generator.toLocalFile(context.import.detectDelta.types.generic.modelType), (0, types_generator_1.generateDetectDeltaTypes)(context));
+        srcVfs.write(Generator.toLocalFile(context.import.detectDelta._utils.detectModelDelta), (0, detect_delta_functions_generator_1.generateDetectDeltaFunctions)(context));
+        srcVfs.write(Generator.toLocalFile(context.import.detectDelta.allModels), (0, detect_delta_all_models_generator_1.generateDetectDeltaAllModels)(context));
+        srcVfs.write(Generator.toLocalFile(context.import.service), (0, import_service_generator_1.generateImportService)(context));
+        srcVfs.write(Generator.toLocalFile(context.import.converterFunctions.deltaToBulkMutations), (0, convert_functions_generator_1.generateConvertImportFunctions)(context));
+        for (const model of context.models.values()) {
+            srcVfs.write(Generator.toLocalFile(model.import.delta.detect), (0, model_function_generator_1.generateDetectModelDeltaFunction)(context, model));
+        }
+        srcVfs.write(Generator.toLocalFile(context.import.module.moduleClass), (0, import_module_generator_1.generateImportModule)(context)); // NOSONAR - type assertion is required here
+        const vfs = new Generator.VirtualFileSystem();
+        vfs.insertFromVfs({ targetPath: 'src', vfs: srcVfs });
+        vfs.write('/tsconfig.lib.json', Generator.generateTsConfig('import'));
+        await vfs.loadFolder({ diskPath: (0, node_path_1.resolve)(__dirname, './template') });
+        context.vfs.insertFromVfs({ targetPath: 'backend/libs/import', vfs: vfs });
+        return context;
+    },
+};
+function registerModelImport(model) {
+    const value = {
+        delta: {
+            errors: {
+                name: Generator.toTypeName(`Delta_Model_${model._conjugated.PascalCase}_Errors`),
+                location: Generator.toBackendModuleLocation(`@import/detect-delta/${model._conjugated.camelCase}.detect-delta`),
+            },
+            detect: {
+                name: Generator.toFunctionName(`detect${model._conjugated.PascalCase}Delta`),
+                location: Generator.toBackendModuleLocation(`@import/detect-delta/${model._conjugated.camelCase}.detect-delta`),
+            },
+        },
+    };
+    return { ...model, import: value };
+}
+//# sourceMappingURL=import.generator.js.map

package/dist/backend-import/import.generator.js.map

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

package/dist/backend-import/index.d.ts

@@ -0,0 +1,5 @@
+import * as Generator from './import.generator';
+export type WithImport<Context> = Generator.WithBackendImport<Context>;
+export type WithBackendImport<Context> = Generator.WithBackendImport<Context>;
+export declare const backendImportGenerator: import("@postxl/generator").GeneratorInterface;
+export declare const backendImportGeneratorId: string & import("zod").BRAND<"PXL.GeneratorInterfaceId">;

package/dist/backend-import/index.js

@@ -0,0 +1,40 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.backendImportGeneratorId = exports.backendImportGenerator = void 0;
+const Generator = __importStar(require("./import.generator"));
+exports.backendImportGenerator = Generator.generator;
+exports.backendImportGeneratorId = Generator.generatorId;
+//# sourceMappingURL=index.js.map

package/dist/backend-import/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend-import/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,8DAA+C;AAIlC,QAAA,sBAAsB,GAAG,SAAS,CAAC,SAAS,CAAA;AAC5C,QAAA,wBAAwB,GAAG,SAAS,CAAC,WAAW,CAAA"}

package/dist/backend-import/template/README.md

@@ -0,0 +1,52 @@
+# PXL Backend Import
+
+The import module provides a set of helpful utilities to implement data imports. Out of the box, it comes with a complete import from Excel to the database - including the ability to detect data issues and derive a delta to the current data.
+
+## Module components
+
+### Load & decode data
+
+This module does not provide specific functionality to load and decode data. Instead, it relies on the [decoders](../decoders) package to decode data (e.g. from flattenend Excel data to nested objects). To load data from Excel files, we use the [xlport](../xlport) package.
+
+### Detect delta
+
+-> see [./detect-delta](./detect-delta) folder
+
+Set of functions and types to detect the delta between the current data in the repositories and newly provided data
+
+The main function is `detectDelta`, which takes the data service (to access existing data in the repositories) and the decoded new data - and returns a delta for each model.
+
+### Convert functions
+
+-> see [./convert-import.functions](./convert-import.functions.ts)
+
+Provides two functions:
+
+- `deltaToBulkMutations` converts the delta to bulk mutations
+- `importedDataToBulkMutations` converts the decoded data to bulk mutations
+
+The latter function does not require the delta, ie it should only be used for seeding!
+
+### Import service
+
+-> see [./import.service.ts](./import.service.ts)
+
+This service provides the dispatcher for the different import actions. By default, it provides the following actions:
+
+- `excel`: Imports data from an Excel file
+- `excelSeed`: Imports data from an Excel file and seeds the data
+- `data`: Imports data from a data file
+- `dataSeed`: Imports data from a data file and seeds the data
+
+These actions can be used in seeding or in other custom import scenarios.
+
+## Side note: Transformations
+
+During seeding, Excel imports and potentially other larger migrations/data operations, we typically create an Action - which then naturally results in multiple Mutations (create, update, edit, createMany, etc.) to alter the data.
+Before triggering the mutations, we typically need to preprocess the data, e.g.:
+
+- Extract the data from the Excel file, then decode it with Zod
+- Read the CSV/JSON file(s), then decode it with Zod
+- After decoding, we need to detect the delta and convert it to BulkUpdates
+
+Each of these steps can fail and lead to distinct errors. To debug these, we create a "Transformation" operation for each each step - and store it (together with the step's payload and result) in the operations table, assigned to the action. This uses the same mechanism as the "Mutation" operation.

package/dist/backend-repositories/generators/bulk-mutation-types.generator.d.ts

@@ -0,0 +1,2 @@
+import { ContextResult } from '../repositories.generator';
+export declare function generateBulkMutationTypes(context: ContextResult): string;

package/dist/backend-repositories/generators/bulk-mutation-types.generator.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateBulkMutationTypes = generateBulkMutationTypes;
+const generator_1 = require("@postxl/generator");
+function generateBulkMutationTypes(context) {
+    const imports = generator_1.ImportGenerator.from(context.repositories.bulkMutation.location);
+    const bulkMutations = [];
+    for (const model of context.models.values()) {
+        if (model.repository.kind === 'NoRepository') {
+            continue;
+        }
+        imports.addType(model.types);
+        imports.addType(model.types.id);
+        bulkMutations.push(`${model.repository.bulkMutationEntry}?: BulkMutationForModel<${model.types.name}, ${model.types.id.name}>`);
+    }
+    imports.addType(context.types.dto.create);
+    imports.addType(context.types.dto.update);
+    imports.addType(context.types.dto.upsert);
+    imports.addType(context.types.dto.genericModel);
+    imports.addType(context.types.dto.idType);
+    return /* ts */ `
+${imports.generate()}
+
+/**
+ * Generic type for BulkMutation for a model.
+ */
+export type ${context.repositories.bulkMutationForModel.name}<Model extends ${context.types.dto.genericModel.name}<ID>, ID extends ${context.types.dto.idType.name}> = {
+  create?: ${context.types.dto.create.name}<Model, ID>[]
+  update?: ${context.types.dto.update.name}<Model, ID>[]
+  upsert?: ${context.types.dto.upsert.name}<Model, ID>[]
+  delete?: ID[]
+}
+
+/**
+ * Bulk changes for all models.
+ */
+export type ${context.repositories.bulkMutation.name} = {
+  ${bulkMutations.join(',\n')}
+}
+`;
+}
+//# sourceMappingURL=bulk-mutation-types.generator.js.map

package/dist/backend-repositories/generators/bulk-mutation-types.generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-mutation-types.generator.js","sourceRoot":"","sources":["../../../src/backend-repositories/generators/bulk-mutation-types.generator.ts"],"names":[],"mappings":";;AAIA,8DAwCC;AA5CD,iDAAmD;AAInD,SAAgB,yBAAyB,CAAC,OAAsB;IAC9D,MAAM,OAAO,GAAG,2BAAe,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;IAChF,MAAM,aAAa,GAAa,EAAE,CAAA;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC7C,SAAQ;QACV,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC5B,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC/B,aAAa,CAAC,IAAI,CAChB,GAAG,KAAK,CAAC,UAAU,CAAC,iBAAiB,2BAA2B,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,GAAG,CAC5G,CAAA;IACH,CAAC;IAED,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACzC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACzC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACzC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAC/C,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAEzC,OAAO,QAAQ,CAAC;EAChB,OAAO,CAAC,QAAQ,EAAE;;;;;cAKN,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,IAAI,kBAAkB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,oBAAoB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI;aACrJ,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI;aAC7B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI;aAC7B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI;;;;;;;cAO5B,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI;IAChD,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;;CAE5B,CAAA;AACD,CAAC"}

package/dist/backend-repositories/generators/data-service.generator.d.ts

@@ -0,0 +1,2 @@
+import { ContextResult } from '../repositories.generator';
+export declare function generateDataService(context: ContextResult): string;