@salesforce/mrt-utilities 0.1.1 → 0.1.2

package/dist/esm/data-store/index.d.ts

@@ -0,0 +1,56 @@
+import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
+export declare class DataStoreNotFoundError extends Error {
+    constructor(message: string);
+}
+export declare class DataStoreServiceError extends Error {
+    constructor(message: string);
+}
+export declare class DataStoreUnavailableError extends Error {
+    constructor(message: string);
+}
+/**
+ * A class for reading entries from the data store.
+ *
+ * This class uses a singleton pattern.
+ * Use DataStore.getDataStore() to get the singleton instance.
+ */
+export declare class DataStore {
+    private _tableName;
+    private _ddb;
+    private static _instance;
+    /** @internal Test hook: inject a document client for unit tests */
+    static _testDocumentClient: DynamoDBDocumentClient | null;
+    /** @internal Test hook: inject logMRTError for unit tests */
+    static _testLogMRTError: ((namespace: string, err: unknown, context?: Record<string, unknown>) => void) | null;
+    private constructor();
+    /**
+     * Get or create a DynamoDB document client (for abstraction of attribute values).
+     *
+     * @private
+     * @returns The DynamoDB document client
+     * @throws {DataStoreUnavailableError} The data store is unavailable
+     */
+    private getClient;
+    /**
+     * Get or create the singleton DataStore instance.
+     *
+     * @returns The singleton DataStore instance
+     */
+    static getDataStore(): DataStore;
+    /**
+     * Whether the data store can be used in the current environment.
+     *
+     * @returns true if the data store is available, false otherwise
+     */
+    isDataStoreAvailable(): boolean;
+    /**
+     * Fetch an entry from the data store.
+     *
+     * @param key The data store entry's key
+     * @returns An object containing the entry's key and value
+     * @throws {DataStoreUnavailableError} The data store is unavailable
+     * @throws {DataStoreNotFoundError} An entry with the given key cannot be found
+     * @throws {DataStoreServiceError} An internal error occurred
+     */
+    getEntry(key: string): Promise<Record<string, unknown> | undefined>;
+}

package/dist/esm/data-store/index.js

@@ -0,0 +1,124 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { DynamoDBDocumentClient, GetCommand } from '@aws-sdk/lib-dynamodb';
+import { logMRTError } from '../utils/utils.js';
+export class DataStoreNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DataStoreNotFoundError';
+        Object.setPrototypeOf(this, DataStoreNotFoundError.prototype);
+    }
+}
+export class DataStoreServiceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DataStoreServiceError';
+        Object.setPrototypeOf(this, DataStoreServiceError.prototype);
+    }
+}
+export class DataStoreUnavailableError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DataStoreUnavailableError';
+        Object.setPrototypeOf(this, DataStoreUnavailableError.prototype);
+    }
+}
+/**
+ * A class for reading entries from the data store.
+ *
+ * This class uses a singleton pattern.
+ * Use DataStore.getDataStore() to get the singleton instance.
+ */
+export class DataStore {
+    _tableName = '';
+    _ddb = null;
+    static _instance = null;
+    /** @internal Test hook: inject a document client for unit tests */
+    static _testDocumentClient = null;
+    /** @internal Test hook: inject logMRTError for unit tests */
+    static _testLogMRTError = null;
+    constructor() {
+        // Private constructor for singleton; use DataStore.getDataStore() instead.
+    }
+    /**
+     * Get or create a DynamoDB document client (for abstraction of attribute values).
+     *
+     * @private
+     * @returns The DynamoDB document client
+     * @throws {DataStoreUnavailableError} The data store is unavailable
+     */
+    getClient() {
+        if (!this.isDataStoreAvailable()) {
+            throw new DataStoreUnavailableError('The data store is unavailable.');
+        }
+        if (DataStore._testDocumentClient) {
+            this._tableName = `DataAccessLayer-${process.env.AWS_REGION}`;
+            return DataStore._testDocumentClient;
+        }
+        if (!this._ddb) {
+            this._tableName = `DataAccessLayer-${process.env.AWS_REGION}`;
+            this._ddb = DynamoDBDocumentClient.from(new DynamoDBClient({
+                region: process.env.AWS_REGION,
+            }));
+        }
+        return this._ddb;
+    }
+    /**
+     * Get or create the singleton DataStore instance.
+     *
+     * @returns The singleton DataStore instance
+     */
+    static getDataStore() {
+        if (!DataStore._instance) {
+            DataStore._instance = new DataStore();
+        }
+        return DataStore._instance;
+    }
+    /**
+     * Whether the data store can be used in the current environment.
+     *
+     * @returns true if the data store is available, false otherwise
+     */
+    isDataStoreAvailable() {
+        return Boolean(process.env.AWS_REGION && process.env.MOBIFY_PROPERTY_ID && process.env.DEPLOY_TARGET);
+    }
+    /**
+     * Fetch an entry from the data store.
+     *
+     * @param key The data store entry's key
+     * @returns An object containing the entry's key and value
+     * @throws {DataStoreUnavailableError} The data store is unavailable
+     * @throws {DataStoreNotFoundError} An entry with the given key cannot be found
+     * @throws {DataStoreServiceError} An internal error occurred
+     */
+    async getEntry(key) {
+        if (!this.isDataStoreAvailable()) {
+            throw new DataStoreUnavailableError('The data store is unavailable.');
+        }
+        const ddb = this.getClient();
+        let response;
+        try {
+            response = await ddb.send(new GetCommand({
+                TableName: this._tableName,
+                Key: {
+                    projectEnvironment: `${process.env.MOBIFY_PROPERTY_ID} ${process.env.DEPLOY_TARGET}`,
+                    key,
+                },
+            }));
+        }
+        catch (error) {
+            const logFn = DataStore._testLogMRTError ?? logMRTError;
+            logFn('data_store', error, { key, tableName: this._tableName });
+            throw new DataStoreServiceError('Data store request failed.');
+        }
+        if (!response.Item?.value) {
+            throw new DataStoreNotFoundError(`Data store entry '${key}' not found.`);
+        }
+        return { key, value: response.Item.value };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/data-store/index.js.map

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

package/dist/esm/middleware/data-store.d.ts

@@ -1,56 +1,5 @@
-import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
-export declare class DataStoreNotFoundError extends Error {
-    constructor(message: string);
-}
-export declare class DataStoreServiceError extends Error {
-    constructor(message: string);
-}
-export declare class DataStoreUnavailableError extends Error {
-    constructor(message: string);
-}
 /**
- * A class for reading entries from the data store.
- *
- * This class uses a singleton pattern.
- * Use DataStore.getDataStore() to get the singleton instance.
+ * @deprecated Import data-store symbols from `@salesforce/mrt-utilities/data-store`.
+ * This compatibility path is kept for backward compatibility.
  */
-export declare class DataStore {
-    private _tableName;
-    private _ddb;
-    private static _instance;
-    /** @internal Test hook: inject a document client for unit tests */
-    static _testDocumentClient: DynamoDBDocumentClient | null;
-    /** @internal Test hook: inject logMRTError for unit tests */
-    static _testLogMRTError: ((namespace: string, err: unknown, context?: Record<string, unknown>) => void) | null;
-    private constructor();
-    /**
-     * Get or create a DynamoDB document client (for abstraction of attribute values).
-     *
-     * @private
-     * @returns The DynamoDB document client
-     * @throws {DataStoreUnavailableError} The data store is unavailable
-     */
-    private getClient;
-    /**
-     * Get or create the singleton DataStore instance.
-     *
-     * @returns The singleton DataStore instance
-     */
-    static getDataStore(): DataStore;
-    /**
-     * Whether the data store can be used in the current environment.
-     *
-     * @returns true if the data store is available, false otherwise
-     */
-    isDataStoreAvailable(): boolean;
-    /**
-     * Fetch an entry from the data store.
-     *
-     * @param key The data store entry's key
-     * @returns An object containing the entry's key and value
-     * @throws {DataStoreUnavailableError} The data store is unavailable
-     * @throws {DataStoreNotFoundError} An entry with the given key cannot be found
-     * @throws {DataStoreServiceError} An internal error occurred
-     */
-    getEntry(key: string): Promise<Record<string, unknown> | undefined>;
-}
+export * from '../data-store/index.js';

package/dist/esm/middleware/data-store.js

@@ -3,122 +3,9 @@
  * SPDX-License-Identifier: Apache-2
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
-import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
-import { DynamoDBDocumentClient, GetCommand } from '@aws-sdk/lib-dynamodb';
-import { logMRTError } from '../utils/utils.js';
-export class DataStoreNotFoundError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'DataStoreNotFoundError';
-        Object.setPrototypeOf(this, DataStoreNotFoundError.prototype);
-    }
-}
-export class DataStoreServiceError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'DataStoreServiceError';
-        Object.setPrototypeOf(this, DataStoreServiceError.prototype);
-    }
-}
-export class DataStoreUnavailableError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'DataStoreUnavailableError';
-        Object.setPrototypeOf(this, DataStoreUnavailableError.prototype);
-    }
-}
 /**
- * A class for reading entries from the data store.
- *
- * This class uses a singleton pattern.
- * Use DataStore.getDataStore() to get the singleton instance.
+ * @deprecated Import data-store symbols from `@salesforce/mrt-utilities/data-store`.
+ * This compatibility path is kept for backward compatibility.
  */
-export class DataStore {
-    _tableName = '';
-    _ddb = null;
-    static _instance = null;
-    /** @internal Test hook: inject a document client for unit tests */
-    static _testDocumentClient = null;
-    /** @internal Test hook: inject logMRTError for unit tests */
-    static _testLogMRTError = null;
-    constructor() {
-        // Private constructor for singleton; use DataStore.getDataStore() instead.
-    }
-    /**
-     * Get or create a DynamoDB document client (for abstraction of attribute values).
-     *
-     * @private
-     * @returns The DynamoDB document client
-     * @throws {DataStoreUnavailableError} The data store is unavailable
-     */
-    getClient() {
-        if (!this.isDataStoreAvailable()) {
-            throw new DataStoreUnavailableError('The data store is unavailable.');
-        }
-        if (DataStore._testDocumentClient) {
-            this._tableName = `DataAccessLayer-${process.env.AWS_REGION}`;
-            return DataStore._testDocumentClient;
-        }
-        if (!this._ddb) {
-            this._tableName = `DataAccessLayer-${process.env.AWS_REGION}`;
-            this._ddb = DynamoDBDocumentClient.from(new DynamoDBClient({
-                region: process.env.AWS_REGION,
-            }));
-        }
-        return this._ddb;
-    }
-    /**
-     * Get or create the singleton DataStore instance.
-     *
-     * @returns The singleton DataStore instance
-     */
-    static getDataStore() {
-        if (!DataStore._instance) {
-            DataStore._instance = new DataStore();
-        }
-        return DataStore._instance;
-    }
-    /**
-     * Whether the data store can be used in the current environment.
-     *
-     * @returns true if the data store is available, false otherwise
-     */
-    isDataStoreAvailable() {
-        return Boolean(process.env.AWS_REGION && process.env.MOBIFY_PROPERTY_ID && process.env.DEPLOY_TARGET);
-    }
-    /**
-     * Fetch an entry from the data store.
-     *
-     * @param key The data store entry's key
-     * @returns An object containing the entry's key and value
-     * @throws {DataStoreUnavailableError} The data store is unavailable
-     * @throws {DataStoreNotFoundError} An entry with the given key cannot be found
-     * @throws {DataStoreServiceError} An internal error occurred
-     */
-    async getEntry(key) {
-        if (!this.isDataStoreAvailable()) {
-            throw new DataStoreUnavailableError('The data store is unavailable.');
-        }
-        const ddb = this.getClient();
-        let response;
-        try {
-            response = await ddb.send(new GetCommand({
-                TableName: this._tableName,
-                Key: {
-                    projectEnvironment: `${process.env.MOBIFY_PROPERTY_ID} ${process.env.DEPLOY_TARGET}`,
-                    key,
-                },
-            }));
-        }
-        catch (error) {
-            const logFn = DataStore._testLogMRTError ?? logMRTError;
-            logFn('data_store', error, { key, tableName: this._tableName });
-            throw new DataStoreServiceError('Data store request failed.');
-        }
-        if (!response.Item?.value) {
-            throw new DataStoreNotFoundError(`Data store entry '${key}' not found.`);
-        }
-        return { key, value: response.Item.value };
-    }
-}
+export * from '../data-store/index.js';
 //# sourceMappingURL=data-store.js.map

package/dist/esm/middleware/data-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-store.js","sourceRoot":"","sources":["../../../src/middleware/data-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-store.js","sourceRoot":"","sources":["../../../src/middleware/data-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,cAAc,wBAAwB,CAAC"}

package/dist/esm/middleware/express.d.ts

@@ -0,0 +1,2 @@
+export * from './middleware.js';
+export { type ProxyConfig } from '../utils/configure-proxying.js';

package/dist/esm/middleware/express.js

@@ -0,0 +1,8 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+export * from './middleware.js';
+export {} from '../utils/configure-proxying.js';
+//# sourceMappingURL=express.js.map

package/dist/esm/middleware/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../../src/middleware/express.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAkB,MAAM,gCAAgC,CAAC"}

package/dist/esm/middleware/index.d.ts

@@ -1,3 +1,2 @@
-export * from './data-store.js';
-export * from './middleware.js';
-export { type ProxyConfig } from '../utils/configure-proxying.js';
+export * from '../data-store/index.js';
+export * from './express.js';

package/dist/esm/middleware/index.js

@@ -3,7 +3,6 @@
  * SPDX-License-Identifier: Apache-2
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
-export * from './data-store.js';
-export * from './middleware.js';
-export {} from '../utils/configure-proxying.js';
+export * from '../data-store/index.js';
+export * from './express.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/middleware/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAkB,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC"}

package/dist/esm/streaming/create-lambda-adapter.js

@@ -44,7 +44,7 @@ export function createStreamingLambdaAdapter(app, responseStream, compressionCon
             const isStreamOpen = responseStream && responseStream.writable && !responseStream.destroyed && !responseStream.writableEnded;
             if (isStreamOpen && typeof responseStream.write === 'function') {
                 const errorMessage = error instanceof Error ? error.message : String(error);
-                responseStream.write(`HTTP/1.1 500 Internal Server Error\r\n\r\nInternal Server Error: ${errorMessage}`);
+                responseStream.write(`Internal Server Error: ${errorMessage}`);
             }
             else {
                 console.error('[error handler] Cannot write error - stream is closed');
@@ -81,34 +81,17 @@ async function streamResponse(event, responseStream, context, app, compressionCo
                 reject(err);
             }
         };
+        // See events defined for hhtp.serverResponse interface here:
+        // https://nodejs.org/docs/latest-v24.x/api/http.html#class-httpserverresponse
         // Handle response finish
-        expressResponse.once('finish', () => {
-            resolveOnce();
-        });
+        expressResponse.once('finish', resolveOnce);
+        // handle response close, either after a 'finish' or if underlying
+        // connection is closed early
+        expressResponse.once('close', resolveOnce);
         // Handle response errors
-        expressResponse.once('error', (err) => {
-            rejectOnce(err);
-        });
+        expressResponse.once('error', rejectOnce);
         try {
-            app(expressRequest, expressResponse, (err) => {
-                if (err) {
-                    console.error('Express app error:', err);
-                    rejectOnce(err);
-                }
-                else {
-                    // If response has finished, resolveOnce will be called by the finish event
-                    // Otherwise, resolve after a short delay to allow async operations
-                    if (expressResponse.finished) {
-                        resolveOnce();
-                    }
-                    else {
-                        // Wait a bit for the response to finish
-                        setTimeout(() => {
-                            resolveOnce();
-                        }, 10);
-                    }
-                }
-            });
+            app(expressRequest, expressResponse);
         }
         catch (error) {
             console.error('Error in streamResponse:', error);
@@ -410,6 +393,7 @@ export function createExpressResponse(responseStream, event, context, request, c
         }
         if (!isStreamOpen()) {
             console.error('Cannot initialize response - stream is closed');
+            emitCloseOnce(response);
             return;
         }
         // Collect all current headers from the response
@@ -432,7 +416,7 @@ export function createExpressResponse(responseStream, event, context, request, c
         // Create HttpResponseStream with metadata
         // This writes the HTTP status and headers to the stream
         const metadata = {
-            statusCode,
+            statusCode: response.statusCode || statusCode,
             headers,
         };
         const cookies = metadata.headers['set-cookie'];
@@ -442,6 +426,14 @@ export function createExpressResponse(responseStream, event, context, request, c
         }
         metadata.headers = convertHeaders(metadata.headers);
         httpResponseStream = awslambda.HttpResponseStream.from(responseStream, metadata);
+        // Bind 'finish' and 'close' handlers to emit the same events on the response object
+        httpResponseStream.on('finish', () => {
+            response.finished = true;
+            response.emit('finish');
+        });
+        httpResponseStream.on('close', () => {
+            response.emit('close');
+        });
         // Set up compression stream if compression is enabled
         // The compression stream pipes to httpResponseStream, which pipes to responseStream
         // 'identity' means no encoding, so we should not initialize compression for it
@@ -529,7 +521,7 @@ export function createExpressResponse(responseStream, event, context, request, c
             headerObj = reasonPhrase;
             reasonPhrase = undefined;
         }
-        statusCode = code || statusCode;
+        statusCode = code || this.statusCode || statusCode;
         this.statusCode = statusCode;
         // Set statusMessage if provided
         if (reasonPhrase) {
@@ -552,6 +544,7 @@ export function createExpressResponse(responseStream, event, context, request, c
     res.write = function (chunk) {
         if (!isStreamOpen()) {
             console.error(`Cannot write - stream is closed`);
+            emitCloseOnce(this);
             return false;
         }
         initializeResponse(this);
@@ -575,6 +568,14 @@ export function createExpressResponse(responseStream, event, context, request, c
             httpResponseStream.flush();
         }
     };
+    let emittedClose = false;
+    const emitCloseOnce = (response) => {
+        if (emittedClose) {
+            return;
+        }
+        response.emit('close');
+        emittedClose = true;
+    };
     /**
      * Ends the appropriate stream(s) and emits the finish event
      * If compression is enabled, ends the compression stream which will automatically
@@ -583,50 +584,30 @@ export function createExpressResponse(responseStream, event, context, request, c
      * @param response - The Express response object to emit finish event on
      */
     const endStream = (response) => {
-        if (shouldCompress && compressionStream) {
-            try {
-                // Flush compression stream to ensure all buffered data is written
-                _flush();
-                // End compression stream - this will automatically end httpResponseStream
-                // due to the pipe with { end: true } option
-                compressionStream.end(() => {
-                    response.finished = true;
-                    response.emit('finish');
-                });
-            }
-            catch (error) {
-                console.error(`Error ending compression stream:`, error);
-                // Still emit finish even if there was an error
-                response.finished = true;
-                response.emit('finish');
-            }
-        }
-        else if (httpResponseStream && httpResponseStream.writable) {
-            // No compression, end httpResponseStream directly
+        const stream = (shouldCompress && compressionStream) || (httpResponseStream?.writable && httpResponseStream);
+        if (stream) {
             try {
                 _flush();
-                httpResponseStream.end(() => {
-                    response.finished = true;
-                    response.emit('finish');
-                });
+                stream.end();
             }
             catch (error) {
-                console.error(`Error ending httpResponseStream:`, error);
+                console.error(`Error ending stream:`, error);
                 response.finished = true;
-                response.emit('finish');
+                emitCloseOnce(response);
             }
         }
         else {
             console.error(`Cannot call end() - stream is closed`);
             // Still emit finish to prevent hanging
             response.finished = true;
-            response.emit('finish');
+            emitCloseOnce(response);
         }
     };
     // @ts-expect-error - Type signature doesn't match ServerResponse.end exactly, but our implementation is compatible
     res.end = function (chunk) {
         if (!isStreamOpen()) {
             console.error(`Cannot end - stream is already closed`);
+            emitCloseOnce(this);
             return this;
         }
         initializeResponse(this);
@@ -654,9 +635,8 @@ export function createExpressResponse(responseStream, event, context, request, c
     // Add Express-specific methods that aren't in ServerResponse
     res.status = function (code, message) {
         this.statusCode = code;
-        statusCode = code;
         if (message !== undefined) {
-            statusMessage = message;
+            this.statusMessage = message;
         }
         return this;
     };
@@ -700,6 +680,7 @@ export function createExpressResponse(responseStream, event, context, request, c
         if (!responseStarted) {
             if (!isStreamOpen()) {
                 console.error('[res.flushHeaders] Cannot flush headers - stream is closed');
+                emitCloseOnce(this);
                 return this;
             }
             // Collect all current headers and send them
@@ -739,6 +720,7 @@ export function createExpressResponse(responseStream, event, context, request, c
     res.flush = function () {
         if (!isStreamOpen()) {
             console.error(`Cannot flush - stream is closed`);
+            emitCloseOnce(this);
             return this;
         }
         initializeResponse(this);