@mbc-cqrs-serverless/import 0.1.74-beta.0

package/dist/import.controller.js

@@ -0,0 +1,99 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var ImportController_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportController = void 0;
+const core_1 = require("@mbc-cqrs-serverless/core");
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const create_csv_import_dto_1 = require("./dto/create-csv-import.dto");
+const create_import_dto_1 = require("./dto/create-import.dto");
+const import_service_1 = require("./import.service");
+let ImportController = ImportController_1 = class ImportController {
+    constructor(importService) {
+        this.importService = importService;
+        this.logger = new common_1.Logger(ImportController_1.name);
+    }
+    /**
+     * Endpoint for importing a single data record.
+     * This is typically used for real-time or low-volume data synchronization.
+     * The actual processing is asynchronous; this endpoint only validates the input
+     * and queues the import task.
+     */
+    async createImport(invokeContext, createImportDto) {
+        this.logger.log(`Received single import request for table: ${createImportDto.tableName}`);
+        return this.importService.createWithApi(createImportDto, { invokeContext });
+    }
+    /**
+     * Endpoint for initiating a CSV file import.
+     * This endpoint accepts the location of a CSV file in S3 and allows the client
+     * to specify the processing strategy ('DIRECT' for small files, 'STEP_FUNCTION' for large files).
+     */
+    async createCsvImport(invokeContext, createCsvImportDto) {
+        this.logger.log(`Received CSV import request for key: ${createCsvImportDto.key} with processing mode: ${createCsvImportDto.processingMode}`);
+        // The service contains the routing logic to either process directly
+        // or create the master job for the Step Function.
+        return this.importService.handleCsvImport(createCsvImportDto, {
+            invokeContext,
+        });
+    }
+};
+exports.ImportController = ImportController;
+__decorate([
+    (0, common_1.Post)(),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Create a single import',
+        description: 'Accepts a single data record, validates it using the configured ImportStrategy, and queues it for asynchronous processing.',
+    }),
+    (0, swagger_1.ApiBody)({ type: create_import_dto_1.CreateImportDto }),
+    (0, swagger_1.ApiResponse)({
+        status: 202,
+        description: 'The import task has been accepted and queued for processing.',
+    }),
+    (0, common_1.HttpCode)(common_1.HttpStatus.ACCEPTED),
+    (0, common_1.UsePipes)(new common_1.ValidationPipe({ transform: true, whitelist: true })),
+    __param(0, (0, core_1.INVOKE_CONTEXT)()),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, create_import_dto_1.CreateImportDto]),
+    __metadata("design:returntype", Promise)
+], ImportController.prototype, "createImport", null);
+__decorate([
+    (0, common_1.Post)('csv'),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Initiate a CSV file import',
+        description: 'Accepts the S3 location of a CSV file and an execution strategy. It will either process the file directly or trigger a Step Function workflow.',
+    }),
+    (0, swagger_1.ApiBody)({ type: create_csv_import_dto_1.CreateCsvImportDto }),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: 'For DIRECT mode, returns the created import entities. For STEP_FUNCTION mode, returns the master job entity.',
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 202,
+        description: 'The import task has been accepted and queued for processing (for STEP_FUNCTION mode).',
+    }),
+    (0, common_1.UsePipes)(new common_1.ValidationPipe({ transform: true, whitelist: true })),
+    __param(0, (0, core_1.INVOKE_CONTEXT)()),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, create_csv_import_dto_1.CreateCsvImportDto]),
+    __metadata("design:returntype", Promise)
+], ImportController.prototype, "createCsvImport", null);
+exports.ImportController = ImportController = ImportController_1 = __decorate([
+    (0, swagger_1.ApiTags)('Imports'),
+    (0, common_1.Controller)('imports'),
+    __metadata("design:paramtypes", [import_service_1.ImportService])
+], ImportController);
+//# sourceMappingURL=import.controller.js.map

package/dist/import.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.controller.js","sourceRoot":"","sources":["../src/import.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAmE;AACnE,2CASuB;AACvB,6CAA6E;AAE7E,uEAAgE;AAChE,+DAAyD;AACzD,qDAAgD;AAIzC,IAAM,gBAAgB,wBAAtB,MAAM,gBAAgB;IAG3B,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;QAFxC,WAAM,GAAG,IAAI,eAAM,CAAC,kBAAgB,CAAC,IAAI,CAAC,CAAA;IAEC,CAAC;IAE7D;;;;;OAKG;IAcG,AAAN,KAAK,CAAC,YAAY,CACE,aAAsB,EAChC,eAAgC;QAExC,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,6CAA6C,eAAe,CAAC,SAAS,EAAE,CACzE,CAAA;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,eAAe,EAAE,EAAE,aAAa,EAAE,CAAC,CAAA;IAC7E,CAAC;IAED;;;;OAIG;IAmBG,AAAN,KAAK,CAAC,eAAe,CACD,aAAsB,EAChC,kBAAsC;QAE9C,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,wCAAwC,kBAAkB,CAAC,GAAG,0BAA0B,kBAAkB,CAAC,cAAc,EAAE,CAC5H,CAAA;QACD,oEAAoE;QACpE,kDAAkD;QAClD,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,kBAAkB,EAAE;YAC5D,aAAa;SACd,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAtEY,4CAAgB;AAwBrB;IAbL,IAAA,aAAI,GAAE;IACN,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,wBAAwB;QACjC,WAAW,EACT,4HAA4H;KAC/H,CAAC;IACD,IAAA,iBAAO,EAAC,EAAE,IAAI,EAAE,mCAAe,EAAE,CAAC;IAClC,IAAA,qBAAW,EAAC;QACX,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,8DAA8D;KAC5E,CAAC;IACD,IAAA,iBAAQ,EAAC,mBAAU,CAAC,QAAQ,CAAC;IAC7B,IAAA,iBAAQ,EAAC,IAAI,uBAAc,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhE,WAAA,IAAA,qBAAc,GAAE,CAAA;IAChB,WAAA,IAAA,aAAI,GAAE,CAAA;;6CAAkB,mCAAe;;oDAMzC;AAyBK;IAlBL,IAAA,aAAI,EAAC,KAAK,CAAC;IACX,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,4BAA4B;QACrC,WAAW,EACT,gJAAgJ;KACnJ,CAAC;IACD,IAAA,iBAAO,EAAC,EAAE,IAAI,EAAE,0CAAkB,EAAE,CAAC;IACrC,IAAA,qBAAW,EAAC;QACX,MAAM,EAAE,GAAG;QACX,WAAW,EACT,8GAA8G;KACjH,CAAC;IACD,IAAA,qBAAW,EAAC;QACX,MAAM,EAAE,GAAG;QACX,WAAW,EACT,uFAAuF;KAC1F,CAAC;IACD,IAAA,iBAAQ,EAAC,IAAI,uBAAc,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhE,WAAA,IAAA,qBAAc,GAAE,CAAA;IAChB,WAAA,IAAA,aAAI,GAAE,CAAA;;6CAAqB,0CAAkB;;uDAU/C;2BArEU,gBAAgB;IAF5B,IAAA,iBAAO,EAAC,SAAS,CAAC;IAClB,IAAA,mBAAU,EAAC,SAAS,CAAC;qCAIwB,8BAAa;GAH9C,gBAAgB,CAsE5B"}

package/dist/import.module-definition.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @description Defines the configuration for the dynamic ImportModule using ConfigurableModuleBuilder.
+ */
+import { ModuleMetadata } from '@nestjs/common';
+import { ImportEntityProfile } from './interface';
+export declare const IMPORT_STRATEGY_MAP = "ImportStrategyMapInjectToken";
+export declare const PROCESS_STRATEGY_MAP = "ProcessStrategyMapInjectToken";
+/**
+ * The main options object for the ImportModule's `register` method.
+ */
+export interface ImportModuleOptions {
+    /**
+     * (Required) An array of profiles, where each profile defines the complete
+     * import configuration for a specific entity.
+     */
+    profiles: ImportEntityProfile[];
+    /**
+     * (Optional) An array of modules that export the providers needed by the
+     * classes in the profiles
+     */
+    imports?: ModuleMetadata['imports'];
+    /**
+     * (Optional) Enables the built-in `/import` and `/import/csv` endpoints.
+     */
+    enableController?: boolean;
+}
+export declare const ConfigurableModuleClass: import("@nestjs/common").ConfigurableModuleCls<ImportModuleOptions, "register", "create", {
+    profiles: ImportEntityProfile[];
+}>, MODULE_OPTIONS_TOKEN: string | symbol, OPTIONS_TYPE: ImportModuleOptions & Partial<{
+    profiles: ImportEntityProfile[];
+}>;

package/dist/import.module-definition.js

@@ -0,0 +1,20 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPTIONS_TYPE = exports.MODULE_OPTIONS_TOKEN = exports.ConfigurableModuleClass = exports.PROCESS_STRATEGY_MAP = exports.IMPORT_STRATEGY_MAP = void 0;
+/**
+ * @description Defines the configuration for the dynamic ImportModule using ConfigurableModuleBuilder.
+ */
+const common_1 = require("@nestjs/common");
+// --- Injection Tokens for our internal provider maps ---
+exports.IMPORT_STRATEGY_MAP = 'ImportStrategyMapInjectToken';
+exports.PROCESS_STRATEGY_MAP = 'ProcessStrategyMapInjectToken';
+// --- Configurable Module Setup ---
+_a = new common_1.ConfigurableModuleBuilder()
+    // The module will always be configured with the profiles array.
+    .setExtras({ profiles: [] }, (definition, extras) => ({
+    ...definition,
+    profiles: extras.profiles,
+}))
+    .build(), exports.ConfigurableModuleClass = _a.ConfigurableModuleClass, exports.MODULE_OPTIONS_TOKEN = _a.MODULE_OPTIONS_TOKEN, exports.OPTIONS_TYPE = _a.OPTIONS_TYPE;
+//# sourceMappingURL=import.module-definition.js.map

package/dist/import.module-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.module-definition.js","sourceRoot":"","sources":["../src/import.module-definition.ts"],"names":[],"mappings":";;;;AAAA;;GAEG;AACH,2CAA0E;AAI1E,0DAA0D;AAC7C,QAAA,mBAAmB,GAAG,8BAA8B,CAAA;AACpD,QAAA,oBAAoB,GAAG,+BAA+B,CAAA;AAwBnE,oCAAoC;AACvB,KACX,IAAI,kCAAyB,EAAuB;IAClD,gEAAgE;KAC/D,SAAS,CACR,EAAE,QAAQ,EAAE,EAAE,EAAE,EAChB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACvB,GAAG,UAAU;IACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;CAC1B,CAAC,CACH;KACA,KAAK,EAAE,EAVG,+BAAuB,+BAAE,4BAAoB,4BAAE,oBAAY,mBAU9D"}

package/dist/import.module.d.ts

@@ -0,0 +1,11 @@
+import { DynamicModule } from '@nestjs/common';
+import { ConfigurableModuleClass, OPTIONS_TYPE } from './import.module-definition';
+export declare class ImportModule extends ConfigurableModuleClass {
+    static register(options: typeof OPTIONS_TYPE): DynamicModule;
+    /**
+     * A private helper to create a factory provider for a strategy map.
+     * This factory injects all necessary strategy instances and maps them
+     * to their corresponding tableName from the profiles.
+     */
+    private static createStrategyMapFactory;
+}

package/dist/import.module.js

@@ -0,0 +1,69 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportModule = void 0;
+const core_1 = require("@mbc-cqrs-serverless/core");
+const common_1 = require("@nestjs/common");
+const csv_import_queue_event_handler_1 = require("./event/csv-import.queue.event.handler");
+const csv_import_sfn_event_handler_1 = require("./event/csv-import.sfn.event.handler");
+const import_event_handler_1 = require("./event/import.event.handler");
+const import_queue_event_handler_1 = require("./event/import.queue.event.handler");
+const import_controller_1 = require("./import.controller");
+const import_module_definition_1 = require("./import.module-definition");
+const import_service_1 = require("./import.service");
+let ImportModule = class ImportModule extends import_module_definition_1.ConfigurableModuleClass {
+    static register(options) {
+        const module = super.register(options);
+        const { enableController, profiles, imports } = options;
+        module.imports = [...(module.imports || []), ...(imports || [])];
+        const dynamicProviders = [
+            this.createStrategyMapFactory(import_module_definition_1.IMPORT_STRATEGY_MAP, profiles, (p) => p.importStrategy),
+            this.createStrategyMapFactory(import_module_definition_1.PROCESS_STRATEGY_MAP, profiles, (p) => p.processStrategy),
+        ];
+        module.providers = [...(module.providers || []), ...dynamicProviders];
+        if (enableController) {
+            module.controllers = [...(module.controllers || []), import_controller_1.ImportController];
+        }
+        return module;
+    }
+    /**
+     * A private helper to create a factory provider for a strategy map.
+     * This factory injects all necessary strategy instances and maps them
+     * to their corresponding tableName from the profiles.
+     */
+    static createStrategyMapFactory(provide, profiles, classExtractor) {
+        // Extract the class types to be used as injection tokens
+        const injectionTokens = profiles.map(classExtractor);
+        return {
+            provide,
+            useFactory: (...instances) => {
+                const map = new Map();
+                instances.forEach((instance, index) => {
+                    map.set(profiles[index].tableName, instance);
+                });
+                return map;
+            },
+            inject: injectionTokens,
+        };
+    }
+};
+exports.ImportModule = ImportModule;
+exports.ImportModule = ImportModule = __decorate([
+    (0, common_1.Module)({
+        imports: [core_1.DataStoreModule, core_1.QueueModule],
+        providers: [
+            import_service_1.ImportService,
+            import_event_handler_1.ImportEventHandler,
+            import_queue_event_handler_1.ImportQueueEventHandler,
+            csv_import_queue_event_handler_1.CsvImportQueueEventHandler,
+            csv_import_sfn_event_handler_1.CsvImportSfnEventHandler,
+        ],
+        exports: [import_service_1.ImportService],
+    })
+], ImportModule);
+//# sourceMappingURL=import.module.js.map

package/dist/import.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.module.js","sourceRoot":"","sources":["../src/import.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,oDAAwE;AACxE,2CAAsE;AAEtE,2FAAmF;AACnF,uFAA+E;AAC/E,uEAAiE;AACjE,mFAA4E;AAC5E,2DAAsD;AACtD,yEAKmC;AACnC,qDAAgD;AAgBzC,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,kDAAuB;IACvD,MAAM,CAAC,QAAQ,CAAC,OAA4B;QAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAEtC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;QAEvD,MAAM,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAA;QAEhE,MAAM,gBAAgB,GAAe;YACnC,IAAI,CAAC,wBAAwB,CAC3B,8CAAmB,EACnB,QAAQ,EACR,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CACxB;YACD,IAAI,CAAC,wBAAwB,CAC3B,+CAAoB,EACpB,QAAQ,EACR,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CACzB;SACF,CAAA;QAED,MAAM,CAAC,SAAS,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,GAAG,gBAAgB,CAAC,CAAA;QAErE,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,CAAC,WAAW,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,oCAAgB,CAAC,CAAA;QACxE,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,wBAAwB,CACrC,OAAe,EACf,QAA+B,EAC/B,cAEiE;QAEjE,yDAAyD;QACzD,MAAM,eAAe,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QAEpD,OAAO;YACL,OAAO;YACP,UAAU,EAAE,CACV,GAAG,SAAqE,EACxE,EAAE;gBACF,MAAM,GAAG,GAAG,IAAI,GAAG,EAGhB,CAAA;gBACH,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;oBACpC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;gBAC9C,CAAC,CAAC,CAAA;gBACF,OAAO,GAAG,CAAA;YACZ,CAAC;YACD,MAAM,EAAE,eAAe;SACxB,CAAA;IACH,CAAC;CACF,CAAA;AA9DY,oCAAY;uBAAZ,YAAY;IAXxB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,sBAAe,EAAE,kBAAW,CAAC;QACvC,SAAS,EAAE;YACT,8BAAa;YACb,yCAAkB;YAClB,oDAAuB;YACvB,2DAA0B;YAC1B,uDAAwB;SACzB;QACD,OAAO,EAAE,CAAC,8BAAa,CAAC;KACzB,CAAC;GACW,YAAY,CA8DxB"}

package/dist/import.service.d.ts

@@ -0,0 +1,59 @@
+import { DetailKey, DynamoDbService, ICommandOptions, IInvoke, S3Service, SnsService } from '@mbc-cqrs-serverless/core';
+import { ConfigService } from '@nestjs/config';
+import { CreateCsvImportDto } from './dto/create-csv-import.dto';
+import { CreateImportDto } from './dto/create-import.dto';
+import { ImportEntity } from './entity';
+import { ImportQueueEvent } from './event';
+import { IImportStrategy } from './interface';
+export declare class ImportService {
+    private readonly dynamoDbService;
+    private readonly snsService;
+    private readonly config;
+    private readonly s3Service;
+    private readonly importStrategyMap;
+    private readonly logger;
+    private readonly tableName;
+    private readonly alarmTopicArn;
+    constructor(dynamoDbService: DynamoDbService, snsService: SnsService, config: ConfigService, s3Service: S3Service, importStrategyMap: Map<string, IImportStrategy<any, any>>);
+    /**
+     * Handles a single import request from the API.
+     * It uses the appropriate ImportStrategy to transform and validate the data
+     * before creating a record in the temporary import table.
+     */
+    createWithApi(dto: CreateImportDto, options: ICommandOptions): Promise<ImportEntity>;
+    /**
+     * Main router for handling CSV imports. It delegates to the correct
+     * processing method based on the specified execution strategy.
+     */
+    handleCsvImport(dto: CreateCsvImportDto, options: ICommandOptions): Promise<ImportEntity[] | ImportEntity>;
+    /**
+     * Creates a master job record for a CSV import that will be orchestrated
+     * by a Step Function.
+     */
+    createCsvJob(dto: CreateCsvImportDto, options: {
+        invokeContext: IInvoke;
+    }): Promise<ImportEntity>;
+    /**
+     * Creates a import job record for a single json import
+     */
+    createImport(dto: CreateImportDto, options: ICommandOptions): Promise<ImportEntity>;
+    /**
+     * Handles the 'DIRECT' execution strategy by fetching the CSV from S3
+     * and processing its stream immediately.
+     */
+    private _processCsvDirectly;
+    /**
+     * Centralized logic to process a CSV stream. It reads each row, uses the
+     * appropriate ImportStrategy to transform and validate, and creates a
+     * temporary import record for each valid row.
+     */
+    private _processCsvStream;
+    updateStatus(key: DetailKey, status: string, payload?: {
+        result?: any;
+        error?: any;
+    }, attributes?: {
+        result?: any;
+        error?: any;
+    }, notifyId?: string): Promise<void>;
+    publishAlarm(event: ImportQueueEvent, errorDetails: any): Promise<void>;
+}

package/dist/import.service.js

@@ -0,0 +1,250 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var ImportService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportService = void 0;
+const client_s3_1 = require("@aws-sdk/client-s3");
+const core_1 = require("@mbc-cqrs-serverless/core");
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const csv_parser_1 = __importDefault(require("csv-parser"));
+const stream_1 = require("stream");
+const ulid_1 = require("ulid");
+const entity_1 = require("./entity");
+const enum_1 = require("./enum");
+const import_module_definition_1 = require("./import.module-definition");
+let ImportService = ImportService_1 = class ImportService {
+    constructor(dynamoDbService, snsService, config, s3Service, importStrategyMap) {
+        this.dynamoDbService = dynamoDbService;
+        this.snsService = snsService;
+        this.config = config;
+        this.s3Service = s3Service;
+        this.importStrategyMap = importStrategyMap;
+        this.logger = new common_1.Logger(ImportService_1.name);
+        this.tableName = dynamoDbService.getTableName('import_tmp');
+        this.alarmTopicArn = this.config.get('SNS_ALARM_TOPIC_ARN');
+    }
+    /**
+     * Handles a single import request from the API.
+     * It uses the appropriate ImportStrategy to transform and validate the data
+     * before creating a record in the temporary import table.
+     */
+    async createWithApi(dto, options) {
+        const { tableName, attributes } = dto;
+        const strategy = this.importStrategyMap.get(tableName);
+        if (!strategy) {
+            throw new common_1.BadRequestException(`No import strategy found for table: ${tableName}`);
+        }
+        const transformedData = await strategy.transform(attributes);
+        await strategy.validate(transformedData);
+        return this.createImport({ ...dto, attributes: transformedData }, options);
+    }
+    /**
+     * Main router for handling CSV imports. It delegates to the correct
+     * processing method based on the specified execution strategy.
+     */
+    async handleCsvImport(dto, options) {
+        if (dto.processingMode === 'DIRECT') {
+            return this._processCsvDirectly(dto, options);
+        }
+        else {
+            return this.createCsvJob(dto, options);
+        }
+    }
+    /**
+     * Creates a master job record for a CSV import that will be orchestrated
+     * by a Step Function.
+     */
+    async createCsvJob(dto, options) {
+        const sourceIp = options.invokeContext?.event?.requestContext?.http?.sourceIp;
+        const userContext = (0, core_1.getUserContext)(options.invokeContext);
+        const taskCode = (0, ulid_1.ulid)();
+        const pk = `CSV_IMPORT${core_1.KEY_SEPARATOR}${dto.tenantCode}`;
+        const sk = `${dto.tableName}#${taskCode}`;
+        const item = new entity_1.ImportEntity({
+            id: `${pk}#${sk}`,
+            pk,
+            sk,
+            version: 0,
+            code: taskCode,
+            tenantCode: dto.tenantCode,
+            type: 'CSV_MASTER_JOB',
+            name: `CSV Import: ${dto.key.split('/').pop()}`,
+            status: enum_1.ImportStatusEnum.CREATED,
+            attributes: dto,
+            requestId: options.invokeContext?.context?.awsRequestId,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+            createdBy: userContext.userId,
+            updatedBy: userContext.userId,
+            createdIp: sourceIp,
+            updatedIp: sourceIp,
+        });
+        await this.dynamoDbService.putItem(this.tableName, item);
+        return item;
+    }
+    /**
+     * Creates a import job record for a single json import
+     */
+    async createImport(dto, options) {
+        const sourceIp = options.invokeContext?.event?.requestContext?.http?.sourceIp;
+        const userContext = (0, core_1.getUserContext)(options.invokeContext);
+        const taskCode = (0, ulid_1.ulid)();
+        const pk = `IMPORT${core_1.KEY_SEPARATOR}${dto.tenantCode}`;
+        const sk = `${dto.tableName}#${taskCode}`;
+        const item = {
+            id: `${pk}${core_1.KEY_SEPARATOR}${sk}`,
+            pk,
+            sk,
+            version: 0,
+            code: taskCode,
+            tenantCode: dto.tenantCode,
+            type: dto.tableName,
+            name: dto.name || dto.tableName,
+            status: enum_1.ImportStatusEnum.CREATED,
+            attributes: dto.attributes,
+            requestId: options.invokeContext?.context?.awsRequestId,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+            createdBy: userContext.userId,
+            updatedBy: userContext.userId,
+            createdIp: sourceIp,
+            updatedIp: sourceIp,
+        };
+        await this.dynamoDbService.putItem(this.tableName, item);
+        return new entity_1.ImportEntity(item);
+    }
+    /**
+     * Handles the 'DIRECT' execution strategy by fetching the CSV from S3
+     * and processing its stream immediately.
+     */
+    async _processCsvDirectly(dto, options) {
+        this.logger.log(`Starting DIRECT CSV processing for key: ${dto.key}`);
+        // 1. Fetch the S3 object stream
+        const { Body: s3Stream } = await this.s3Service.client.send(new client_s3_1.GetObjectCommand({
+            Bucket: dto.bucket,
+            Key: dto.key,
+        }));
+        if (!(s3Stream instanceof stream_1.Readable)) {
+            throw new Error('Failed to get a readable stream from S3 object.');
+        }
+        // 2. Pass the stream to the centralized processor
+        return this._processCsvStream(s3Stream, dto, options);
+    }
+    /**
+     * Centralized logic to process a CSV stream. It reads each row, uses the
+     * appropriate ImportStrategy to transform and validate, and creates a
+     * temporary import record for each valid row.
+     */
+    async _processCsvStream(stream, attributes, options) {
+        const strategy = this.importStrategyMap.get(attributes.tableName);
+        if (!strategy) {
+            throw new Error(`No import strategy found for table: ${attributes.tableName}`);
+        }
+        const processingPromises = [];
+        return new Promise((resolve, reject) => {
+            const parser = (0, csv_parser_1.default)({
+                mapHeaders: ({ header }) => header.trim(),
+                mapValues: ({ value }) => value.trim(),
+            });
+            stream
+                .pipe(parser)
+                .on('data', (row) => {
+                const processRow = (async () => {
+                    try {
+                        const transformedData = await strategy.transform(row);
+                        await strategy.validate(transformedData);
+                        const createImportDto = {
+                            tableName: attributes.tableName,
+                            tenantCode: attributes.tenantCode,
+                            attributes: transformedData,
+                        };
+                        // Return the created entity
+                        return await this.createImport(createImportDto, options);
+                    }
+                    catch (error) {
+                        this.logger.warn(`Skipping CSV row due to error: ${error instanceof Error ? error.message : String(error)}`, { row });
+                        return;
+                    }
+                })();
+                processingPromises.push(processRow);
+            })
+                .on('end', async () => {
+                // Wait for all row processing to complete before resolving
+                const results = await Promise.all(processingPromises);
+                const successfulImports = results.filter((result) => !!result);
+                this.logger.log(`Finished CSV stream. Created ${successfulImports.length} import records.`);
+                resolve(successfulImports);
+            })
+                .on('error', (error) => {
+                this.logger.error('Error parsing CSV stream:', error);
+                reject(error);
+            });
+        });
+    }
+    async updateStatus(key, status, payload, attributes, notifyId) {
+        await this.dynamoDbService.updateItem(this.tableName, key, {
+            set: {
+                status,
+                attributes,
+                result: payload?.result || payload?.error,
+            },
+        });
+        // notification via SNS
+        await this.snsService.publish({
+            action: 'import-status',
+            ...key,
+            table: this.tableName,
+            id: notifyId || `${key.pk}#${key.sk}`,
+            tenantCode: key.pk.substring(key.pk.indexOf('#') + 1),
+            content: {
+                status,
+                attributes,
+                result: payload?.result || payload?.error,
+            },
+        });
+    }
+    async publishAlarm(event, errorDetails) {
+        this.logger.debug('event', event);
+        const importKey = event.importEvent.importKey;
+        const tenantCode = importKey.pk.substring(importKey.pk.indexOf(core_1.KEY_SEPARATOR) + 1);
+        const alarm = {
+            action: 'sfn-alarm',
+            id: `${importKey.pk}#${importKey.sk}`,
+            table: this.tableName,
+            pk: importKey.pk,
+            sk: importKey.sk,
+            tenantCode,
+            content: {
+                errorMessage: errorDetails,
+            },
+        };
+        this.logger.error('alarm:::', alarm);
+        await this.snsService.publish(alarm, this.alarmTopicArn);
+    }
+};
+exports.ImportService = ImportService;
+exports.ImportService = ImportService = ImportService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(4, (0, common_1.Inject)(import_module_definition_1.IMPORT_STRATEGY_MAP)),
+    __metadata("design:paramtypes", [core_1.DynamoDbService,
+        core_1.SnsService,
+        config_1.ConfigService,
+        core_1.S3Service,
+        Map])
+], ImportService);
+//# sourceMappingURL=import.service.js.map

package/dist/import.service.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './constant';
+export * from './dto';
+export * from './entity';
+export * from './enum';
+export * from './event';
+export * from './import.controller';
+export * from './import.module';
+export * from './import.module-definition';
+export * from './import.service';
+export * from './interface';

package/dist/index.js

@@ -0,0 +1,27 @@
+"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 __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("./constant"), exports);
+__exportStar(require("./dto"), exports);
+__exportStar(require("./entity"), exports);
+__exportStar(require("./enum"), exports);
+__exportStar(require("./event"), exports);
+__exportStar(require("./import.controller"), exports);
+__exportStar(require("./import.module"), exports);
+__exportStar(require("./import.module-definition"), exports);
+__exportStar(require("./import.service"), exports);
+__exportStar(require("./interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA0B;AAC1B,wCAAqB;AACrB,2CAAwB;AACxB,yCAAsB;AACtB,0CAAuB;AACvB,sDAAmC;AACnC,kDAA+B;AAC/B,6DAA0C;AAC1C,mDAAgC;AAChC,8CAA2B"}

package/dist/interface/csv-mapping-strategy.interface.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Defines the contract for transforming a raw CSV row into a standard
+ * validated attributes DTO for a specific table.
+ */
+export interface ICsvMappingStrategy<TAttributesDto extends object> {
+    /**
+     * Maps a single row from a CSV file to the target attributes DTO.
+     * This method should also perform any necessary validation.
+     * @param csvRow A key-value object representing one row from the CSV file.
+     * @returns A promise that resolves with the strongly-typed attributes DTO.
+     * @throws {BadRequestException} if the row data is invalid.
+     */
+    mapCsvRow(csvRow: Record<string, any>): Promise<TAttributesDto>;
+}

package/dist/interface/csv-mapping-strategy.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=csv-mapping-strategy.interface.js.map

package/dist/interface/csv-mapping-strategy.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-mapping-strategy.interface.js","sourceRoot":"","sources":["../../src/interface/csv-mapping-strategy.interface.ts"],"names":[],"mappings":""}