@postxl/generators 0.2.2

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

@@ -0,0 +1,304 @@
+"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.generateImportService = generateImportService;
+const Generator = __importStar(require("@postxl/generator"));
+function generateImportService(context) {
+    const { import: { service, detectDelta, converterFunctions }, decoders, } = context;
+    const imports = Generator.ImportGenerator.from(service.location);
+    imports
+        .addType(context.update.bulk.type)
+        .add(context.repositories.dataService)
+        .addType(context.actions.execution.interface)
+        .addType(decoders.excelDataModel.decodedType)
+        .addType(context.decoders.excelDataModel.decodedType)
+        .addType(context.decoders.excelDataModel.encodedType)
+        .add(context.decoders.excelDataModel.decoder.parseFunction)
+        .add(converterFunctions.deltaToBulkMutations)
+        .add(converterFunctions.importedDataToBulkMutations)
+        .addType(detectDelta.allModels.type)
+        .add(detectDelta.allModels);
+    return `
+import { Injectable, Logger } from '@nestjs/common'
+import { XlPortService } from '@xlport/xlport.service'
+
+import z from 'zod'
+
+import { ExhaustiveSwitchCheck } from '@postxl/utils'
+${imports.generate()}
+
+export type ${context.import.actions.summary.action.name} = 
+  | ${context.import.actions.excel.action.name}
+  | ${context.import.actions.excelSeed.action.name}
+  | ${context.import.actions.data.action.name}
+  | ${context.import.actions.dataSeed.action.name}
+
+export type ${context.import.actions.summary.result.name} = {
+  excel: ${context.import.actions.excel.result.name}
+  excelSeed: ${context.import.actions.excelSeed.result.name}
+  data: ${context.import.actions.data.result.name}
+  dataSeed: ${context.import.actions.dataSeed.result.name}
+}
+
+/**
+ * Execute an import from Excel with a full delta detection
+ */
+export type ${context.import.actions.excel.action.name} = { scope: '${context.import.actionScope}'; type: 'excel'; payload: ImportExcelPayload }
+
+/**
+ * Execute an import from Excel during seeding, i.e with delta detection
+ */
+export type ${context.import.actions.excelSeed.action.name} = { scope: '${context.import.actionScope}'; type: 'excelSeed'; payload: ImportExcelPayload }
+
+export const zImportExcelDecoder = z.object({
+  filename: z.string(),
+  data: z.instanceof(Buffer),
+})
+export type ImportExcelPayload = z.infer<typeof zImportExcelDecoder>
+
+export type ${context.import.actions.excel.result.name} = ${detectDelta.allModels.type.name}
+
+export type ${context.import.actions.excelSeed.result.name} = CreatedItemsCount
+
+/**
+ * Imports the provided data, performing a full delta detection.
+ */
+export type ${context.import.actions.data.action.name} = { scope: '${context.import.actionScope}'; type: 'data'; payload: ${decoders.excelDataModel.decodedType.name} }
+
+/**
+ * Imports the provided data without performing a full delta detection.
+ * This is useful for seeding.
+ */
+export type ${context.import.actions.dataSeed.action.name} = { scope: '${context.import.actionScope}'; type: 'dataSeed'; payload: ${decoders.excelDataModel.decodedType.name} }
+
+export type ${context.import.actions.data.result.name} = ${detectDelta.allModels.type.name}
+
+export type ${context.import.actions.dataSeed.result.name} = CreatedItemsCount
+
+type CreatedItemsCount = Partial<Record<keyof BulkMutation, number>>
+
+@Injectable()
+export class ${service.name} {
+  private readonly logger = new Logger(ImportService.name)
+
+  constructor(
+    private readonly data: ${context.repositories.dataService.name},
+    private readonly xlPort: XlPortService,
+  ) {}
+
+  public async dispatch<Action extends ${context.import.actions.summary.action.name}, Result extends ${context.import.actions.summary.result.name}>({
+    action,
+    execution,
+  }: {
+    action: Action
+    execution: ${context.actions.execution.interface.name}
+  }): Promise<Result> {
+    switch (action.type) {
+      case 'excel':
+        return this.excelImport({ action, execution }) as Promise<Result>
+      case 'excelSeed':
+        return this.excelSeedImport({ action, execution }) as Promise<Result>
+      case 'data':
+        return this.dataImport({ action, execution }) as Promise<Result>
+      case 'dataSeed':
+        return this.dataSeedImport({ action, execution }) as Promise<Result>
+      default:
+        throw new ExhaustiveSwitchCheck(action)
+    }
+  }
+
+  private async excelImport({
+    action,
+    execution,
+  }: {
+    action: ${context.import.actions.excel.action.name}
+    execution: ${context.actions.execution.interface.name}
+  }): Promise<${context.import.actions.excel.result.name}> {
+    let deltaResult: ${context.import.actions.excel.result.name}
+    await execution.executeTransformations(
+      [
+        ['readExcel', (input: Buffer) => this.readExcel(input)],
+        ['decodeData', (data: ExcelDataModelFlattened) => ${context.decoders.excelDataModel.decoder.parseFunction.name}(data)],
+        ['detectDelta', (data: DataModel) => ${detectDelta.allModels.name}(this.data, data)],
+        [
+          'convertToBulkMutations',
+          (delta: Delta) => {
+            const steps = ${converterFunctions.deltaToBulkMutations.name}(delta)
+            deltaResult = delta
+            return steps
+          },
+        ],
+        ['bulkUpdate', (steps: BulkMutation[]) => this.data.${context.repositories.dataService.executeBulkMutations}({ steps, execution })],
+      ],
+      action.payload.data,
+    )
+    return deltaResult!
+  }
+
+  private async excelSeedImport({
+    action,
+    execution,
+  }: {
+    action: ${context.import.actions.excelSeed.action.name}
+    execution: ${context.actions.execution.interface.name}
+  }): Promise<${context.import.actions.excelSeed.result.name}> {
+    const result = await execution.executeTransformations(
+      [
+        ['readExcel', (input: Buffer) => this.readExcel(input)],
+        ['decodeData', (data: ExcelDataModelFlattened) => ${context.decoders.excelDataModel.decoder.parseFunction.name}(data)],
+        ['convertToBulkMutations', (data: DataModel) => importedDataToBulkMutations(data)],
+        [
+          'bulkUpdate',
+          async (steps: BulkMutation[]) => {
+            await this.data.${context.repositories.dataService.executeBulkMutations}({ steps, execution })
+            return this.countCreatedItems(steps)
+          },
+        ],
+      ],
+      action.payload.data,
+    )
+    return result
+  }
+
+  private async dataImport({
+    action,
+    execution,
+  }: {
+    action: ${context.import.actions.data.action.name}
+    execution: ${context.actions.execution.interface.name}
+  }): Promise<${context.import.actions.data.result.name}> {
+    let deltaResult: ${context.import.actions.data.result.name}
+    await execution.executeTransformations(
+      [
+        ['detectDelta', (data: DataModel) => ${detectDelta.allModels.name}(this.data, data)],
+        [
+          'convertToBulkMutations',
+          (delta: Delta) => {
+            const steps = ${converterFunctions.deltaToBulkMutations.name}(delta)
+            deltaResult = delta
+            return steps
+          },
+        ],
+        ['bulkUpdate', (steps: BulkMutation[]) => this.data.${context.repositories.dataService.executeBulkMutations}({ steps, execution })],
+      ],
+      action.payload,
+    )
+    return deltaResult!
+  }
+
+  private async dataSeedImport({
+    action,
+    execution,
+  }: {
+    action: ${context.import.actions.dataSeed.action.name}
+    execution: ${context.actions.execution.interface.name}
+  }): Promise<${context.import.actions.dataSeed.result.name}> {
+    const result = await execution.executeTransformations(
+      [
+        ['convertToBulkMutations', (data: DataModel) => importedDataToBulkMutations(data)],
+        [
+          'bulkUpdate',
+          async (steps: BulkMutation[]) => {
+            await this.data.${context.repositories.dataService.executeBulkMutations}({ steps, execution })
+            return this.countCreatedItems(steps)
+          },
+        ],
+      ],
+      action.payload,
+    )
+    return result
+  }
+
+  private async readExcel(data: Buffer): Promise<ExcelDataModelFlattened> {
+    const xlData = await this.xlPort.importFromFile(data)
+
+    if (xlData.status !== 'success') {
+      throw new Error(xlData.message)
+    }
+
+    return removeBlankEntries(xlData.data.tables as unknown as ExcelDataModelFlattened)
+  }
+
+  private countCreatedItems(bulkMutations: BulkMutation[]): CreatedItemsCount {
+    const result: Record<string, number> = {}
+    for (const bulkMutation of bulkMutations) {
+      for (const [model, items] of Object.entries(bulkMutation)) {
+        result[model] = (result[model] ?? 0) + (items.create?.length ?? 0)
+      }
+    }
+    return result
+  }
+}
+  
+
+function removeBlankEntries(data: ExcelDataModelFlattened): ExcelDataModelFlattened {
+  const result: Record<string, unknown[]> = {}
+  for (const [key, modelEntries] of Object.entries(data)) {
+    const modelResult: unknown[] = []
+    for (const item of modelEntries?.values() ?? []) {
+      if (!isBlank(item)) {
+        modelResult.push(item)
+      }
+    }
+    result[key] = modelResult
+  }
+  return result as ExcelDataModelFlattened
+}
+
+function isBlank(value: unknown): boolean {
+  if (value === null || value === undefined) {
+    return true
+  }
+  switch (typeof value) {
+    case 'string':
+    case 'number':
+    case 'boolean':
+      return false
+    case 'object':
+      if (Array.isArray(value)) {
+        return false
+      }
+      for (const values of Object.values(value)) {
+        if (!isBlank(values)) {
+          return false
+        }
+      }
+      return true
+    default:
+      return false
+  }
+}`;
+}
+//# sourceMappingURL=import-service.generator.js.map

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

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

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

@@ -0,0 +1,228 @@
+import * as Generator from '@postxl/generator';
+import { ActionProvider, ActionProviderTypes, ScopeName, WithActions } from '../backend-actions';
+import { WithBackend } from '../backend-core';
+import { WithRepositories } from '../backend-repositories';
+import { WithUpdates } from '../backend-update';
+import { WithBase } from '../base';
+import { WithDecoders } from '../decoders';
+import { WithTypes } from '../types';
+type ContextRequirements = WithDecoders<WithUpdates<WithActions<WithTypes<WithRepositories<WithBackend<WithBase<Generator.Context>>>>>>>;
+export type ContextResult = WithBackendImport<ContextRequirements>;
+export type WithBackendImport<Context> = Generator.ExtendContextAndModel<Context, {
+    import: BackendImportContext;
+}, {
+    import: BackendImportModelContext;
+}>;
+export type ModelResult = Generator.InferModelContext<ContextResult>;
+type ImportActions = {
+    excel: ActionProviderTypes;
+    excelSeed: ActionProviderTypes;
+    data: ActionProviderTypes;
+    dataSeed: ActionProviderTypes;
+};
+export type BackendImportContext = ActionProvider<ImportActions> & {
+    actionScope: ScopeName;
+    detectDelta: {
+        /**
+         * Function that detects the delta for all models.
+         */
+        allModels: Generator.ImportableFunction & {
+            type: Generator.ImportableType;
+            /**
+             * Name of the type that for each model type maps newly provided Ids to the items/models
+             */
+            idMapType: Generator.ImportableType;
+            /**
+             * Function that returns a map of model with their errors
+             */
+            extractErrors: Generator.ImportableFunction;
+            /**
+             * Function that converts the extracted errors into a meaningful error message
+             */
+            summarizeErrors: Generator.ImportableFunction;
+        };
+        /** Shared functions, used by detectDelta model functions */
+        _utils: {
+            detectModelDelta: Generator.ImportableFunction;
+            validation: {
+                params: Generator.ImportableType;
+                referenceField: Generator.ImportableFunction;
+                requiredFields: Generator.ImportableFunction;
+                requiredDependency: Generator.ImportableFunction;
+                uniqueField: Generator.ImportableFunction;
+                int: Generator.ImportableFunction;
+            };
+            getDelta: Generator.ImportableFunction;
+            keepErrors: Generator.ImportableFunction;
+        };
+        types: {
+            generic: {
+                /**
+                 * Generic type that represents the delta of a model.
+                 */
+                modelType: Generator.ImportableType;
+                create: {
+                    /**
+                     * The type that represents the items of a model that should be created.
+                     */
+                    type: Generator.ImportableType;
+                    /**
+                     * The discriminant for the delta of a model that should be created.
+                     */
+                    discriminant: Generator.DiscriminantValue;
+                    /**
+                     * The type guard function that checks if a delta item is a create delta.
+                     */
+                    typeGuard: Generator.ImportableFunction;
+                };
+                update: {
+                    /**
+                     * The type that represents the delta of existing model items that should be updated.
+                     */
+                    type: Generator.ImportableType;
+                    /**
+                     * The discriminant for the delta of existing model items that should be updated.
+                     */
+                    discriminant: Generator.DiscriminantValue;
+                    /**
+                     * The type guard function that checks if a delta item is an update delta.
+                     */
+                    typeGuard: Generator.ImportableFunction;
+                };
+                delete: {
+                    /**
+                     * The type that represents the items of a model that should be deleted.
+                     */
+                    type: Generator.ImportableType;
+                    /**
+                     * The discriminant for the delta of a model that should be deleted.
+                     */
+                    discriminant: Generator.DiscriminantValue;
+                    /**
+                     * The type that represents the items of a model that should be deleted.
+                     */
+                    typeGuard: Generator.ImportableFunction;
+                };
+                unchanged: {
+                    /**
+                     * The type that represents unchanged items of model.
+                     */
+                    type: Generator.ImportableType;
+                    /**
+                     * The discriminant for unchanged items of a model.
+                     */
+                    discriminant: Generator.DiscriminantValue;
+                    /**
+                     * The type that represents unchanged items of a model.
+                     */
+                    typeGuard: Generator.ImportableFunction;
+                };
+                errors: {
+                    /**
+                     * The type that represents the items of a model that contain errors.
+                     */
+                    type: Generator.ImportableType;
+                    /**
+                     * The discriminant for the items of a model that contain errors.
+                     */
+                    discriminant: Generator.DiscriminantValue;
+                    /**
+                     * The type guard function that checks if a delta item is an error.
+                     */
+                    typeGuard: Generator.ImportableFunction;
+                    /**
+                     * Meta data for the model error type for a missing field.
+                     */
+                    missingField: {
+                        /**
+                         * The type that represents the error of missing fields.
+                         */
+                        type: Generator.ImportableType;
+                        /**
+                         * The discriminant for the error of missing fields.
+                         */
+                        discriminant: Generator.DiscriminantValue;
+                    };
+                    /**
+                     * Meta data for the model error type for an invalid reference.
+                     */
+                    invalidReference: {
+                        /**
+                         * The type that represents the error of invalid references.
+                         */
+                        type: Generator.ImportableType;
+                        /**
+                         * The discriminant for the error of invalid references.
+                         */
+                        discriminant: Generator.DiscriminantValue;
+                    };
+                    /**
+                     * Meta data for the model error type for non-unique fields.
+                     */
+                    nonUnique: {
+                        /**
+                         * The type that represents the error of non-unique fields.
+                         */
+                        type: Generator.ImportableType;
+                        /**
+                         * The discriminant for the error of non-unique fields.
+                         */
+                        discriminant: Generator.DiscriminantValue;
+                    };
+                    /**
+                     * Meta data for the model error type for invalid types.
+                     */
+                    invalidType: {
+                        /**
+                         * The type that represents the error of invalid types.
+                         */
+                        type: Generator.ImportableType;
+                        /**
+                         * The discriminant for the error of invalid types.
+                         */
+                        discriminant: Generator.DiscriminantValue;
+                    };
+                    /**
+                     * Meta data for the model error type where the item is a required dependency of another item.
+                     */
+                    isRequiredDependency: {
+                        /**
+                         * The type that represents an item to be deleted that is a required dependency of another item.
+                         */
+                        type: Generator.ImportableType;
+                        /**
+                         * The discriminant for the error of missing required dependencies.
+                         */
+                        discriminant: Generator.DiscriminantValue;
+                    };
+                };
+                /**
+                 * The name presenting modified fields of a model.
+                 */
+                delta_Fields: Generator.ImportableType;
+            };
+        };
+    };
+    /**
+     * Meta data for functions that handle the import of Excel data.
+     */
+    converterFunctions: {
+        /**
+         * Name of the function that convert import data to BulkMutations.
+         */
+        importedDataToBulkMutations: Generator.ImportableFunction;
+        /**
+         * Name of the function that converts a delta to BulkMutations.
+         */
+        deltaToBulkMutations: Generator.ImportableFunction;
+    };
+};
+export type BackendImportModelContext = {
+    delta: {
+        errors: Generator.ImportableType;
+        detect: Generator.ImportableFunction;
+    };
+};
+export declare const generatorId: string & import("zod").BRAND<"PXL.GeneratorInterfaceId">;
+export declare const generator: Generator.GeneratorInterface;
+export {};