Update NATS connection to handle using a KV store to track last update

Switch Dockerfile to use absolute paths

Dockerfile

@@ -20,7 +20,7 @@ WORKDIR /app
 COPY package*.json ./
 RUN npm ci --omit=dev
 
-COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/dist /app/dist
 
 USER node
 

src/config.ts

@@ -1,6 +1,6 @@
 import { readFileSync, existsSync } from "node:fs"
 import { join } from "node:path"
-import { log } from "./logger";
+import { log } from "./logger.js";
 
 interface Config {
     Mq: Mq,

src/database.ts

@@ -1,62 +0,0 @@
-// Functions to check the current applied version
-// updating will be handled by the processing service
-
-import { MongoClient } from "mongodb";
-import { log } from "./logger";
-import type { Mongo } from "./config";
-
-const collection = "data_ingress_meta";
-
-
-function uriBuild(cfg: Mongo): string {
-if(!cfg.MONGO_URI || !cfg.MONGO_DB || !cfg.MONGO_USER || !cfg.MONGO_PASS) {
-    log('ERROR', "Missing MONGO Configuration - EXIT CODE: 35");
-    process.exit(35);
-} else {
-    log("DEBUG", `MongoDB Connection`, {
-        uri: cfg.MONGO_URI,
-        db: cfg.MONGO_DB,
-        collection: collection,
-        user: cfg.MONGO_USER,
-        pass: "****",
-    });
-};
-
-return `mongodb://${encodeURIComponent(cfg.MONGO_USER)}:${encodeURIComponent(cfg.MONGO_PASS)}@${cfg.MONGO_URI}`
-}
-
-let mongoClient: MongoClient | null = null;
-
-async function getMongoClient(cfg: Mongo) {
-    if (mongoClient) return mongoClient;
-
-    mongoClient = new MongoClient(uriBuild(cfg));
-    await mongoClient.connect();
-    return mongoClient;
-}
-
-export async function isPackageProcessed(cfg: Mongo, serviceName: string, packageName: string): Promise<boolean> {
-    try {
-        const client = await getMongoClient(cfg);
-        const database = client.db(cfg.MONGO_DB);
-        const coll = database.collection(collection);
-
-        const result = await coll.findOne({ service_name: serviceName });
-
-        if (!result) {
-            log('INFO', `No metadata found for ${serviceName}.  Fetching PIS Data`);
-            return false;
-        }
-
-        if (result.latest_package === packageName) {
-            log('INFO', 'No update needed');
-            return true;
-        }
-
-        log('INFO', `Version mismatch.  DB: ${result.latest_package}, Current: ${packageName}.  Update required`)
-        return false;
-    } catch (err) {
-        log('ERROR', 'Failed to check Mongo for version state:', err);
-        process.exit(1);
-    }
-}

src/index.ts

@@ -4,31 +4,55 @@ import { processAndStore } from './sss.js'
 
 import { getLatestPackageName, getRequestStream } from './sources/gitea.js'
 import { processPisStream } from './process.js'
-import { isPackageProcessed } from './database.js'
 import { ConfigLoader } from './config.js'
-import { sendFileUpdateMessage } from './nats.js'
+import { natsManager } from './nats.js'
+
+async function exit(exitCode: string | number=0): Promise<void> {
+    log("INFO", `Exiting with code: ${exitCode}`);
+    
+    try {
+        await natsManager.close();
+    } catch (err) {
+        log("ERROR", `Error during cleanup: ${err}`);
+        process.exit(1)
+    }
+
+    process.exit(exitCode);
+}
 
 async function main() {
     const SERVICE_NAME = process.env.SERVICE_NAME;
     if (!SERVICE_NAME) {
         log('ERROR', "SERVICE_NAME env variable must be set");
-        process.exit(1);
+        process.exitCode = 1;
+        return;
     }
 
+    const CURRENT_VERSION_KEY: string = `${SERVICE_NAME}-current-version`;
+
     const config = ConfigLoader();
 
+    try {
+        log('INFO', `Initialising NATS`);
+        await natsManager.connect(config.Mq);
+    } catch (err) {
+        log('ERROR', `Unable to connect to NATS: ${err}`);
+    }
+
     try {
         const packageInfo = await getLatestPackageName();
         log('INFO', `Latest PIS Package: ${packageInfo.name}`);
 
         if (!packageInfo.assets[0]?.browser_download_url) {
             log('ERROR', `No attachments found for release ${packageInfo.name}`);
-            process.exit(9);
+            process.exitCode = 1;
+            return;
         }
 
-        if (await isPackageProcessed(config.Mongo, SERVICE_NAME, packageInfo.name)) {
-            log('INFO', `Database matches latest release.  Exiting`);
-            process.exit(0);
+        const lastAppliedVersion: string | null = await natsManager.getState(CURRENT_VERSION_KEY);
+        if (lastAppliedVersion === packageInfo.name) {
+            log('INFO', "No new data, exiting");
+            return;
         }
 
         const inputStream: Readable = await getRequestStream(packageInfo.assets[0].browser_download_url);
@@ -42,12 +66,13 @@ async function main() {
         log('DEBUG', 'Done');
 
         log('DEBUG', "Sending message to NATS");
-        sendFileUpdateMessage(config.Mq, filename, packageInfo.name, SERVICE_NAME);
-        log('DEBUG', "Done, exiting")
-        return
+        await natsManager.sendFileUpdateMessage(filename, packageInfo.name, SERVICE_NAME);
+        await natsManager.setState(CURRENT_VERSION_KEY, packageInfo.name);
     } catch (err) {
         log('ERROR', 'Fatal error in pipeline: ', err);
-        process.exit(7);
+        process.exitCode = 1;
+    } finally {
+        await exit(process.exitCode || 0);
     }
 }
 

src/nats.ts

@@ -1,60 +1,132 @@
-import { connect, JSONCodec } from "nats";
-import type { ConnectionOptions, NatsConnection, Payload } from "nats";
-import { log } from "./logger";
+import { connect, JSONCodec, StringCodec } from "nats";
+import type { ConnectionOptions, NatsConnection, JetStreamClient, KV } from "nats";
+import { log } from "./logger.js";
 import { hostname } from "node:os";
 import type { MQFileUpdate } from "@owlboard/backend-data-contracts/dist/data-ingress_mq-file-update";
-import type { Mq } from "./config";
+import type { Mq } from "./config.js";
 
 const jc = JSONCodec();
+const sc = StringCodec();
 
-async function getNatsConnection(cfg: Mq): Promise<NatsConnection> {
-    const options: ConnectionOptions = {
-        servers: cfg.MQ_URL,
-        name: hostname(),
-        reconnect: true,
-        maxReconnectAttempts: -1,
-    };
+class NatsManager {
+    private nc: NatsConnection | null = null;
+    private js: JetStreamClient | null = null;
+    private kv: KV | null = null;
+    private bucketName = "INGRESS_STATES";
 
-    if (cfg.MQ_USER && cfg.MQ_PASS) {
-        options.user = cfg.MQ_USER;
-        options.pass = cfg.MQ_PASS;
-        log("INFO", "NATS: Using username/password authentication");
-    } else {
-        log("INFO", "NATS: Connecting without authentication");
+    /**
+     * Opens connection to NATS
+     */
+    async connect(cfg: Mq): Promise<void> {
+        if (this.nc) return;
+
+        const options: ConnectionOptions = {
+            servers: cfg.MQ_URL,
+            name: hostname(),
+            reconnect: true,
+            maxReconnectAttempts: -1,
+            waitOnFirstConnect: true,
+        };
+
+        if (cfg.MQ_USER && cfg.MQ_PASS) {
+            options.user = cfg.MQ_USER;
+            options.pass = cfg.MQ_PASS;
+            log("INFO", "NATS: Using auth credentials");
+        }
+
+        try {
+            this.nc = await connect(options);
+            this.js = this.nc.jetstream();
+            log("INFO", `NATS: Connected to ${cfg.MQ_URL}`);
+
+            // Handle connection close events
+            this.nc.closed().then((err) => {
+                log("ERROR", `NATS: Connection closed: ${err}`);
+                this.nc = null;
+                this.js = null;
+                this.kv = null;
+            });
+        } catch (err) {
+            log("ERROR", `NATS: Initial connection failed: ${err}`);
+            throw err;
+        }
     }
 
-    return await connect(options)
-}
-
-// Send Message Function here to send the message to NATS
-export async function sendFileUpdateMessage(cfg: Mq, path: string, version: string, serviceName: string): Promise<boolean> {
-    const serviceId: string = hostname();
-    const message: MQFileUpdate = {
-        service_name: serviceName,
-        service_id: serviceId,
-        sent_timestamp: Math.floor(Date.now() / 1000),
-        data_type: "file",
-        data_kind: "pis",
-        payload: {
-            version: version,
-            filepath: path,
+    /**
+     * Accessor for the KV store
+     */
+    private async getKV(): Promise<KV> {
+        if (!this.js) throw new Error("NATS: JetStream not initialized. Call connect() first.");
+        if (!this.kv) {
+            this.kv = await this.js.views.kv(this.bucketName);
         }
-    };
-    
-    let nats: NatsConnection | undefined;
+        return this.kv;
+    }
 
-    try {
-        const nats: NatsConnection = await getNatsConnection(cfg);
+    /**
+     * Get the last recorded state/hash for a service
+     */
+    async getState(key: string): Promise<string | null> {
+        try {
+            const store = await this.getKV();
+            const entry = await store.get(key);
+            return entry ? sc.decode(entry.value) : null;
+        } catch (err) {
+            log("ERROR", `NATS: KV Get failed for ${key}: ${err}`);
+            return null;
+        }
+    }
+
+    /**
+     * Set the current state/hash for a service
+     */
+    async setState(key: string, value: string): Promise<void> {
+        try {
+            const store = await this.getKV();
+            await store.put(key, sc.encode(value));
+        } catch (err) {
+            log("ERROR", `NATS: KV Set failed for ${key}: ${err}`);
+            throw err;
+        }
+    }
+
+    /**
+     * Publishes message to the JetStream
+     */
+    async sendFileUpdateMessage(path: string, version: string, serviceName: string): Promise<boolean> {
+        if (!this.js) throw new Error("NATS: JetStream not initialized");
+
+        const message: MQFileUpdate = {
+            service_name: serviceName,
+            service_id: hostname(),
+            sent_timestamp: Math.floor(Date.now() / 1000),
+            data_type: "file",
+            data_kind: "pis",
+            payload: {
+                version: version,
+                filepath: path,
+            }
+        };
 
         const subject = `ingress.file.${message.data_kind}`;
 
-        nats.publish(subject, jc.encode(message));
-
-        await nats.drain();
-        return true
-    } catch (err) {
-        log("ERROR", `NATS: Failed to send message: ${err}`);
-        if (nats) {nats.close()}
-        return false;
+        try {
+            await this.js.publish(subject, jc.encode(message));
+            log("INFO", `NATS: Message published to ${subject}`);
+            return true;
+        } catch (err) {
+            log("ERROR", `NATS: Failed to publish to JetStream: ${err}`);
+            return false;
+        }
     }
-}
+
+    async close() {
+        if (this.nc) {
+            await this.nc.drain();
+            this.nc = null;
+        }
+    }
+}
+
+// Export instance
+export const natsManager = new NatsManager();

src/process.ts

@@ -36,7 +36,7 @@ export async function* processPisStream(cfg: GeneralConfig, inputStream: Readabl
         if (!line.trim()) continue;
 
         const record = JSON.parse(line) as InputRecord;
-        log('DEBUG', `JSON Line Parsed: ${JSON.stringify(record)}`)
+        // log('DEBUG', `JSON Line Parsed: ${JSON.stringify(record)}`)
 
         const crsHash = XXH.h64(record.stops.join('|'), SEED);
         const tiplocStops = await mapStopsToTiploc(record.stops);

src/sss.ts

@@ -1,4 +1,4 @@
-import { S3Client } from "@aws-sdk/client-s3";
+import { S3Client, CreateBucketCommand, HeadBucketCommand, S3ServiceException } from "@aws-sdk/client-s3";
 import { Upload } from "@aws-sdk/lib-storage";
 import { createWriteStream } from "node:fs";
 import { Readable } from "node:stream";
@@ -24,7 +24,8 @@ export async function processAndStore(
             log("DEBUG", "Missing required variables for S3 Support - EXIT CODE 24");
             process.exit(24);
         }
-        log('INFO', `Streaming to S3: ${cfg.S3_BUCKET}/${filename}`);
+
+        log("DEBUG", "Opening connection to S3 Server");
 
         const client = new S3Client({
             endpoint: cfg.S3_ENDPOINT,
@@ -36,6 +37,21 @@ export async function processAndStore(
             forcePathStyle: true,
         });
 
+        // Check bucket exists, and create if needed
+        try {
+            await client.send(new HeadBucketCommand({ Bucket: cfg.S3_BUCKET }));
+        } catch (err) {
+            if (err instanceof S3ServiceException && err.$metadata.httpStatusCode === 404) {
+                log('INFO', `Bucket ${cfg.S3_BUCKET} does not exist, creating...`);
+                await client.send(new CreateBucketCommand({ Bucket: cfg.S3_BUCKET }));
+            } else {
+                log(`ERROR`, `Failed to verify bucket: ${cfg.S3_BUCKET}`);
+                process.exit(21);
+            }
+        }
+
+        log('INFO', `Streaming to S3: ${cfg.S3_BUCKET}/${filename}`);
+
         const upload = new Upload({
             client,
             params: {