@oino-ts/types 0.0.12 → 0.0.14

package/dist/cjs/OINOBenchmark.js

@@ -26,21 +26,23 @@ class OINOBenchmark {
     /**
      *  Set benchmark names that are enabled.
      *
-     *  @param names array of those benchmarks that are enabled
+     *  @param module array of those benchmarks that are enabled
      */
-    static setEnabled(names) {
+    static setEnabled(module) {
         this._benchmarkEnabled = {};
-        names.forEach(name => {
-            this._benchmarkEnabled[name] = true;
+        module.forEach(module_name => {
+            this._benchmarkEnabled[module_name] = true;
         });
     }
     /**
      * Start benchmark timing.
      *
-     * @param name of the benchmark
+     * @param module of the benchmark
+     * @param method of the benchmark
      */
-    static start(name) {
-        if (this._benchmarkEnabled[name]) {
+    static start(module, method) {
+        const name = module + "." + method;
+        if (this._benchmarkEnabled[module]) {
             if (this._benchmarkCount[name] == undefined) {
                 this._benchmarkCount[name] = 0;
                 this._benchmarkData[name] = 0;
@@ -51,16 +53,56 @@ class OINOBenchmark {
     /**
      * Complete benchmark timing
      *
-     * @param name of the benchmark
+     * @param module of the benchmark
+     * @param method of the benchmark
+     * @param category optional subcategory of the benchmark
      */
-    static end(name) {
+    static end(module, method, category) {
+        const name = module + "." + method;
         let result = 0;
-        if (this._benchmarkEnabled[name]) {
+        if (this._benchmarkEnabled[module]) {
+            const duration = performance.now() - this._benchmarkStart[name];
             this._benchmarkCount[name] += 1;
-            this._benchmarkData[name] += performance.now() - this._benchmarkStart[name];
+            this._benchmarkData[name] += duration;
+            if (category) {
+                const category_name = name + "." + category;
+                if (this._benchmarkCount[category_name] == undefined) {
+                    this._benchmarkCount[category_name] = 0;
+                    this._benchmarkData[category_name] = 0;
+                }
+                this._benchmarkCount[category_name] += 1;
+                this._benchmarkData[category_name] += duration;
+            }
             result = this._benchmarkData[name] / this._benchmarkCount[name];
         }
         return result;
     }
+    /**
+     * Get given benchmark data.
+     *
+     * @param module of the benchmark
+     * @param method of the benchmark
+     *
+     */
+    static get(module, method) {
+        const name = module + "." + method;
+        if (this._benchmarkEnabled[module]) {
+            return this._benchmarkData[module] / this._benchmarkCount[module];
+        }
+        return -1;
+    }
+    /**
+     * Get all benchmark data.
+     *
+     */
+    static getAll() {
+        let result = {};
+        for (const name in this._benchmarkData) {
+            if (this._benchmarkCount[name] > 0) {
+                result[name] = this._benchmarkData[name] / this._benchmarkCount[name];
+            }
+        }
+        return result;
+    }
 }
 exports.OINOBenchmark = OINOBenchmark;

package/dist/cjs/OINOHtmlTemplate.js

@@ -8,23 +8,20 @@ const _1 = require(".");
 class OINOHtmlTemplate {
     /** HTML template string */
     template;
+    /** Cache modified value for template */
+    modified;
     /** Cache expiration value for template */
     expires;
     /**
      * Creates HTML Response from a key-value-pair.
      *
      * @param template template string
-     * @param expires cache expiration value
      *
      */
-    constructor(template, expires) {
+    constructor(template) {
         this.template = template;
-        if (expires) {
-            this.expires = expires;
-        }
-        else {
-            this.expires = -1;
-        }
+        this.modified = 0;
+        this.expires = 0;
     }
     /**
      * @returns whether template is empty
@@ -40,8 +37,16 @@ class OINOHtmlTemplate {
      *
      */
     renderFromKeyValue(key, value) {
+        _1.OINOBenchmark.start("OINOHtmlTemplate", "renderFromKeyValue");
         const html = this.template.replaceAll('###' + key + '###', _1.OINOStr.encode(value, _1.OINOContentType.html));
         const result = new _1.OINOHttpResult(html);
+        if (this.expires >= 1) {
+            result.expires = Math.round(this.expires);
+        }
+        if (this.modified >= 1) {
+            result.lastModified = this.modified;
+        }
+        _1.OINOBenchmark.end("OINOHtmlTemplate", "renderFromKeyValue");
         return result;
     }
     /**
@@ -51,6 +56,7 @@ class OINOHtmlTemplate {
      *
      */
     renderFromObject(object) {
+        _1.OINOBenchmark.start("OINOHtmlTemplate", "renderFromObject");
         let html = this.template;
         if (object) {
             for (let key in object) {
@@ -63,8 +69,12 @@ class OINOHtmlTemplate {
         html = html.replace(/###[^#]*###/g, "");
         const result = new _1.OINOHttpResult(html);
         if (this.expires >= 1) {
-            result.headers["Expires"] = Math.round(this.expires).toString();
+            result.expires = Math.round(this.expires);
         }
+        if (this.modified >= 1) {
+            result.lastModified = this.modified;
+        }
+        _1.OINOBenchmark.end("OINOHtmlTemplate", "renderFromObject");
         return result;
     }
     /**
@@ -78,6 +88,7 @@ class OINOHtmlTemplate {
      *
      */
     renderFromResult(result, includeErrorMessages = false, includeWarningMessages = false, includeInfoMessages = false, includeDebugMessages = false) {
+        _1.OINOBenchmark.start("OINOHtmlTemplate", "renderFromResult");
         let html = this.template;
         html = html.replaceAll('###statusCode###', _1.OINOStr.encode(result.statusCode.toString(), _1.OINOContentType.html));
         html = html.replaceAll('###statusMessage###', _1.OINOStr.encode(result.statusMessage.toString(), _1.OINOContentType.html));
@@ -101,6 +112,13 @@ class OINOHtmlTemplate {
         }
         html = html.replace(/###[^#]*###/g, "");
         const http_result = new _1.OINOHttpResult(html);
+        if (this.expires >= 1) {
+            http_result.expires = Math.round(this.expires);
+        }
+        if (this.modified >= 1) {
+            http_result.lastModified = this.modified;
+        }
+        _1.OINOBenchmark.end("OINOHtmlTemplate", "renderFromResult");
         return http_result;
     }
 }

package/dist/cjs/OINOResult.js

@@ -6,6 +6,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OINOHttpResult = exports.OINOResult = void 0;
+const node_crypto_1 = require("node:crypto");
 const _1 = require(".");
 /**
  * OINO API request result object with returned data and/or http status code/message and
@@ -153,25 +154,36 @@ exports.OINOResult = OINOResult;
  * Specialized result for HTTP responses.
  */
 class OINOHttpResult extends OINOResult {
+    _etag;
     /** HTTP body data */
     body;
-    /** HTTP header values */
-    headers;
+    /** HTTP cache expiration value */
+    expires;
+    /** HTTP cache last-modified value */
+    lastModified;
     /**
      * Constructor for a `OINOHttpResult`
      *
      * @param body HTTP body
-     * @param headers HTTP headers
+     *
      */
-    constructor(body, headers) {
+    constructor(body) {
         super();
         this.body = body;
-        if (headers) {
-            this.headers = headers;
-        }
-        else {
-            this.headers = {};
+        this.expires = 0;
+        this.lastModified = 0;
+        this._etag = "";
+    }
+    /**
+     * Get the ETag value for the body opportunistically, i.e. don't calculate until requested and reuse value.
+     *
+     */
+    getEtag() {
+        if (this._etag == "") {
+            const hash = (0, node_crypto_1.createHash)("sha256");
+            this._etag = hash.update(this.body).digest("hex");
         }
+        return this._etag;
     }
     /**
      * Get a Response object from the result values.
@@ -179,11 +191,18 @@ class OINOHttpResult extends OINOResult {
      * @param headers HTTP headers (overrides existing values)
      */
     getResponse(headers) {
-        if (!headers) {
-            headers = this.headers;
-        }
-        headers['Content-Length'] = this.body.length.toString();
         const result = new Response(this.body, { status: this.statusCode, statusText: this.statusMessage, headers: headers });
+        result.headers.set('Content-Length', this.body.length.toString());
+        if (this.lastModified > 0) {
+            result.headers.set('Last-Modified', new Date(this.lastModified).toUTCString());
+        }
+        if (this.expires >= 0) {
+            result.headers.set('Expires', Math.round(this.expires).toString());
+            if (this.expires == 0) {
+                result.headers.set('Pragma', 'no-cache');
+            }
+        }
+        result.headers.set("ETag", this.getEtag());
         return result;
     }
 }

package/dist/cjs/index.js

@@ -22,7 +22,9 @@ exports.OINO_WARNING_PREFIX = "OINO WARNING";
 exports.OINO_INFO_PREFIX = "OINO INFO";
 /** OINO debug message prefix */
 exports.OINO_DEBUG_PREFIX = "OINO DEBUG";
-/** Supported content format mime-types */
+/**
+ * Supported content format mime-types
+ */
 var OINOContentType;
 (function (OINOContentType) {
     /** JSON encoded data */

package/dist/esm/OINOBenchmark.js

@@ -23,21 +23,23 @@ export class OINOBenchmark {
     /**
      *  Set benchmark names that are enabled.
      *
-     *  @param names array of those benchmarks that are enabled
+     *  @param module array of those benchmarks that are enabled
      */
-    static setEnabled(names) {
+    static setEnabled(module) {
         this._benchmarkEnabled = {};
-        names.forEach(name => {
-            this._benchmarkEnabled[name] = true;
+        module.forEach(module_name => {
+            this._benchmarkEnabled[module_name] = true;
         });
     }
     /**
      * Start benchmark timing.
      *
-     * @param name of the benchmark
+     * @param module of the benchmark
+     * @param method of the benchmark
      */
-    static start(name) {
-        if (this._benchmarkEnabled[name]) {
+    static start(module, method) {
+        const name = module + "." + method;
+        if (this._benchmarkEnabled[module]) {
             if (this._benchmarkCount[name] == undefined) {
                 this._benchmarkCount[name] = 0;
                 this._benchmarkData[name] = 0;
@@ -48,15 +50,55 @@ export class OINOBenchmark {
     /**
      * Complete benchmark timing
      *
-     * @param name of the benchmark
+     * @param module of the benchmark
+     * @param method of the benchmark
+     * @param category optional subcategory of the benchmark
      */
-    static end(name) {
+    static end(module, method, category) {
+        const name = module + "." + method;
         let result = 0;
-        if (this._benchmarkEnabled[name]) {
+        if (this._benchmarkEnabled[module]) {
+            const duration = performance.now() - this._benchmarkStart[name];
             this._benchmarkCount[name] += 1;
-            this._benchmarkData[name] += performance.now() - this._benchmarkStart[name];
+            this._benchmarkData[name] += duration;
+            if (category) {
+                const category_name = name + "." + category;
+                if (this._benchmarkCount[category_name] == undefined) {
+                    this._benchmarkCount[category_name] = 0;
+                    this._benchmarkData[category_name] = 0;
+                }
+                this._benchmarkCount[category_name] += 1;
+                this._benchmarkData[category_name] += duration;
+            }
             result = this._benchmarkData[name] / this._benchmarkCount[name];
         }
         return result;
     }
+    /**
+     * Get given benchmark data.
+     *
+     * @param module of the benchmark
+     * @param method of the benchmark
+     *
+     */
+    static get(module, method) {
+        const name = module + "." + method;
+        if (this._benchmarkEnabled[module]) {
+            return this._benchmarkData[module] / this._benchmarkCount[module];
+        }
+        return -1;
+    }
+    /**
+     * Get all benchmark data.
+     *
+     */
+    static getAll() {
+        let result = {};
+        for (const name in this._benchmarkData) {
+            if (this._benchmarkCount[name] > 0) {
+                result[name] = this._benchmarkData[name] / this._benchmarkCount[name];
+            }
+        }
+        return result;
+    }
 }

package/dist/esm/OINOHtmlTemplate.js

@@ -1,27 +1,24 @@
-import { OINOStr, OINOContentType, OINOHttpResult, OINO_ERROR_PREFIX, OINO_WARNING_PREFIX, OINO_INFO_PREFIX, OINO_DEBUG_PREFIX } from ".";
+import { OINOStr, OINOContentType, OINOHttpResult, OINO_ERROR_PREFIX, OINO_WARNING_PREFIX, OINO_INFO_PREFIX, OINO_DEBUG_PREFIX, OINOBenchmark } from ".";
 /**
  * Class for rendering HTML from data.
  */
 export class OINOHtmlTemplate {
     /** HTML template string */
     template;
+    /** Cache modified value for template */
+    modified;
     /** Cache expiration value for template */
     expires;
     /**
      * Creates HTML Response from a key-value-pair.
      *
      * @param template template string
-     * @param expires cache expiration value
      *
      */
-    constructor(template, expires) {
+    constructor(template) {
         this.template = template;
-        if (expires) {
-            this.expires = expires;
-        }
-        else {
-            this.expires = -1;
-        }
+        this.modified = 0;
+        this.expires = 0;
     }
     /**
      * @returns whether template is empty
@@ -37,8 +34,16 @@ export class OINOHtmlTemplate {
      *
      */
     renderFromKeyValue(key, value) {
+        OINOBenchmark.start("OINOHtmlTemplate", "renderFromKeyValue");
         const html = this.template.replaceAll('###' + key + '###', OINOStr.encode(value, OINOContentType.html));
         const result = new OINOHttpResult(html);
+        if (this.expires >= 1) {
+            result.expires = Math.round(this.expires);
+        }
+        if (this.modified >= 1) {
+            result.lastModified = this.modified;
+        }
+        OINOBenchmark.end("OINOHtmlTemplate", "renderFromKeyValue");
         return result;
     }
     /**
@@ -48,6 +53,7 @@ export class OINOHtmlTemplate {
      *
      */
     renderFromObject(object) {
+        OINOBenchmark.start("OINOHtmlTemplate", "renderFromObject");
         let html = this.template;
         if (object) {
             for (let key in object) {
@@ -60,8 +66,12 @@ export class OINOHtmlTemplate {
         html = html.replace(/###[^#]*###/g, "");
         const result = new OINOHttpResult(html);
         if (this.expires >= 1) {
-            result.headers["Expires"] = Math.round(this.expires).toString();
+            result.expires = Math.round(this.expires);
         }
+        if (this.modified >= 1) {
+            result.lastModified = this.modified;
+        }
+        OINOBenchmark.end("OINOHtmlTemplate", "renderFromObject");
         return result;
     }
     /**
@@ -75,6 +85,7 @@ export class OINOHtmlTemplate {
      *
      */
     renderFromResult(result, includeErrorMessages = false, includeWarningMessages = false, includeInfoMessages = false, includeDebugMessages = false) {
+        OINOBenchmark.start("OINOHtmlTemplate", "renderFromResult");
         let html = this.template;
         html = html.replaceAll('###statusCode###', OINOStr.encode(result.statusCode.toString(), OINOContentType.html));
         html = html.replaceAll('###statusMessage###', OINOStr.encode(result.statusMessage.toString(), OINOContentType.html));
@@ -98,6 +109,13 @@ export class OINOHtmlTemplate {
         }
         html = html.replace(/###[^#]*###/g, "");
         const http_result = new OINOHttpResult(html);
+        if (this.expires >= 1) {
+            http_result.expires = Math.round(this.expires);
+        }
+        if (this.modified >= 1) {
+            http_result.lastModified = this.modified;
+        }
+        OINOBenchmark.end("OINOHtmlTemplate", "renderFromResult");
         return http_result;
     }
 }

package/dist/esm/OINOResult.js

@@ -3,6 +3,7 @@
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at https://mozilla.org/MPL/2.0/.
  */
+import { createHash } from "node:crypto";
 import { OINO_DEBUG_PREFIX, OINO_ERROR_PREFIX, OINO_INFO_PREFIX, OINO_WARNING_PREFIX } from ".";
 /**
  * OINO API request result object with returned data and/or http status code/message and
@@ -149,25 +150,36 @@ export class OINOResult {
  * Specialized result for HTTP responses.
  */
 export class OINOHttpResult extends OINOResult {
+    _etag;
     /** HTTP body data */
     body;
-    /** HTTP header values */
-    headers;
+    /** HTTP cache expiration value */
+    expires;
+    /** HTTP cache last-modified value */
+    lastModified;
     /**
      * Constructor for a `OINOHttpResult`
      *
      * @param body HTTP body
-     * @param headers HTTP headers
+     *
      */
-    constructor(body, headers) {
+    constructor(body) {
         super();
         this.body = body;
-        if (headers) {
-            this.headers = headers;
-        }
-        else {
-            this.headers = {};
+        this.expires = 0;
+        this.lastModified = 0;
+        this._etag = "";
+    }
+    /**
+     * Get the ETag value for the body opportunistically, i.e. don't calculate until requested and reuse value.
+     *
+     */
+    getEtag() {
+        if (this._etag == "") {
+            const hash = createHash("sha256");
+            this._etag = hash.update(this.body).digest("hex");
         }
+        return this._etag;
     }
     /**
      * Get a Response object from the result values.
@@ -175,11 +187,18 @@ export class OINOHttpResult extends OINOResult {
      * @param headers HTTP headers (overrides existing values)
      */
     getResponse(headers) {
-        if (!headers) {
-            headers = this.headers;
-        }
-        headers['Content-Length'] = this.body.length.toString();
         const result = new Response(this.body, { status: this.statusCode, statusText: this.statusMessage, headers: headers });
+        result.headers.set('Content-Length', this.body.length.toString());
+        if (this.lastModified > 0) {
+            result.headers.set('Last-Modified', new Date(this.lastModified).toUTCString());
+        }
+        if (this.expires >= 0) {
+            result.headers.set('Expires', Math.round(this.expires).toString());
+            if (this.expires == 0) {
+                result.headers.set('Pragma', 'no-cache');
+            }
+        }
+        result.headers.set("ETag", this.getEtag());
         return result;
     }
 }

package/dist/esm/index.js

@@ -11,7 +11,9 @@ export const OINO_WARNING_PREFIX = "OINO WARNING";
 export const OINO_INFO_PREFIX = "OINO INFO";
 /** OINO debug message prefix */
 export const OINO_DEBUG_PREFIX = "OINO DEBUG";
-/** Supported content format mime-types */
+/**
+ * Supported content format mime-types
+ */
 export var OINOContentType;
 (function (OINOContentType) {
     /** JSON encoded data */

package/dist/types/OINOBenchmark.d.ts

@@ -15,19 +15,35 @@ export declare class OINOBenchmark {
     /**
      *  Set benchmark names that are enabled.
      *
-     *  @param names array of those benchmarks that are enabled
+     *  @param module array of those benchmarks that are enabled
      */
-    static setEnabled(names: string[]): void;
+    static setEnabled(module: string[]): void;
     /**
      * Start benchmark timing.
      *
-     * @param name of the benchmark
+     * @param module of the benchmark
+     * @param method of the benchmark
      */
-    static start(name: string): void;
+    static start(module: string, method: string): void;
     /**
      * Complete benchmark timing
      *
-     * @param name of the benchmark
+     * @param module of the benchmark
+     * @param method of the benchmark
+     * @param category optional subcategory of the benchmark
      */
-    static end(name: string): number;
+    static end(module: string, method: string, category?: string): number;
+    /**
+     * Get given benchmark data.
+     *
+     * @param module of the benchmark
+     * @param method of the benchmark
+     *
+     */
+    static get(module: string, method: string): number;
+    /**
+     * Get all benchmark data.
+     *
+     */
+    static getAll(): number;
 }

package/dist/types/OINOHtmlTemplate.d.ts

@@ -5,16 +5,17 @@ import { OINOResult, OINOHttpResult } from ".";
 export declare class OINOHtmlTemplate {
     /** HTML template string */
     template: string;
+    /** Cache modified value for template */
+    modified: number;
     /** Cache expiration value for template */
     expires: number;
     /**
      * Creates HTML Response from a key-value-pair.
      *
      * @param template template string
-     * @param expires cache expiration value
      *
      */
-    constructor(template: string, expires?: number);
+    constructor(template: string);
     /**
      * @returns whether template is empty
      */

package/dist/types/OINOResult.d.ts

@@ -77,17 +77,25 @@ export declare class OINOResult {
  * Specialized result for HTTP responses.
  */
 export declare class OINOHttpResult extends OINOResult {
+    private _etag;
     /** HTTP body data */
-    body: string;
-    /** HTTP header values */
-    headers: Record<string, string>;
+    readonly body: string;
+    /** HTTP cache expiration value */
+    expires: number;
+    /** HTTP cache last-modified value */
+    lastModified: number;
     /**
      * Constructor for a `OINOHttpResult`
      *
      * @param body HTTP body
-     * @param headers HTTP headers
+     *
+     */
+    constructor(body: string);
+    /**
+     * Get the ETag value for the body opportunistically, i.e. don't calculate until requested and reuse value.
+     *
      */
-    constructor(body: string, headers?: Record<string, string>);
+    getEtag(): string;
     /**
      * Get a Response object from the result values.
      *

package/dist/types/index.d.ts

@@ -11,7 +11,9 @@ export declare const OINO_WARNING_PREFIX = "OINO WARNING";
 export declare const OINO_INFO_PREFIX = "OINO INFO";
 /** OINO debug message prefix */
 export declare const OINO_DEBUG_PREFIX = "OINO DEBUG";
-/** Supported content format mime-types */
+/**
+ * Supported content format mime-types
+ */
 export declare enum OINOContentType {
     /** JSON encoded data */
     json = "application/json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oino-ts/types",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "description": "OINO TS package for types.",
   "author": "Matias Kiviniemi (pragmatta)",
   "license": "MPL-2.0",

package/src/OINOBenchmark.ts

@@ -27,22 +27,24 @@ export class OINOBenchmark {
     /**
      *  Set benchmark names that are enabled.
      *
-     *  @param names array of those benchmarks that are enabled 
+     *  @param module array of those benchmarks that are enabled 
      */
-    static setEnabled(names:string[]):void {
+    static setEnabled(module:string[]):void {
         this._benchmarkEnabled = {}
-        names.forEach(name => {
-            this._benchmarkEnabled[name] = true        
+        module.forEach(module_name => {
+            this._benchmarkEnabled[module_name] = true        
         });
     }
 
     /**
      * Start benchmark timing.
      *
-     * @param name of the benchmark
+     * @param module of the benchmark
+     * @param method of the benchmark
      */
-    static start(name:string):void {
-        if (this._benchmarkEnabled[name]) {
+    static start(module:string, method:string):void {
+        const name:string = module + "." + method
+        if (this._benchmarkEnabled[module]) {
             if (this._benchmarkCount[name] == undefined) {
                 this._benchmarkCount[name] = 0
                 this._benchmarkData[name] = 0
@@ -54,15 +56,57 @@ export class OINOBenchmark {
     /**
      * Complete benchmark timing
      * 
-     * @param name of the benchmark
+     * @param module of the benchmark
+     * @param method of the benchmark
+     * @param category optional subcategory of the benchmark
      */
-    static end(name:string):number {
+    static end(module:string, method:string, category?:string):number {
+        const name:string = module + "." + method
         let result:number = 0
-        if (this._benchmarkEnabled[name]) {
+        if (this._benchmarkEnabled[module]) {
+            const duration = performance.now() - this._benchmarkStart[name]
             this._benchmarkCount[name] += 1
-            this._benchmarkData[name] += performance.now() - this._benchmarkStart[name]
+            this._benchmarkData[name] += duration
+            if (category) {
+                const category_name = name + "." + category
+                if (this._benchmarkCount[category_name] == undefined) {
+                    this._benchmarkCount[category_name] = 0
+                    this._benchmarkData[category_name] = 0
+                }
+                this._benchmarkCount[category_name] += 1
+                this._benchmarkData[category_name] += duration
+            }
             result = this._benchmarkData[name] / this._benchmarkCount[name]
         }
         return result
     }
+
+    /**
+     * Get given benchmark data.
+     * 
+     * @param module of the benchmark
+     * @param method of the benchmark
+     * 
+     */
+    static get(module:string, method:string):number {
+        const name:string = module + "." + method
+        if (this._benchmarkEnabled[module]) {
+            return this._benchmarkData[module] / this._benchmarkCount[module]
+        }
+        return -1
+    }
+
+    /**
+     * Get all benchmark data.
+     * 
+     */
+    static getAll():number {
+        let result:any = {}
+        for (const name in this._benchmarkData) {
+            if (this._benchmarkCount[name] > 0) {
+                result[name] = this._benchmarkData[name] / this._benchmarkCount[name]
+            }
+        }
+        return result
+    }
 }

package/src/OINOHtmlTemplate.ts

@@ -1,4 +1,4 @@
-import { OINOStr, OINOContentType, OINOResult, OINOHttpResult, OINO_ERROR_PREFIX, OINO_WARNING_PREFIX, OINO_INFO_PREFIX, OINO_DEBUG_PREFIX } from "."
+import { OINOStr, OINOContentType, OINOResult, OINOHttpResult, OINO_ERROR_PREFIX, OINO_WARNING_PREFIX, OINO_INFO_PREFIX, OINO_DEBUG_PREFIX, OINOBenchmark } from "."
 
 /**
  * Class for rendering HTML from data. 
@@ -7,6 +7,9 @@ export class OINOHtmlTemplate {
     /** HTML template string */
 	template: string;
 
+    /** Cache modified value for template */
+	modified: number;
+
     /** Cache expiration value for template */
 	expires: number;
 
@@ -14,16 +17,12 @@ export class OINOHtmlTemplate {
      * Creates HTML Response from a key-value-pair.
      *
      * @param template template string
-     * @param expires cache expiration value
      * 
      */
-	constructor (template:string, expires?: number) {
+	constructor (template:string) {
 		this.template = template
-		if (expires) {
-			this.expires = expires
-		} else {
-			this.expires = -1
-		}
+		this.modified = 0
+		this.expires = 0
 	}
 
     /**
@@ -41,8 +40,16 @@ export class OINOHtmlTemplate {
      * 
      */
     renderFromKeyValue(key:string, value:string):OINOHttpResult {
+        OINOBenchmark.start("OINOHtmlTemplate", "renderFromKeyValue")
         const html:string = this.template.replaceAll('###' + key + '###', OINOStr.encode(value, OINOContentType.html))
         const result:OINOHttpResult = new OINOHttpResult(html) 
+		if (this.expires >= 1) {
+			result.expires = Math.round(this.expires)
+		}
+		if (this.modified >= 1) {
+			result.lastModified = this.modified
+		}
+        OINOBenchmark.end("OINOHtmlTemplate", "renderFromKeyValue")
         return result
     }
 
@@ -53,6 +60,7 @@ export class OINOHtmlTemplate {
      * 
      */
     renderFromObject(object:any):OINOHttpResult {
+        OINOBenchmark.start("OINOHtmlTemplate", "renderFromObject")
         let html:string = this.template
         if (object) {
             for (let key in object) {
@@ -65,8 +73,12 @@ export class OINOHtmlTemplate {
         html = html.replace(/###[^#]*###/g, "")
         const result:OINOHttpResult = new OINOHttpResult(html) 
 		if (this.expires >= 1) {
-			result.headers["Expires"] = Math.round(this.expires).toString()
+			result.expires = Math.round(this.expires)
 		}
+		if (this.modified >= 1) {
+			result.lastModified = this.modified
+		}
+        OINOBenchmark.end("OINOHtmlTemplate", "renderFromObject")
         return result
     }
 
@@ -81,6 +93,7 @@ export class OINOHtmlTemplate {
      * 
      */
     renderFromResult(result:OINOResult, includeErrorMessages:boolean=false, includeWarningMessages:boolean=false, includeInfoMessages:boolean=false, includeDebugMessages:boolean=false):OINOHttpResult {
+        OINOBenchmark.start("OINOHtmlTemplate", "renderFromResult")
         let html:string = this.template
         html = html.replaceAll('###statusCode###', OINOStr.encode(result.statusCode.toString(), OINOContentType.html))
         html = html.replaceAll('###statusMessage###', OINOStr.encode(result.statusMessage.toString(), OINOContentType.html))
@@ -105,6 +118,13 @@ export class OINOHtmlTemplate {
         }
         html = html.replace(/###[^#]*###/g, "")
         const http_result:OINOHttpResult = new OINOHttpResult(html) 
+		if (this.expires >= 1) {
+			http_result.expires = Math.round(this.expires)
+		}
+		if (this.modified >= 1) {
+			http_result.lastModified = this.modified
+		}
+        OINOBenchmark.end("OINOHtmlTemplate", "renderFromResult")
         return http_result
     }
 };

package/src/OINOResult.ts

@@ -4,6 +4,7 @@
  * file, You can obtain one at https://mozilla.org/MPL/2.0/.
  */
 
+import { createHash, Hash } from "node:crypto";
 import { OINO_DEBUG_PREFIX, OINO_ERROR_PREFIX, OINO_INFO_PREFIX, OINO_WARNING_PREFIX } from ".";
 
 /**
@@ -162,26 +163,41 @@ export class OINOResult {
  * Specialized result for HTTP responses.
  */
 export class OINOHttpResult extends OINOResult {
+    private _etag:string
+
     /** HTTP body data */
-    body: string
+    readonly body: string
+
+    /** HTTP cache expiration value */
+    expires: number
 
-    /** HTTP header values */
-    headers: Record<string, string>
+    /** HTTP cache last-modified value */
+    lastModified: number
 
     /**
      * Constructor for a `OINOHttpResult` 
      * 
      * @param body HTTP body
-     * @param headers HTTP headers
+     * 
      */
-    constructor(body:string, headers?:Record<string, string>) {
+    constructor(body:string) {
         super()
         this.body = body
-        if (headers) {
-            this.headers = headers
-        } else {
-            this.headers = {}
+        this.expires = 0
+        this.lastModified = 0
+        this._etag = ""
+    }
+
+    /**
+     * Get the ETag value for the body opportunistically, i.e. don't calculate until requested and reuse value.
+     * 
+     */
+    getEtag():string {
+        if (this._etag == "") {
+            const hash:Hash = createHash("sha256")
+            this._etag = hash.update(this.body).digest("hex")
         }
+        return this._etag
     }
 
     /**
@@ -190,11 +206,18 @@ export class OINOHttpResult extends OINOResult {
      * @param headers HTTP headers (overrides existing values)
      */
     getResponse(headers?:Record<string, string>):Response {
-        if (!headers) {
-            headers = this.headers
+        const result:Response = new Response(this.body, {status:this.statusCode, statusText: this.statusMessage, headers: headers})
+        result.headers.set('Content-Length', this.body.length.toString())
+        if (this.lastModified > 0) {
+            result.headers.set('Last-Modified', new Date(this.lastModified).toUTCString())
+        }
+        if (this.expires >= 0) {
+            result.headers.set('Expires', Math.round(this.expires).toString())
+            if (this.expires == 0) {
+                result.headers.set('Pragma', 'no-cache')
+            }
         }
-        headers['Content-Length'] = this.body.length.toString()
-        const result = new Response(this.body, {status:this.statusCode, statusText: this.statusMessage, headers: headers})
+        result.headers.set("ETag", this.getEtag())
         return result
     }
 

package/src/index.ts

@@ -13,7 +13,9 @@ export const OINO_INFO_PREFIX = "OINO INFO"
 /** OINO debug message prefix */
 export const OINO_DEBUG_PREFIX = "OINO DEBUG"
 
-/** Supported content format mime-types */
+/** 
+ * Supported content format mime-types 
+ */
 export enum OINOContentType { 
     /** JSON encoded data */
     json='application/json',