@into-cps-association/logger-ms 0.1.1

package/dist/src/logs/logs.service.d.ts

@@ -0,0 +1,29 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import Config from '../config/config.service.js';
+import { LogEventDto } from '../dto/log-event.dto.js';
+export default class LogsService implements OnModuleDestroy {
+    private readonly logger;
+    private readonly logFilePath;
+    private readonly maxLogBytes;
+    private readonly retentionFiles;
+    private writeStream;
+    private streamErrorHandler;
+    private writeQueue;
+    private initialized;
+    private initializePromise;
+    private currentLogBytes;
+    constructor(config: Config);
+    appendEvent(event: LogEventDto): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+    private closeWriteStream;
+    private ensureReady;
+    private initialize;
+    private attachStreamErrorHandler;
+    private detachStreamErrorHandler;
+    private handleStreamError;
+    private ensureNewlineAtEnd;
+    private writeLine;
+    private rotateIfNeeded;
+    private rotateLogFiles;
+    private renameIfPresent;
+}

package/dist/src/logs/logs.service.js

@@ -0,0 +1,201 @@
+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 LogsService_1;
+import { createWriteStream, existsSync } from 'node:fs';
+import { appendFile, mkdir, open, rename, rm, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { Injectable, Logger } from '@nestjs/common';
+import Config from '../config/config.service.js';
+function endWriteStream(stream) {
+    return new Promise((resolve, reject) => {
+        stream.end((error) => {
+            if (error !== undefined && error !== null) {
+                reject(error);
+                return;
+            }
+            resolve();
+        });
+    });
+}
+function writeToStream(stream, line) {
+    return new Promise((resolve, reject) => {
+        const onError = (error) => {
+            stream.off('error', onError);
+            reject(error);
+        };
+        stream.on('error', onError);
+        stream.write(line, 'utf8', (error) => {
+            stream.off('error', onError);
+            if (error !== null && error !== undefined) {
+                reject(error);
+                return;
+            }
+            resolve();
+        });
+    });
+}
+let LogsService = LogsService_1 = class LogsService {
+    logger = new Logger(LogsService_1.name);
+    logFilePath;
+    maxLogBytes;
+    retentionFiles;
+    writeStream = null;
+    streamErrorHandler = null;
+    writeQueue = Promise.resolve();
+    initialized = false;
+    initializePromise = null;
+    currentLogBytes = 0;
+    constructor(config) {
+        this.logFilePath = config.getLogFilePath();
+        this.maxLogBytes = config.getLogMaxBytes();
+        this.retentionFiles = config.getLogRetentionFiles();
+    }
+    async appendEvent(event) {
+        await this.ensureReady();
+        const line = `${JSON.stringify(event)}\n`;
+        this.writeQueue = this.writeQueue
+            .catch(() => undefined)
+            .then(() => this.writeLine(line));
+        return this.writeQueue;
+    }
+    async onModuleDestroy() {
+        try {
+            await this.writeQueue;
+        }
+        finally {
+            await this.closeWriteStream();
+        }
+    }
+    async closeWriteStream() {
+        const stream = this.writeStream;
+        if (stream !== null) {
+            this.detachStreamErrorHandler(stream);
+            await endWriteStream(stream);
+            this.writeStream = null;
+        }
+        this.initialized = false;
+        this.currentLogBytes = 0;
+    }
+    async ensureReady() {
+        if (this.initialized) {
+            return;
+        }
+        if (this.initializePromise !== null) {
+            return this.initializePromise;
+        }
+        this.initializePromise = this.initialize();
+        try {
+            await this.initializePromise;
+        }
+        finally {
+            this.initializePromise = null;
+        }
+    }
+    async initialize() {
+        await mkdir(path.dirname(this.logFilePath), { recursive: true });
+        this.currentLogBytes = await this.ensureNewlineAtEnd();
+        this.writeStream = createWriteStream(this.logFilePath, {
+            flags: 'a',
+            encoding: 'utf8',
+            mode: 0o600,
+        });
+        this.attachStreamErrorHandler(this.writeStream);
+        this.initialized = true;
+    }
+    attachStreamErrorHandler(stream) {
+        const handler = (error) => this.handleStreamError(error, stream);
+        stream.on('error', handler);
+        this.streamErrorHandler = handler;
+    }
+    detachStreamErrorHandler(stream) {
+        if (this.streamErrorHandler === null)
+            return;
+        stream.off('error', this.streamErrorHandler);
+        this.streamErrorHandler = null;
+    }
+    handleStreamError(error, stream) {
+        this.logger.error('Workflow log stream failed', error.stack);
+        if (this.writeStream !== stream)
+            return;
+        this.detachStreamErrorHandler(stream);
+        this.writeStream = null;
+        this.initialized = false;
+        stream.destroy();
+    }
+    async ensureNewlineAtEnd() {
+        if (!existsSync(this.logFilePath)) {
+            return 0;
+        }
+        const fileStat = await stat(this.logFilePath);
+        if (fileStat.size === 0) {
+            return 0;
+        }
+        const handle = await open(this.logFilePath, 'r');
+        const buffer = Buffer.alloc(1);
+        try {
+            await handle.read(buffer, 0, 1, fileStat.size - 1);
+        }
+        finally {
+            await handle.close();
+        }
+        if (buffer[0] !== 0x0a) {
+            await appendFile(this.logFilePath, '\n', 'utf8');
+            return fileStat.size + 1;
+        }
+        return fileStat.size;
+    }
+    async writeLine(line) {
+        const lineBytes = Buffer.byteLength(line, 'utf8');
+        await this.rotateIfNeeded(lineBytes);
+        if (this.writeStream === null) {
+            return Promise.reject(new Error('Logger write stream is not initialized'));
+        }
+        const stream = this.writeStream;
+        try {
+            await writeToStream(stream, line);
+            this.currentLogBytes += lineBytes;
+        }
+        catch (error) {
+            this.handleStreamError(error, stream);
+            throw error;
+        }
+    }
+    async rotateIfNeeded(incomingBytes) {
+        if (this.currentLogBytes + incomingBytes <= this.maxLogBytes)
+            return;
+        await this.closeWriteStream();
+        await this.rotateLogFiles();
+        await this.initialize();
+    }
+    async rotateLogFiles() {
+        for (let index = this.retentionFiles - 1; index >= 1; index -= 1) {
+            const source = `${this.logFilePath}.${index}`;
+            const target = `${this.logFilePath}.${index + 1}`;
+            await rm(target, { force: true });
+            await this.renameIfPresent(source, target);
+        }
+        await this.renameIfPresent(this.logFilePath, `${this.logFilePath}.1`);
+    }
+    async renameIfPresent(source, target) {
+        try {
+            await rename(source, target);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+    }
+};
+LogsService = LogsService_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [Config])
+], LogsService);
+export default LogsService;
+//# sourceMappingURL=logs.service.js.map

package/dist/src/logs/logs.service.js.map

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

package/dist/src/main.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { INestApplication, NestApplicationOptions } from '@nestjs/common';
+import { json } from 'express';
+import Config from './config/config.service.js';
+type BodyParserApp = {
+    use: (middleware: ReturnType<typeof json>) => void;
+};
+type LoggerAppOptions = Omit<NestApplicationOptions, 'bodyParser'>;
+export declare function registerBodyParser(app: BodyParserApp, config: Config): void;
+export declare function configureLoggerApp(app: INestApplication, config: Config): void;
+export declare function createLoggerApp(config: Config, options?: LoggerAppOptions): Promise<INestApplication>;
+export {};

package/dist/src/main.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import { NestFactory } from '@nestjs/core';
+import { json } from 'express';
+import { readFile } from 'node:fs/promises';
+import { pathToFileURL } from 'node:url';
+import AppModule from './app.module.js';
+import Config from './config/config.service.js';
+import resolveConfigPath from './config/cli.js';
+import { ensureCertificates } from './config/certificates.js';
+import { buildCorsOptions } from './config/cors.js';
+export function registerBodyParser(app, config) {
+    app.use(json({
+        limit: `${config.getMaxPayloadBytes()}b`,
+        type: ['application/json', 'text/plain'],
+    }));
+}
+export function configureLoggerApp(app, config) {
+    app.enableCors(buildCorsOptions(config.getCorsAllowOrigin(), config.getCorsAllowCredentials()));
+    registerBodyParser(app, config);
+}
+export async function createLoggerApp(config, options = {}) {
+    const app = await NestFactory.create(AppModule, {
+        ...options,
+        bodyParser: false,
+    });
+    configureLoggerApp(app, config);
+    return app;
+}
+async function buildHttpsOptions(config) {
+    if (!config.getTls())
+        return undefined;
+    const certPaths = await ensureCertificates(config.getCertsDirectory());
+    return {
+        cert: await readFile(certPaths.certFile),
+        key: await readFile(certPaths.keyFile),
+    };
+}
+function isEntrypoint() {
+    const entrypoint = process.argv[1];
+    return (entrypoint !== undefined &&
+        import.meta.url === pathToFileURL(entrypoint).href);
+}
+async function bootstrap() {
+    const configPath = resolveConfigPath(process.argv);
+    if (configPath !== undefined) {
+        process.env.LOGGER_CONFIG_PATH = configPath;
+    }
+    const startupConfig = new Config();
+    startupConfig.loadConfig(configPath);
+    const httpsOptions = await buildHttpsOptions(startupConfig);
+    const app = await createLoggerApp(startupConfig, {
+        httpsOptions,
+    });
+    await app.listen(startupConfig.getPort(), startupConfig.getHostname());
+}
+if (isEntrypoint()) {
+    await bootstrap();
+}
+//# sourceMappingURL=main.js.map

package/dist/src/main.js.map

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

package/dist/src/socket-address-throttler.guard.d.ts

@@ -0,0 +1,12 @@
+import { ThrottlerGuard } from '@nestjs/throttler';
+type SocketAddressRequest = {
+    [key: string]: unknown;
+    socket?: {
+        remoteAddress?: string;
+    };
+};
+export declare function getSocketTracker(req: SocketAddressRequest): string;
+export default class SocketAddressThrottlerGuard extends ThrottlerGuard {
+    protected getTracker(req: Record<string, any>): Promise<string>;
+}
+export {};

package/dist/src/socket-address-throttler.guard.js

@@ -0,0 +1,10 @@
+import { ThrottlerGuard } from '@nestjs/throttler';
+export function getSocketTracker(req) {
+    return req.socket?.remoteAddress ?? 'unknown';
+}
+export default class SocketAddressThrottlerGuard extends ThrottlerGuard {
+    async getTracker(req) {
+        return getSocketTracker(req);
+    }
+}
+//# sourceMappingURL=socket-address-throttler.guard.js.map

package/dist/src/socket-address-throttler.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-address-throttler.guard.js","sourceRoot":"","sources":["../../src/socket-address-throttler.guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASnD,MAAM,UAAU,gBAAgB,CAAC,GAAyB;IACxD,OAAO,GAAG,CAAC,MAAM,EAAE,aAAa,IAAI,SAAS,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,cAAc;IAC3D,KAAK,CAAC,UAAU,CAAC,GAAwB;QACjD,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/src/validation.pipe.d.ts

@@ -0,0 +1,8 @@
+import { PipeTransform } from '@nestjs/common';
+import { ZodType } from 'zod';
+import { LogEventDto } from './dto/log-event.dto.js';
+export default class ZodValidationPipe implements PipeTransform {
+    private readonly schema;
+    constructor(schema: ZodType<LogEventDto>);
+    transform(value: unknown): LogEventDto;
+}

package/dist/src/validation.pipe.js

@@ -0,0 +1,20 @@
+import { BadRequestException } from '@nestjs/common';
+export default class ZodValidationPipe {
+    schema;
+    constructor(schema) {
+        this.schema = schema;
+    }
+    transform(value) {
+        try {
+            const parsedValue = this.schema.parse(value);
+            return parsedValue;
+        }
+        catch (error) {
+            throw new BadRequestException('Validation Failed', {
+                cause: error,
+                description: 'Bad Request',
+            });
+        }
+    }
+}
+//# sourceMappingURL=validation.pipe.js.map

package/dist/src/validation.pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.pipe.js","sourceRoot":"","sources":["../../src/validation.pipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIpE,MAAM,CAAC,OAAO,OAAO,iBAAiB;IAEP;IAA7B,YAA6B,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;IAE7D,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC;YACH,MAAM,WAAW,GAAgB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1D,OAAO,WAAW,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,mBAAmB,CAAC,mBAAmB,EAAE;gBACjD,KAAK,EAAE,KAAK;gBAGZ,WAAW,EAAE,aAAa;aAC3B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/test/e2e/app.e2e.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/e2e/app.e2e.spec.js

@@ -0,0 +1,276 @@
+import { describe, it, expect, beforeAll, afterAll } from '@jest/globals';
+import { HttpStatus } from '@nestjs/common';
+import supertest from 'supertest';
+import { mkdtemp, readFile, rm } from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import Config from 'src/config/config.service';
+import { createLoggerApp } from 'src/main';
+const VALID_PAYLOAD_FIXTURES = [
+    'sample.json',
+    'valid-1.json',
+    'valid-2.json',
+    'valid-3.json',
+    'valid-4.json',
+    'valid-5.json',
+    'valid-6.json',
+];
+const INVALID_PAYLOAD_FIXTURES = [
+    'invalid-1.json',
+    'invalid-2.json',
+    'invalid-3.json',
+    'invalid-4.json',
+    'invalid-5.json',
+];
+async function readPayloadFixture(fileName) {
+    const fixturePath = path.resolve(process.cwd(), 'api', fileName);
+    const payload = await readFile(fixturePath, 'utf8');
+    return JSON.parse(payload);
+}
+async function createTestApp() {
+    const app = await createLoggerApp(new Config(), { logger: false });
+    await app.init();
+    return app;
+}
+describe('Logger service e2e', () => {
+    let app;
+    let logFilePath = '';
+    let tempDir = '';
+    beforeAll(async () => {
+        tempDir = await mkdtemp(path.join(os.tmpdir(), 'dtaas-logger-e2e-'));
+        logFilePath = path.join(tempDir, 'events.jsonl');
+        process.env.LOGGER_CONFIG_PATH = '';
+        process.env.LOGGER_TLS = 'false';
+        process.env.LOGGER_CERTS_DIR = '';
+        process.env.LOGGER_CORS_ALLOW_ORIGIN = '*';
+        process.env.LOGGER_LOG_FILE_PATH = logFilePath;
+        process.env.LOGGER_MAX_PAYLOAD_BYTES = '65536';
+        delete process.env.LOGGER_CORS_ALLOW_CREDENTIALS;
+        delete process.env.LOGGER_AUTH_TOKEN;
+        app = await createTestApp();
+    });
+    afterAll(async () => {
+        await app.close();
+        delete process.env.LOGGER_CONFIG_PATH;
+        delete process.env.LOGGER_TLS;
+        delete process.env.LOGGER_CERTS_DIR;
+        delete process.env.LOGGER_CORS_ALLOW_ORIGIN;
+        delete process.env.LOGGER_CORS_ALLOW_CREDENTIALS;
+        delete process.env.LOGGER_LOG_FILE_PATH;
+        delete process.env.LOGGER_MAX_PAYLOAD_BYTES;
+        delete process.env.LOGGER_AUTH_TOKEN;
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    it('GET /logger/health returns ok', async () => {
+        await supertest(app.getHttpServer())
+            .get('/logger/health')
+            .expect(HttpStatus.OK)
+            .expect({ status: 'ok' });
+    });
+    it('POST /logger persists valid payload fixtures from api/', async () => {
+        const sentPayloads = [];
+        for (const fileName of VALID_PAYLOAD_FIXTURES) {
+            const payload = await readPayloadFixture(fileName);
+            sentPayloads.push(payload);
+            await supertest(app.getHttpServer())
+                .post('/logger')
+                .send(payload)
+                .set('Content-Type', 'application/json')
+                .expect(HttpStatus.NO_CONTENT);
+        }
+        const content = await readFile(logFilePath, 'utf8');
+        const lines = content.trim().split('\n');
+        expect(lines).toHaveLength(VALID_PAYLOAD_FIXTURES.length);
+        for (let index = 0; index < lines.length; index += 1) {
+            expect(JSON.parse(lines[index])).toEqual(sentPayloads[index]);
+        }
+    });
+    it('POST /logger rejects invalid payload fixtures from api/', async () => {
+        for (const fileName of INVALID_PAYLOAD_FIXTURES) {
+            const payload = await readPayloadFixture(fileName);
+            const response = await supertest(app.getHttpServer())
+                .post('/logger')
+                .send(payload)
+                .set('Content-Type', 'application/json');
+            expect(response.status).toBe(HttpStatus.BAD_REQUEST);
+            expect(response.body).toEqual({
+                message: 'Validation Failed',
+                error: 'Bad Request',
+                statusCode: 400,
+            });
+        }
+    });
+    it('OPTIONS /logger excludes credentials by default', async () => {
+        const response = await supertest(app.getHttpServer())
+            .options('/logger')
+            .set('Origin', 'http://localhost:3000')
+            .set('Access-Control-Request-Method', 'POST');
+        expect(response.status).toBe(HttpStatus.NO_CONTENT);
+        expect(response.headers['access-control-allow-origin']).toBe('http://localhost:3000');
+        expect(response.headers['access-control-allow-credentials']).toBeUndefined();
+    });
+});
+describe('Logger service e2e with auth token configured', () => {
+    let app;
+    let tempDir = '';
+    beforeAll(async () => {
+        tempDir = await mkdtemp(path.join(os.tmpdir(), 'dtaas-logger-e2e-auth-'));
+        process.env.LOGGER_CONFIG_PATH = '';
+        process.env.LOGGER_TLS = 'false';
+        process.env.LOGGER_CERTS_DIR = '';
+        process.env.LOGGER_CORS_ALLOW_ORIGIN = '*';
+        process.env.LOGGER_LOG_FILE_PATH = path.join(tempDir, 'events.jsonl');
+        process.env.LOGGER_MAX_PAYLOAD_BYTES = '65536';
+        delete process.env.LOGGER_CORS_ALLOW_CREDENTIALS;
+        process.env.LOGGER_AUTH_TOKEN = 'test-secret-token';
+        app = await createTestApp();
+    });
+    afterAll(async () => {
+        await app.close();
+        delete process.env.LOGGER_CONFIG_PATH;
+        delete process.env.LOGGER_TLS;
+        delete process.env.LOGGER_CERTS_DIR;
+        delete process.env.LOGGER_CORS_ALLOW_ORIGIN;
+        delete process.env.LOGGER_CORS_ALLOW_CREDENTIALS;
+        delete process.env.LOGGER_LOG_FILE_PATH;
+        delete process.env.LOGGER_MAX_PAYLOAD_BYTES;
+        delete process.env.LOGGER_AUTH_TOKEN;
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    it('rejects POST /logger without a bearer token', async () => {
+        const payload = await readPayloadFixture('sample.json');
+        const response = await supertest(app.getHttpServer())
+            .post('/logger')
+            .send(payload)
+            .set('Content-Type', 'application/json');
+        expect(response.status).toBe(HttpStatus.UNAUTHORIZED);
+    });
+    it('rejects POST /logger with the wrong bearer token', async () => {
+        const payload = await readPayloadFixture('sample.json');
+        const response = await supertest(app.getHttpServer())
+            .post('/logger')
+            .send(payload)
+            .set('Content-Type', 'application/json')
+            .set('Authorization', 'Bearer wrong-token');
+        expect(response.status).toBe(HttpStatus.UNAUTHORIZED);
+    });
+    it('accepts POST /logger with the configured bearer token', async () => {
+        const payload = await readPayloadFixture('sample.json');
+        const response = await supertest(app.getHttpServer())
+            .post('/logger')
+            .send(payload)
+            .set('Content-Type', 'application/json')
+            .set('Authorization', 'Bearer test-secret-token');
+        expect(response.status).toBe(HttpStatus.NO_CONTENT);
+    });
+    it('GET /logger/health does not require a bearer token', async () => {
+        await supertest(app.getHttpServer())
+            .get('/logger/health')
+            .expect(HttpStatus.OK);
+    });
+});
+describe('Logger service e2e with a configured throttle', () => {
+    let app;
+    let tempDir = '';
+    beforeAll(async () => {
+        tempDir = await mkdtemp(path.join(os.tmpdir(), 'dtaas-logger-e2e-limit-'));
+        process.env.LOGGER_CONFIG_PATH = '';
+        process.env.LOGGER_TLS = 'false';
+        process.env.LOGGER_CERTS_DIR = '';
+        process.env.LOGGER_CORS_ALLOW_ORIGIN = '*';
+        process.env.LOGGER_LOG_FILE_PATH = path.join(tempDir, 'events.jsonl');
+        process.env.LOGGER_MAX_PAYLOAD_BYTES = '65536';
+        process.env.LOGGER_THROTTLE_TTL = '60000';
+        process.env.LOGGER_THROTTLE_LIMIT = '1';
+        delete process.env.LOGGER_CORS_ALLOW_CREDENTIALS;
+        delete process.env.LOGGER_AUTH_TOKEN;
+        app = await createTestApp();
+    });
+    afterAll(async () => {
+        await app.close();
+        delete process.env.LOGGER_CONFIG_PATH;
+        delete process.env.LOGGER_TLS;
+        delete process.env.LOGGER_CERTS_DIR;
+        delete process.env.LOGGER_CORS_ALLOW_ORIGIN;
+        delete process.env.LOGGER_LOG_FILE_PATH;
+        delete process.env.LOGGER_MAX_PAYLOAD_BYTES;
+        delete process.env.LOGGER_THROTTLE_TTL;
+        delete process.env.LOGGER_THROTTLE_LIMIT;
+        delete process.env.LOGGER_CORS_ALLOW_CREDENTIALS;
+        delete process.env.LOGGER_AUTH_TOKEN;
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    it('keeps health available after logger ingest is throttled', async () => {
+        const payload = await readPayloadFixture('sample.json');
+        await supertest(app.getHttpServer())
+            .post('/logger')
+            .send(payload)
+            .expect(HttpStatus.NO_CONTENT);
+        await supertest(app.getHttpServer())
+            .post('/logger')
+            .send(payload)
+            .expect(HttpStatus.TOO_MANY_REQUESTS);
+        await supertest(app.getHttpServer())
+            .get('/logger/health')
+            .expect(HttpStatus.OK)
+            .expect({ status: 'ok' });
+    });
+});
+describe('Logger service e2e with production body-parser config', () => {
+    let app;
+    let logFilePath = '';
+    let tempDir = '';
+    beforeAll(async () => {
+        tempDir = await mkdtemp(path.join(os.tmpdir(), 'dtaas-logger-e2e-textplain-'));
+        logFilePath = path.join(tempDir, 'events.jsonl');
+        process.env.LOGGER_CONFIG_PATH = '';
+        process.env.LOGGER_TLS = 'false';
+        process.env.LOGGER_CERTS_DIR = '';
+        process.env.LOGGER_CORS_ALLOW_ORIGIN = '*';
+        process.env.LOGGER_LOG_FILE_PATH = logFilePath;
+        process.env.LOGGER_MAX_PAYLOAD_BYTES = '65536';
+        delete process.env.LOGGER_CORS_ALLOW_CREDENTIALS;
+        delete process.env.LOGGER_AUTH_TOKEN;
+        app = await createTestApp();
+    });
+    afterAll(async () => {
+        await app.close();
+        delete process.env.LOGGER_CONFIG_PATH;
+        delete process.env.LOGGER_TLS;
+        delete process.env.LOGGER_CERTS_DIR;
+        delete process.env.LOGGER_CORS_ALLOW_ORIGIN;
+        delete process.env.LOGGER_CORS_ALLOW_CREDENTIALS;
+        delete process.env.LOGGER_LOG_FILE_PATH;
+        delete process.env.LOGGER_MAX_PAYLOAD_BYTES;
+        delete process.env.LOGGER_AUTH_TOKEN;
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    it('accepts a JSON body sent with Content-Type: text/plain, as navigator.sendBeacon sends it', async () => {
+        const payload = await readPayloadFixture('sample.json');
+        const response = await supertest(app.getHttpServer())
+            .post('/logger')
+            .send(JSON.stringify(payload))
+            .set('Content-Type', 'text/plain;charset=UTF-8');
+        expect(response.status).toBe(HttpStatus.NO_CONTENT);
+        const content = await readFile(logFilePath, 'utf8');
+        expect(JSON.parse(content.trim())).toEqual(payload);
+    });
+    it.each([
+        ['application/json', (payload) => payload],
+        [
+            'text/plain;charset=UTF-8',
+            (payload) => JSON.stringify(payload),
+        ],
+    ])('rejects oversized %s payloads', async (contentType, body) => {
+        const payload = {
+            ...(await readPayloadFixture('sample.json')),
+            context: { padding: 'x'.repeat(80 * 1024) },
+        };
+        const response = await supertest(app.getHttpServer())
+            .post('/logger')
+            .send(body(payload))
+            .set('Content-Type', contentType);
+        expect(response.status).toBe(HttpStatus.PAYLOAD_TOO_LARGE);
+    });
+});
+//# sourceMappingURL=app.e2e.spec.js.map